ThunderPhone 2.0 já está no ar.Comece por conta própria, a partir de 2¢/min.Leia o anúncio
Começar

Connect tools & data

Use o ThunderPhone como um servidor MCP

Conecte qualquer cliente MCP HTTP com streaming ao ThunderPhone para listar agentes, inspecionar chamadas e transcrições e fazer chamadas de saída com uma chave de API da organização.

O ThunderPhone expõe um servidor do Model Context Protocol em:

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

Aponte um cliente MCP para esse endpoint HTTP transmitível para disponibilizar os agentes e as chamadas da sua organização como ferramentas. Esta é a direção oposta de conectar um servidor MCP remoto a um agente de voz:

DireçãoResultado
Servidor MCP remoto → agente do ThunderPhoneSeu agente de voz pode chamar as ferramentas do servidor remoto.
ThunderPhone → seu cliente MCPSeu cliente MCP pode chamar as ferramentas do ThunderPhone para agentes e chamadas.

Autenticação

Crie uma chave sk_live_ em Organização → Chaves e envie-a como um token Bearer. O endpoint MCP aceita chaves de API da organização, não cookies de sessão do painel nem chaves publicáveis de widget.

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

Ferramentas disponíveis

FerramentaArgumentosO que faz
list_agentsnenhumLista os agentes da organização com id, nome, produto e voz.
get_agentagent_idRecupera um agente.
place_callagent_id, from_number, to_numberRealiza uma chamada de saída com as mesmas validações e controles de cobrança do endpoint REST de chamadas.
get_callcall_idRecupera o status, o resumo e a avaliação da chamada.
list_callslimit opcional (1–100), status opcionalLista chamadas recentes.
get_call_transcriptcall_idRecupera a transcrição completa de uma chamada.

Todas as ferramentas são restritas à organização vinculada à chave de API. Um id de outra organização é tratado como indisponível.

Métodos do protocolo

O endpoint implementa os métodos MCP JSON-RPC necessários para clientes HTTP transmitíveis:

  • initialize
  • notifications/initialized
  • tools/list
  • tools/call

Você pode inspecionar o catálogo de ferramentas diretamente:

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": {}
  }'

Chame uma ferramenta com seu nome e argumentos:

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

Os resultados das ferramentas são itens de conteúdo de texto MCP. Falhas de ferramentas são retornadas no resultado com isError: true; métodos JSON-RPC desconhecidos retornam um erro de protocolo.

Como realizar chamadas com segurança

place_call segue as mesmas regras de POST /v1/call: o agente e o número devem pertencer à organização da chave, o número deve ser elegível para chamadas de saída, a organização deve ter saldo suficiente e qualquer confirmação aplicável para chamadas de saída deve estar concluída.

Trate um cliente com acesso a place_call como alguém que realiza chamadas em produção. Restrinja quem pode usar o cliente, deixe claros o agente e o número pretendidos no próprio prompt e revise as chamadas no Histórico de chamadas.

Referência completa de integração

Consulte API de servidores MCP para exemplos de resposta, erros JSON-RPC e a API de gerenciamento de servidores remotos.