ThunderPhone 2.0 er lansert.Kom i gang selv, fra 2 ¢/min.Les mer om lanseringen
Kom i gang

Connect tools & data

Bruk ThunderPhone som en MCP-server

Koble en hvilken som helst Streamable HTTP MCP-klient til ThunderPhone for å liste opp agenter, undersøke samtaler og transkripsjoner og foreta utgående samtaler med en organisasjons-API-nøkkel.

ThunderPhone eksponerer en Model Context Protocol-server på:

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

Pek en MCP-klient mot dette Streamable HTTP-endepunktet for å gjøre organisasjonens stemmeagenter og anrop tilgjengelige som verktøy. Dette går i motsatt retning av å koble en ekstern MCP-server til en stemmeagent:

RetningResultat
Ekstern MCP-server → ThunderPhone-agentStemmeagenten din kan kalle verktøyene på den eksterne serveren.
ThunderPhone → MCP-klienten dinMCP-klienten din kan kalle ThunderPhone-verktøy for stemmeagenter og anrop.

Autentiser

Opprett en sk_live_-nøkkel under Organisasjon → Nøkler, og send den som et Bearer-token. MCP-endepunktet godtar organisasjons-API-nøkler, ikke øktinformasjonskapsler for dashboardet eller publiserbare widget-nøkler.

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

Tilgjengelige verktøy

VerktøyArgumenterHva det gjør
list_agentsingenViser organisasjonens stemmeagenter med id, navn, produkt og stemme.
get_agentagent_idHenter én stemmeagent.
place_callagent_id, from_number, to_numberForetar et utgående anrop med samme validerings- og faktureringskontroller som REST-anropsendepunktet.
get_callcall_idHenter anropsstatus, sammendrag og vurdering.
list_callsvalgfri limit (1–100), valgfri statusViser nylige anrop.
get_call_transcriptcall_idHenter hele transkripsjonen for et anrop.

Alle verktøy er avgrenset til organisasjonen som er knyttet til API-nøkkelen. En id fra en annen organisasjon behandles som utilgjengelig.

Protokollmetoder

Endepunktet implementerer MCP JSON-RPC-metodene som kreves for Streamable HTTP- klienter:

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

Du kan undersøke verktøykatalogen direkte:

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

Kall et verktøy med navnet og argumentene:

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

Verktøyresultater er MCP-tekstinnholdselementer. Verktøyfeil returneres i resultatet med isError: true; ukjente JSON-RPC-metoder returnerer en protokollfeil.

Foreta anrop på en trygg måte

place_call følger de samme reglene som POST /v1/call: stemmeagenten og nummeret må tilhøre organisasjonen til nøkkelen, nummeret må være kvalifisert for utgående anrop, organisasjonen må ha tilstrekkelig saldo, og eventuell påkrevd bekreftelse for utgående anrop må være fullført.

Behandle en klient med tilgang til place_call som en produksjonsoppringer. Begrens hvem som kan bruke klienten, gjør den tiltenkte stemmeagenten og nummeret tydelig i klientens egen ledetekst, og gjennomgå anrop i Anropshistorikk.

Fullstendig wire-referanse

Se MCP Servers API for responseksempler, JSON-RPC-feil og API-et for administrasjon av eksterne servere.