Utilizați ThunderPhone ca server MCP

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ție	Rezultat
Server MCP la distanță → agent ThunderPhone	Agentul dumneavoastră vocal poate apela instrumentele serverului la distanță.
ThunderPhone → clientul dumneavoastră MCP	Clientul 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"
      }
    }
  }
}

O cheie sk_live_ poate accesa datele organizației și poate iniția apeluri. Nu o includeți în codul de browser, depozitoare, capturi de ecran și jurnale de chat. Utilizați un depozit de secrete compatibil cu clientul dumneavoastră MCP și revocați imediat o cheie dacă este expusă.

Instrumente disponibile

Instrument	Argumente	Ce face
`list_agents`	niciunul	Listează agenții organizației cu id, nume, produs și voce.
`get_agent`	`agent_id`	Obține un agent.
`place_call`	`agent_id`, `from_number`, `to_number`	Inițiază un apel de ieșire cu aceleași reguli de validare și facturare ca endpointul REST pentru apeluri.
`get_call`	`call_id`	Obține starea, rezumatul și evaluarea apelului.
`list_calls`	`limit` opțional (1–100), `status` opțional	Listează apelurile recente.
`get_call_transcript`	`call_id`	Obț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ță.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

Utilizați ThunderPhone ca server MCP

Autentificare

Instrumente disponibile

Metode de protocol

Inițierea apelurilor în siguranță

Referință completă de comunicație

​Autentificare

​Instrumente disponibile

​Metode de protocol

​Inițierea apelurilor în siguranță

​Referință completă de comunicație

Autentificare

Instrumente disponibile

Metode de protocol

Inițierea apelurilor în siguranță

Referință completă de comunicație