ThunderPhone 2.0 ist live.Direkt im Self-Service – ab 2 ¢/Min..Ankündigung lesen
Jetzt starten

Connect tools & data

ThunderPhone als MCP-Server verwenden

Verbinden Sie einen beliebigen Streamable-HTTP-MCP-Client mit ThunderPhone, um Agenten aufzulisten, Anrufe und Transkripte zu prüfen und mit einem Organisations-API-Schlüssel ausgehende Anrufe zu tätigen.

ThunderPhone stellt einen Model Context Protocol-Server bereit unter:

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

Konfigurieren Sie einen MCP-Client für diesen Streamable-HTTP-Endpunkt, um die Agenten und Anrufe Ihrer Organisation als Tools verfügbar zu machen. Dies ist die entgegengesetzte Richtung zu einem Sprachagenten mit einem Remote-MCP-Server verbinden:

RichtungErgebnis
Remote-MCP-Server → ThunderPhone-AgentIhr Sprachagent kann die Tools des Remote-Servers aufrufen.
ThunderPhone → Ihr MCP-ClientIhr MCP-Client kann ThunderPhone-Tools für Agenten und Anrufe aufrufen.

Authentifizieren

Erstellen Sie unter Organisation → Schlüssel einen sk_live_-Schlüssel und senden Sie ihn als Bearer-Token. Der MCP-Endpunkt akzeptiert API-Schlüssel für Organisationen, keine Dashboard-Sitzungscookies oder veröffentlichbaren Widget-Schlüssel.

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

Verfügbare Tools

ToolArgumenteFunktion
list_agentskeineListet Agenten der Organisation mit ID, Name, Produkt und Stimme auf.
get_agentagent_idRuft einen Agenten ab.
place_callagent_id, from_number, to_numberTätigt einen ausgehenden Anruf mit denselben Validierungs- und Abrechnungsprüfungen wie der REST-Anrufendpunkt.
get_callcall_idRuft Anrufstatus, Zusammenfassung und Bewertung ab.
list_callsoptional limit (1–100), optional statusListet aktuelle Anrufe auf.
get_call_transcriptcall_idRuft das vollständige Transkript eines Anrufs ab.

Alle Tools sind auf die mit dem API-Schlüssel verknüpfte Organisation beschränkt. Eine ID aus einer anderen Organisation verhält sich wie nicht verfügbar.

Protokollmethoden

Der Endpunkt implementiert die MCP-JSON-RPC-Methoden, die für Streamable-HTTP- Clients erforderlich sind:

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

Sie können den Toolkatalog direkt prüfen:

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

Rufen Sie ein Tool mit seinem Namen und seinen Argumenten auf:

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

Tool-Ergebnisse sind MCP-Textinhaltselemente. Tool-Fehler werden im Ergebnis mit isError: true zurückgegeben; unbekannte JSON-RPC-Methoden geben einen Protokollfehler zurück.

Anrufe sicher tätigen

place_call folgt denselben Regeln wie POST /v1/call: Der Agent und die Nummer müssen zur Organisation des Schlüssels gehören, die Nummer muss für ausgehende Anrufe geeignet sein, die Organisation muss über ausreichendes Guthaben verfügen und jede zutreffende Bestätigung für ausgehende Anrufe muss abgeschlossen sein.

Behandeln Sie einen Client mit Zugriff auf place_call wie einen produktiven Anrufer. Beschränken Sie, wer den Client verwenden kann, machen Sie den vorgesehenen Agenten und die Nummer in seinem eigenen Prompt deutlich und prüfen Sie Anrufe im Anrufverlauf.

Vollständige Wire-Referenz

Unter MCP Servers API finden Sie Antwortbeispiele, JSON-RPC-Fehler und die API zur Verwaltung von Remote-Servern.