ThunderPhone 2.0 este acum disponibil.Îl configurați singur, de la 2 ¢/min.Citiți anunțul
Începeți acum

Connect tools & data

Utilizați ThunderPhone ca server MCP

Conectați orice client MCP Streamable HTTP la ThunderPhone pentru a lista agenții, a inspecta apelurile și transcrierile și a iniția apeluri outbound cu o cheie API a organizației.

ThunderPhone expune un server Model Context Protocol la:

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

Direcționați un client MCP către acel endpoint HTTP transmisibil pentru a pune la dispoziție ca instrumente agenții și apelurile organizației dumneavoastră. Aceasta este direcția opusă față de conectarea unui server MCP la distanță la un agent vocal:

DirecțieRezultat
Server MCP la distanță → agent ThunderPhoneAgentul dumneavoastră vocal poate apela instrumentele serverului la distanță.
ThunderPhone → clientul dumneavoastră MCPClientul dumneavoastră MCP poate apela instrumentele ThunderPhone pentru agenți și apeluri.

Autentificare

Creați o cheie sk_live_ în Organizație → Chei și trimiteți-o ca token Bearer. Endpointul MCP acceptă chei API ale organizației, nu cookie-uri de sesiune din tabloul de bord sau chei publicabile pentru widgeturi.

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

Instrumente disponibile

InstrumentArgumenteCe face
list_agentsniciunulListează agenții organizației cu id, nume, produs și voce.
get_agentagent_idObține un agent.
place_callagent_id, from_number, to_numberInițiază un apel de ieșire cu aceleași reguli de validare și facturare ca endpointul REST pentru apeluri.
get_callcall_idObține starea, rezumatul și evaluarea apelului.
list_callslimit opțional (1–100), status opționalListează apelurile recente.
get_call_transcriptcall_idObține transcrierea completă a unui apel.

Toate instrumentele sunt limitate la organizația asociată cheii API. Un id dintr-o altă organizație se comportă ca indisponibil.

Metode de protocol

Endpointul implementează metodele MCP JSON-RPC necesare pentru clienții HTTP transmisibili:

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

Puteți inspecta direct catalogul de instrumente:

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

Apelați un instrument cu numele și argumentele sale:

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

Rezultatele instrumentelor sunt elemente MCP de conținut text. Eșecurile instrumentelor sunt returnate în rezultat cu isError: true; metodele JSON-RPC necunoscute returnează o eroare de protocol.

Inițierea apelurilor în siguranță

place_call urmează aceleași reguli ca POST /v1/call: agentul și numărul trebuie să aparțină organizației cheii, numărul trebuie să fie eligibil pentru apeluri de ieșire, organizația trebuie să aibă sold suficient, iar orice confirmare aplicabilă pentru apelurile de ieșire trebuie să fie finalizată.

Tratați un client cu acces la place_call ca pe un inițiator de apeluri în producție. Restricționați cine poate utiliza clientul, precizați clar agentul și numărul intenționate în propriul prompt al clientului și verificați apelurile în Istoricul apelurilor.

Referință completă de comunicație

Consultați API-ul serverelor MCP pentru exemple de răspunsuri, erori JSON-RPC și API-ul de gestionare a serverelor la distanță.