Usa ThunderPhone como servidor MCP

ThunderPhone expone un servidor Model Context Protocol en:

https://api.thunderphone.com/v1/mcp

Configura un cliente MCP para que apunte a ese endpoint HTTP transmisible y así poner los agentes y las llamadas de tu organización a disposición como herramientas. Esta es la dirección opuesta a conectar un servidor MCP remoto a un agente de voz:

Dirección	Resultado
Servidor MCP remoto → agente de ThunderPhone	Tu agente de voz puede llamar las herramientas del servidor remoto.
ThunderPhone → tu cliente MCP	Tu cliente MCP puede llamar las herramientas de ThunderPhone para agentes y llamadas.

Autenticación

Crea una clave sk_live_ en Organización → Claves y envíala como un token Bearer. El endpoint MCP acepta claves de API de organización, no cookies de sesión del dashboard ni claves publicables de widgets.

Generic client configuration

{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}

Una clave sk_live_ puede acceder a datos de la organización y realizar llamadas. No la incluyas en código de navegador, repositorios, capturas de pantalla ni registros de chat. Usa un almacén de secretos compatible con tu cliente MCP y revoca una clave de inmediato si queda expuesta.

Herramientas disponibles

Herramienta	Argumentos	Qué hace
`list_agents`	ninguno	Enumera los agentes de la organización con su id, nombre, producto y voz.
`get_agent`	`agent_id`	Obtiene un agente.
`place_call`	`agent_id`, `from_number`, `to_number`	Realiza una llamada saliente con las mismas validaciones y controles de facturación que el endpoint REST de llamadas.
`get_call`	`call_id`	Obtiene el estado, resumen y calificación de una llamada.
`list_calls`	`limit` opcional (1–100), `status` opcional	Enumera las llamadas recientes.
`get_call_transcript`	`call_id`	Obtiene la transcripción completa de una llamada.

Todas las herramientas están limitadas a la organización vinculada a la clave de API. Un id de otra organización se comporta como no disponible.

Métodos del protocolo

El endpoint implementa los métodos JSON-RPC de MCP necesarios para clientes HTTP transmisibles:

initialize
notifications/initialized
tools/list
tools/call

Puedes inspeccionar directamente el catálogo de herramientas:

curl -X POST https://api.thunderphone.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Llama una herramienta con su nombre y argumentos:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_calls",
    "arguments": { "limit": 20, "status": "completed" }
  }
}

Los resultados de las herramientas son elementos de contenido de texto MCP. Los errores de las herramientas se devuelven en el resultado con isError: true; los métodos JSON-RPC desconocidos devuelven un error de protocolo.

Realizar llamadas de forma segura

place_call sigue las mismas reglas que POST /v1/call: el agente y el número deben pertenecer a la organización de la clave, el número debe ser apto para realizar llamadas salientes, la organización debe tener saldo suficiente y cualquier confirmación aplicable de llamadas salientes debe estar completada. Trata a un cliente con acceso a place_call como un sistema de llamadas en producción. Restringe quién puede usar el cliente, deja claros el agente y el número previstos en su propio prompt, y revisa las llamadas en Historial de llamadas.

Referencia completa de la conexión

Consulta la API de servidores MCP para ver ejemplos de respuestas, errores JSON-RPC y la API de administración de servidores remotos.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

Usa ThunderPhone como servidor MCP

Autenticación

Herramientas disponibles

Métodos del protocolo

Realizar llamadas de forma segura

Referencia completa de la conexión

​Autenticación

​Herramientas disponibles

​Métodos del protocolo

​Realizar llamadas de forma segura

​Referencia completa de la conexión

Autenticación

Herramientas disponibles

Métodos del protocolo

Realizar llamadas de forma segura

Referencia completa de la conexión