Skip to main content
The vapi MCP adapter connects to the Vapi API. Discover voice assistants configured in your Vapi account and retrieve full assistant configurations — useful for auditing prompts, syncing assistant metadata into internal docs, and orchestrating voice workflows alongside other connectors.

​
Prerequisites

  • A Vapi account with at least one configured assistant
  • A Vapi private API key (Bearer token)
  • project_contributor access in AgentRuntime

​
Connect in AgentRuntime

1

Get a Vapi API key

Sign in to the Vapi dashboard and copy your private API key from settings.
2

Create a connection

Go to Connections and click New custom connection to create an API key connection with APIKey.
3

Add vapi MCP instance

Go to MCP, click Add instance for vapi, wire your connection on Instance config, set the profile active, and save.
4

List assistants

Run mcp_call → list_assistants to confirm the key and see assistant IDs.
See Authentication for binding connections to MCP instances.
This adapter currently exposes read-only assistant discovery tools. Outbound call creation and live call control are configured in Vapi directly or via future adapter tools.

​
What you can build

  • Assistant inventory — Scheduled list_assistants → diff against expected list → alert on drift.
  • Config documentation — get_assistant → LLM summarizes model, voice, and tool settings → save to Notion.
  • Pre-call validation — Before a campaign, verify assistant ID and prompt version match release notes.
  • Cross-system sync — Export raw_json to internal config store for compliance review.

​
Tools

ToolDescription
list_assistantsList voice assistants visible to the API key
get_assistantFull assistant configuration by ID (includes pretty-printed JSON)

​
Example

Fetch assistant configuration for audit logging: 
{
  "id": "vapi-audit",
  "type": "mcp_call",
  "name": "Get Vapi assistant config",
  "tool_name": "get_assistant",
  "tool_args": {
    "assistant_id": "{{input.assistant_id}}"
  },
  "timeout_s": 30
}

​
Configuration

KeyRequiredDescription
APIKeyYesVapi private API key (Bearer token)
APIBaseNoVapi API base URL

​
Troubleshooting

IssueFix
401 UnauthorizedVerify private key, not a publishable or webhook-only key
Assistant not in listKey may be scoped to a different Vapi org or project
Empty raw_jsonCheck HTTP status in tool output; assistant ID may be invalid
Timeout on getLarge assistant configs with many tools may need higher timeout_s