Gebruik ThunderPhone als een MCP-server

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:

Richting	Resultaat
Externe MCP-server → ThunderPhone-agent	Je spraakagent kan de tools van de externe server aanroepen.
ThunderPhone → je MCP-client	Je 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"
      }
    }
  }
}

Een sk_live_-sleutel heeft toegang tot organisatiegegevens en kan oproepen plaatsen. Houd deze buiten browsercode, repositories, schermafbeeldingen en chatlogboeken. Gebruik een geheimenopslag die door je MCP-client wordt ondersteund en trek een sleutel onmiddellijk in als deze is blootgesteld.

Beschikbare tools

Tool	Argumenten	Wat deze doet
`list_agents`	geen	Geeft een lijst van organisatieagents met id, naam, product en stem.
`get_agent`	`agent_id`	Haalt één agent op.
`place_call`	`agent_id`, `from_number`, `to_number`	Plaatst een uitgaande oproep met dezelfde validatie- en factureringscontroles als het REST-oproepeindpunt.
`get_call`	`call_id`	Haalt de oproepstatus, samenvatting en beoordeling op.
`list_calls`	optionele `limit` (1–100), optionele `status`	Geeft een lijst van recente oproepen.
`get_call_transcript`	`call_id`	Haalt 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.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

Gebruik ThunderPhone als een MCP-server

Authenticeren

Beschikbare tools

Protocolmethoden

Oproepen veilig plaatsen

Volledige wire-referentie

​Authenticeren

​Beschikbare tools

​Protocolmethoden

​Oproepen veilig plaatsen

​Volledige wire-referentie

Authenticeren

Beschikbare tools

Protocolmethoden

Oproepen veilig plaatsen

Volledige wire-referentie