The Vapi MCP Server enables integration with Vapi APIs through the Model Context Protocol for managing:
- Assistants: List, create, update, and retrieve assistants with customizable LLM, voice, transcriber, and first message configurations.
- Calls: List, create, and retrieve calls, including scheduling outbound calls for immediate or future execution.
- Phone Numbers: List and retrieve Vapi phone numbers.
- Tools: List and retrieve Vapi tools.
- Remote Connectivity: Connect to the server remotely using Server-Sent Events (SSE) for seamless integration.
- Development & Testing: Supports local development with unit and end-to-end tests.
Allows the MCP server to be installed and run via NPX, making it easy to integrate Vapi's capabilities through the NPM package ecosystem.
Vapi MCP Server
The Vapi Model Context Protocol server allows you to integrate with Vapi APIs through function calling.
Claude Desktop Setup
- Open
Claude Desktop
and pressCMD + ,
to go toSettings
. - Click on the
Developer
tab. - Click on the
Edit Config
button. - This will open the
claude_desktop_config.json
file in your file explorer. - Get your Vapi API key from the Vapi dashboard (https://dashboard.vapi.ai/org/api-keys).
- Add the following to your
claude_desktop_config.json
file. See here for more details. - Restart the Claude Desktop after editing the config file.
Example Usage with Claude Desktop
- Create or import a phone number using the Vapi dashboard (https://dashboard.vapi.ai/phone-numbers).
- Create a new assistant using the existing 'Appointment Scheduler' template in the Vapi dashboard (https://dashboard.vapi.ai/assistants).
- Make sure to configure Claude Desktop to use the Vapi MCP server and restart the Claude Desktop app.
- Ask Claude to initiate or schedule a call. See examples below:
Example 1: Request an immediate call
Example 2: Schedule a future call
Remote SSE Connection
To connect to Vapi's MCP server via Server-Sent Events (SSE) Transport:
- Connect to
https://mcp.vapi.ai/sse
from any MCP client using SSE Transport - Include your Vapi API key as a bearer token in the request headers
- Example header:
Authorization: Bearer your_vapi_api_key_here
This connection allows you to access Vapi's functionality remotely without running a local server.
Development
Update your claude_desktop_config.json
to use the local server.
Testing
The project has two types of tests:
Unit Tests
Unit tests use mocks to test the MCP server without making actual API calls to Vapi.
End-to-End Tests
E2E tests run the full MCP server with actual API calls to Vapi.
Note: E2E tests require a valid Vapi API token to be set in the environment.
Running All Tests
To run all tests at once:
References
Supported Actions
The Vapi MCP Server provides the following tools for integration:
Assistant Tools
list_assistants
: Lists all Vapi assistantscreate_assistant
: Creates a new Vapi assistantupdate_assistant
: Updates an existing Vapi assistantget_assistant
: Gets a Vapi assistant by ID
Call Tools
list_calls
: Lists all Vapi callscreate_call
: Creates an outbound callget_call
: Gets details of a specific call
Note: The
create_call
action supports scheduling calls for immediate execution or for a future time.
Phone Number Tools
list_phone_numbers
: Lists all Vapi phone numbersget_phone_number
: Gets details of a specific phone number
Vapi Tools
list_tools
: Lists all Vapi toolsget_tool
: Gets details of a specific tool
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables integration with Vapi APIs through function calling via the Model Context Protocol, allowing AI models to access Vapi's capabilities.
Related MCP Servers
- -securityFlicense-qualityFacilitates interaction and context sharing between AI models using the standardized Model Context Protocol (MCP) with features like interoperability, scalability, security, and flexibility across diverse AI systems.Last updated -1Python
- -securityFlicense-qualityImplements the Model Context Protocol (MCP) to provide AI models with a standardized interface for connecting to external data sources and tools like file systems, databases, or APIs.Last updated -90Python
- -securityFlicense-qualityA FastAPI-based implementation of the Model Context Protocol that enables standardized interaction between AI models and development environments, making it easier for developers to integrate and manage AI tasks.Last updated -5PythonMIT License
- -securityFlicense-qualityEnables seamless integration with Typecast API through the Model Context Protocol, allowing clients to manage voices, convert text to speech, and play audio in a standardized way.Last updated -1Python