Available Tools - Octave API

The Octave MCP server exposes your full workspace to connected AI assistants. Tools are grouped below by area. Your assistant discovers the tools available to its workspace once connected. Entitlements, read-only access, and legacy-workspace settings can restrict that set — this page is a reference for what’s available and when each tool is the right one.

Start with verify_connection to confirm which workspace you’re connected to. For open-ended questions about your GTM knowledge, ask_octave (relationship questions across the knowledge graph) and search_knowledge_base (semantic content search) are the best entry points.

Connection

Tool	Description
`verify_connection`	Confirm the connection and identify the authenticated workspace

Knowledge graph

Tool	Description
`ask_octave`	Answer relationship questions across the knowledge graph (e.g. “which use cases address this persona’s pains”)
`search_knowledge_base`	Semantic search across all Library content

Library

Tool	Description
`list_entities`	List Library entities of a given type
`get_entity_schema` / `list_additional_properties`	Inspect writable fields and workspace-defined additional properties
`get_entity`	Get a single entity by oId
`create_entity`	Create a Library entity
`update_entity`	Update a Library entity
`delete_entity`	Delete a Library entity
`revise_entity`	Replace a prior suggestion with modified content; `autoAccept` defaults to true
`get_revision` / `list_revisions`	Read the change history of Library entities
`link_entities_to_offering`	Link entities (personas, use cases, …) to an offering
`add_value_props` / `list_value_props` / `update_value_props`	Manage legacy Playbook value propositions where enabled
`create_tag_group` / `add_tag_to_group` / `list_tag_groups` / `assign_entity_tag`	Organize entities with tag groups
`update_tag_group` / `delete_tag_group` / `backfill_tag_group`	Update groups, remove them, and infer missing assignments
`update_tag` / `delete_tag` / `remove_entity_tag`	Manage tag values and clear assignments
`list_tag_group_assignments`	List entities and their assigned values
`get_tag_group_performance`	Outcome metrics per tag group
`list_writing_styles`	List available Brand Voice / writing-style profiles

Motions

Tool	Description
`create_motion` / `get_motion` / `list_motions` / `update_motion` / `delete_motion`	Manage Motions
`create_motion_playbook` / `get_motion_playbook` / `list_motion_playbooks` / `update_motion_playbook` / `delete_motion_playbook`	Manage Motion Playbooks
`list_motion_icps`	List a motion’s ICP cells
`regenerate_motion_icp`	Refresh an ICP cell from its current inputs
`find_motion_icp`	Find the ICP cell matching a persona × segment combination

Skills

Managed Agent Skills — reusable methods your assistants load on demand.

Tool	Description
`find_skill`	Find the skill matching a task description
`list_skills`	List the workspace’s skills
`get_skill`	Load a skill’s SKILL.md instructions
`get_skill_file`	Read one bundled file of a skill
`create_skill` / `update_skill` / `delete_skill`	Manage skills
`list_skill_catalog` / `install_catalog_skill`	Browse and install catalog skills
`get_skill_update_status` / `manage_skill_release`	Inspect and act on skill releases
`skill_run` / `skill_run_status`	Execute one skill and inspect execution
`run_start` / `run_status` / `run_cancel`	Run a skill for one or many items, inspect outputs, and cancel unstarted work

Assets

Hosted Assets — published sites, documents, and file bundles.

Tool	Description
`create_asset`	Create and upload an asset through MCP
`asset_transfer`	Transfer asset ownership
`assets_list` / `asset_get_by_id`	Discover and inspect assets
`asset_update`	Update identifier, description, privacy, status, or vanity slug
`asset_delete`	Permanently delete an asset
`asset_stats_get` / `asset_visitors_list`	Per-day visit counts and identified viewers (owner-only)
`asset_share_create` / `asset_shares_list` / `asset_share_revoke`	Create, list, and revoke email-verified share links
`asset_share_add_recipients` / `asset_share_remove_recipients`	Manage a share link’s allowed emails
`asset_share_add_domains` / `asset_share_remove_domains`	Manage a share link’s allowed domains
`asset_versions_list` / `asset_version_restore` / `asset_version_delete`	Version history, rollback, and snapshot cleanup
`asset_access_requests_list` / `asset_access_request_grant` / `asset_access_request_dismiss`	Review and decide viewer access requests
`asset_generate_access_token` / `asset_refresh_access_token`	Mint or rotate the per-user token used to upload asset files

Sources

Tool	Description
`create_resource` / `get_resource` / `list_resources` / `delete_resource`	Manage knowledge-base Sources
`search_resources`	Semantic search across resource content
`check_resource_drift`	Detect where a resource has drifted from the Library
`link_entities_to_resource`	Link Library entities to a resource

Research & enrichment

Tool	Description
`find_person` / `find_company`	Look up a person or company across data providers
`find_similar_people` / `find_similar_companies`	Lookalike discovery
`enrich_person` / `enrich_company`	Full enrichment profiles
`qualify_person` / `qualify_company`	Score a prospect against your qualification criteria
`resolve_email_from_profile` / `resolve_profile_from_email`	LinkedIn profile ↔ email resolution
`find_external_context`	Gather external context on a target from the live web
`deep_web_research`	Multi-step web research on a topic or account
`scrape_website`	Fetch and parse a specific page
`get_external_brand_assets` / `get_external_brand_logo`	Fetch a company’s public brand assets

