> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

```text theme={null}
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](/es/guides/mcp-servers):

| 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.

```json Generic client configuration theme={null}
{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}
```

<Warning>
  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.
</Warning>

## 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:

```bash theme={null}
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:

```json theme={null}
{
  "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`](/api-reference/outbound-calls): 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](/api-reference/mcp-servers#thunderphone-as-an-mcp-server)
para ver ejemplos de respuestas, errores JSON-RPC y la API de administración de servidores remotos.