Connect tools & data

Usa ThunderPhone como servidor MCP

Conecta cualquier cliente MCP de HTTP transmitible a ThunderPhone para listar agentes, inspeccionar llamadas y transcripciones, y realizar llamadas salientes con una clave de API de organización.

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:

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.

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

Herramientas disponibles#

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.