Använd ThunderPhone som en MCP-server

ThunderPhone exponerar en Model Context Protocol-server på:

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

Peka en MCP-klient mot den Streamable HTTP-slutpunkten för att göra din organisations agenter och samtal tillgängliga som verktyg. Detta är motsatt riktning jämfört med att ansluta en fjärransluten MCP-server till en röstagent:

Riktning	Resultat
Fjärransluten MCP-server → ThunderPhone-agent	Din röstagent kan anropa den fjärranslutna serverns verktyg.
ThunderPhone → din MCP-klient	Din MCP-klient kan anropa ThunderPhone-verktyg för agenter och samtal.

Autentisera

Skapa en sk_live_-nyckel under Organisation → Nycklar och skicka den som en Bearer-token. MCP-slutpunkten accepterar organisationens API-nycklar, inte dashboardens sessionskakor eller publicerbara widgetnycklar.

Generic client configuration

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

En sk_live_-nyckel kan komma åt organisationsdata och ringa samtal. Håll den borta från webbläsarkod, repositorier, skärmbilder och chattloggar. Använd en hemlighetslagring som stöds av din MCP-klient och återkalla en nyckel omedelbart om den exponeras.

Tillgängliga verktyg

Verktyg	Argument	Vad det gör
`list_agents`	inga	Listar organisationens agenter med id, namn, produkt och röst.
`get_agent`	`agent_id`	Hämtar en agent.
`place_call`	`agent_id`, `from_number`, `to_number`	Ringer ett utgående samtal med samma validerings- och faktureringskontroller som REST-slutpunkten för samtal.
`get_call`	`call_id`	Hämtar samtalsstatus, sammanfattning och betyg.
`list_calls`	valfritt `limit` (1–100), valfritt `status`	Listar senaste samtalen.
`get_call_transcript`	`call_id`	Hämtar det fullständiga transkriptet för ett samtal.

Alla verktyg är begränsade till organisationen som är kopplad till API-nyckeln. Ett id från en annan organisation behandlas som otillgängligt.

Protokollmetoder

Slutpunkten implementerar MCP JSON-RPC-metoderna som behövs för Streamable HTTP- klienter:

initialize
notifications/initialized
tools/list
tools/call

Du kan granska verktygskatalogen direkt:

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

Anropa ett verktyg med dess namn och argument:

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

Verktygsresultat är MCP-innehållsobjekt av typen text. Verktygsfel returneras i resultatet med isError: true; okända JSON-RPC-metoder returnerar ett protokollfel.

Ring samtal säkert

place_call följer samma regler som POST /v1/call: agenten och numret måste tillhöra nyckelns organisation, numret måste vara kvalificerat för utgående samtal, organisationen måste ha tillräckligt saldo och eventuell tillämplig bekräftelse för utgående samtal måste vara slutförd. Behandla en klient med åtkomst till place_call som en produktionsklient för samtal. Begränsa vem som kan använda klienten, ange tydligt avsedd agent och nummer i klientens egen prompt och granska samtal i Samtalshistorik.

Fullständig wire-referens

Se MCP Servers API för svarsexempel, JSON-RPC-fel och API:t för hantering av fjärrservrar.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

Använd ThunderPhone som en MCP-server

Autentisera

Tillgängliga verktyg

Protokollmetoder

Ring samtal säkert

Fullständig wire-referens

​Autentisera

​Tillgängliga verktyg

​Protokollmetoder

​Ring samtal säkert

​Fullständig wire-referens

Autentisera

Tillgängliga verktyg

Protokollmetoder

Ring samtal säkert

Fullständig wire-referens