Content generation

Tool	Description
`generate_email`	Generate a personalized outbound email
`generate_content`	Generate content (posts, landing pages, one-pagers, …)
`generate_call_prep`	Generate a call-prep brief for a meeting

Agents

Tool	Description
`list_agents` / `get_agent` / `create_agent` / `update_agent` / `delete_agent`	Manage saved Agents
`run_email_agent` / `run_content_agent` / `run_call_prep_agent`	Run generation agents
`run_enrich_person_agent` / `run_enrich_company_agent`	Run enrichment agents
`run_qualify_person_agent` / `run_qualify_company_agent`	Run qualification agents

CRM

Tool	Description
`find_crm_records` / `find_crm_activities`	Query records and activities from your connected CRM
`generate_crm_context`	Summarize CRM context for an account or deal
`get_crm_entity_schema`	Introspect your CRM’s field schema

Pipeline & deals

Tool	Description
`list_deals`	Paged list of synced deals with filters and sorting; `stalledOnly` returns only at-risk and stalled deals, `includeRisk` / `includePulse` add health per row
`get_deal`	One deal by Octave ID or CRM ID, with opt-in activity, stakeholders, risk, Deal Pulse and stage-history sections
`get_deal_strategy_evidence`	Read Library evidence within a deal’s events
`deal_pulse_list` / `deal_pulse_get`	Inspect watched opportunities and their current Deal Pulse outputs
`deal_pulse_recompute` / `deal_pulse_win_loss_cohort`	Refresh a watched opportunity or read a win/loss cohort
`get_pipeline_metrics`	Stage velocity, cycle time, conversion rates, and open deals per stage

Analytics & learning

Tool	Description
`list_events` / `get_event_detail`	The processed interaction timeline (analytics)
`count_events` / `get_event_time_series`	Count matching events and track counts over time
`top_event_entities` / `get_event_cross_tab`	Rank or cross-tabulate event dimensions
`compare_cohorts` / `list_cohort_deals`	Compare deal cohorts and inspect their members
`explore_research` / `explore_investigate`	Research analytics questions and investigate evidence
`get_insight`	Read one insight
`get_insights_summary` / `get_entity_performance` / `get_top_performing_entities`	Read workspace metrics and entity performance
`get_competitive_insights`	Read competitive outcome metrics
`get_library_backfill_status` / `list_unmatched_findings`	Inspect rematching progress and coverage gaps
`list_intel` / `get_intel`	Read market, competitor, and segment intelligence
`list_report_runs` / `get_report_section_evidence`	Browse report history and supporting findings
`list_findings`	Structured signals extracted from interactions
`search_call_transcripts`	Semantic search across call transcripts
`get_entity_evidence`	Transcript evidence backing a Library entity
`create_suggestion` / `get_suggestion` / `list_suggestions` / `update_suggestion`	Manage Library Suggestions
`accept_suggestion` / `reject_suggestion`	Decide pending suggestions
`list_gtm_reports` / `get_latest_gtm_report` / `get_report_run`	Read scheduled GTM reports

Custom Extractors

These tools require the custom-extractors entitlement.

Tool	Description
`list_custom_extractors` / `create_custom_extractor` / `update_custom_extractor` / `delete_custom_extractor`	Manage workspace extraction definitions
`backtest_custom_extractor`	Test extraction without saving findings
`custom_extractor_backfill_estimate` / `custom_extractor_backfill_start`	Estimate and start historical extraction
`custom_extractor_backfill_list` / `custom_extractor_backfill_get` / `custom_extractor_backfill_events`	Inspect jobs and their events
`custom_extractor_backfill_control` / `purge_custom_extractor_findings`	Control a job or retire an extractor’s findings

Prioritized ABM (Labs)

Availability depends on workspace access to Prioritized ABM.

Tool	Description
`abm_get_skill` / `abm_validate_skill` / `abm_create_skill`	Inspect, validate, and create the ABM scoring skill
`abm_update_settings`	Update ABM settings
`add_abm_accounts` / `get_abm_outputs`	Add target accounts and read the resulting output

Workspace

Tool	Description
`get_workspace_company` / `update_workspace_company` / `generate_workspace_company`	Manage your own company’s profile

Legacy

The flat Playbook tools (create_playbook, get_playbook, list_playbooks, update_playbook, delete_playbook) are exposed only where legacy Playbooks are enabled and are deprecated — Motions replaced Playbooks as the strategy model.

​Connection

​Knowledge graph

​Library

​Motions

​Skills

​Assets

​Sources

​Research & enrichment

​Content generation

​Agents

​CRM

​Pipeline & deals

​Analytics & learning

​Custom Extractors

​Prioritized ABM (Labs)

​Workspace

​Legacy

Connection

Knowledge graph

Library

Motions

Skills

Assets

Sources

Research & enrichment

Content generation

Agents

CRM

Pipeline & deals

Analytics & learning

Custom Extractors

Prioritized ABM (Labs)

Workspace

Legacy