ThunderPhone 2.0 is live.Direct zelf aan de slag, vanaf 2 cent/min.Lees de aankondiging
Aan de slag

Connect tools & data

Gebruik ThunderPhone als een MCP-server

Verbind elke Streamable HTTP MCP-client met ThunderPhone om agents weer te geven, oproepen en transcripties te bekijken en uitgaande oproepen te plaatsen met een organisatie-API-sleutel.

ThunderPhone biedt een Model Context Protocol-server op:

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

Wijs een MCP-client naar dat Streamable HTTP-eindpunt om de agents en oproepen van je organisatie beschikbaar te maken als tools. Dit is de omgekeerde richting van een externe MCP-server koppelen aan een spraakagent:

RichtingResultaat
Externe MCP-server → ThunderPhone-agentJe spraakagent kan de tools van de externe server aanroepen.
ThunderPhone → je MCP-clientJe MCP-client kan ThunderPhone-tools voor agents en oproepen aanroepen.

Authenticeren

Maak een sk_live_-sleutel onder Organisatie → Sleutels en verstuur deze als Bearer-token. Het MCP-eindpunt accepteert API-sleutels van de organisatie, geen dashboardsessiecookies of publiceerbare widgetsleutels.

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

Beschikbare tools

ToolArgumentenWat deze doet
list_agentsgeenGeeft een lijst van organisatieagents met id, naam, product en stem.
get_agentagent_idHaalt één agent op.
place_callagent_id, from_number, to_numberPlaatst een uitgaande oproep met dezelfde validatie- en factureringscontroles als het REST-oproepeindpunt.
get_callcall_idHaalt de oproepstatus, samenvatting en beoordeling op.
list_callsoptionele limit (1–100), optionele statusGeeft een lijst van recente oproepen.
get_call_transcriptcall_idHaalt het volledige transcript van een oproep op.

Alle tools zijn beperkt tot de organisatie die aan de API-sleutel is gekoppeld. Een id van een andere organisatie gedraagt zich als niet beschikbaar.

Protocolmethoden

Het eindpunt implementeert de MCP JSON-RPC-methoden die nodig zijn voor Streamable HTTP-clients:

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

Je kunt de toolcatalogus rechtstreeks bekijken:

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

Roep een tool aan met de naam en argumenten:

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

Toolresultaten zijn MCP-tekstinhouditems. Toolfouten worden in het resultaat geretourneerd met isError: true; onbekende JSON-RPC-methoden retourneren een protocolfout.

Oproepen veilig plaatsen

place_call volgt dezelfde regels als POST /v1/call: de agent en het nummer moeten toebehoren aan de organisatie van de sleutel, het nummer moet in aanmerking komen voor uitgaand bellen, de organisatie moet voldoende saldo hebben en alle toepasselijke bevestigingen voor uitgaand bellen moeten voltooid zijn.

Behandel een client met toegang tot place_call als een productiesysteem dat oproepen plaatst. Beperk wie de client kan gebruiken, maak de beoogde agent en het nummer duidelijk in de eigen prompt, en controleer oproepen in de Oproepgeschiedenis.

Volledige wire-referentie

Zie MCP Servers API voor antwoordvoorbeelden, JSON-RPC-fouten en de API voor beheer van externe servers.