Connect tools & data

Använd ThunderPhone som en MCP-server

Anslut valfri Streamable HTTP MCP-klient till ThunderPhone för att lista agenter, granska samtal och transkriptioner samt ringa utgående samtal med en organisations-API-nyckel.

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:

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.

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

Tillgängliga verktyg#

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.