Vapi MCP Server

Official

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows the MCP server to be installed and run via NPX, making it easy to integrate Vapi's capabilities through the NPM package ecosystem.

Servidor MCP de Vapi

El servidor del Protocolo de Contexto del Modelo Vapi le permite integrarse con las API de Vapi a través de llamadas de funciones.

Configuración del escritorio de Claude

  1. Abra Claude Desktop y presione CMD + , para ir a Settings .
  2. Haga clic en la pestaña Developer .
  3. Haga clic en el botón Edit Config .
  4. Esto abrirá el archivo claude_desktop_config.json en su explorador de archivos.
  5. Obtén tu clave API de Vapi desde el panel de Vapi ( https://dashboard.vapi.ai/org/api-keys ).
  6. Añade lo siguiente a tu archivo claude_desktop_config.json . Consulta aquí para más detalles.
  7. Reinicie Claude Desktop después de editar el archivo de configuración.
{ "mcpServers": { "vapi-mcp-server": { "command": "npx", "args": [ "-y", "@vapi-ai/mcp-server" ], "env": { "VAPI_TOKEN": "<your_vapi_token>" } } } }

Ejemplo de uso con Claude Desktop

  1. Cree o importe un número de teléfono utilizando el panel de Vapi ( https://dashboard.vapi.ai/phone-numbers ).
  2. Cree un nuevo asistente utilizando la plantilla 'Programador de citas' existente en el panel de Vapi ( https://dashboard.vapi.ai/assistants ).
  3. Asegúrese de configurar Claude Desktop para usar el servidor Vapi MCP y reiniciar la aplicación Claude Desktop.
  4. Pídele a Claude que inicie o programe una llamada. Mira los ejemplos a continuación:

Ejemplo 1: Solicitar una llamada inmediata

I'd like to speak with my ShopHelper assistant to talk about my recent order. Can you have it call me at +1234567890?

Ejemplo 2: Programar una llamada futura

I need to schedule a call with Mary assistant for next Tuesday at 3:00 PM. My phone number is +1555123456.

Conexión SSE remota

Para conectarse al servidor MCP de Vapi a través del transporte de eventos enviados por el servidor (SSE):

  • Conéctese a https://mcp.vapi.ai/sse desde cualquier cliente MCP usando SSE Transport
  • Incluya su clave API de Vapi como un token portador en los encabezados de solicitud
  • Ejemplo de encabezado: Authorization: Bearer your_vapi_api_key_here

Esta conexión le permite acceder a la funcionalidad de Vapi de forma remota sin ejecutar un servidor local.

Desarrollo

# Install dependencies npm install # Build the server npm run build

Actualice su claude_desktop_config.json para usar el servidor local.

{ "mcpServers": { "vapi-local": { "command": "node", "args": [ "<path_to_vapi_mcp_server>/dist/index.js" ], "env": { "VAPI_TOKEN": "<your_vapi_token>" } }, } }

Pruebas

El proyecto tiene dos tipos de pruebas:

Pruebas unitarias

Las pruebas unitarias utilizan simulacros para probar el servidor MCP sin realizar llamadas API reales a Vapi.

# Run unit tests npm run test:unit

Pruebas de extremo a extremo

Las pruebas E2E ejecutan el servidor MCP completo con llamadas API reales a Vapi.

# Set your Vapi API token export VAPI_TOKEN=your_token_here # Run E2E tests npm run test:e2e

Nota: Las pruebas E2E requieren que se configure un token de API Vapi válido en el entorno.

Ejecutando todas las pruebas

Para ejecutar todas las pruebas a la vez:

npm test

Referencias

Acciones admitidas

El servidor Vapi MCP proporciona las siguientes herramientas para la integración:

Herramientas del asistente

  • list_assistants : enumera todos los asistentes de Vapi
  • create_assistant : Crea un nuevo asistente Vapi
  • get_assistant : Obtiene un asistente Vapi por ID

Herramientas de llamada

  • list_calls : enumera todas las llamadas de Vapi
  • create_call : Crea una llamada saliente
  • get_call : obtiene detalles de una llamada específica

Nota: La acción create_call permite programar llamadas para su ejecución inmediata o para un momento futuro.

Herramientas para números de teléfono

  • list_phone_numbers : enumera todos los números de teléfono de Vapi
  • get_phone_number : Obtiene detalles de un número de teléfono específico

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Permite la integración con las API de Vapi a través de la llamada de funciones mediante el Protocolo de contexto de modelo, lo que permite que los modelos de IA accedan a las capacidades de Vapi.

  1. Claude Desktop Setup
    1. Example Usage with Claude Desktop
  2. Remote SSE Connection
    1. Development
      1. Testing
    2. References
      1. Supported Actions
        1. Assistant Tools
        2. Call Tools
        3. Phone Number Tools
      ID: 36gq6pif6r