Bruk ThunderPhone som en MCP-server

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:

Retning	Resultat
Ekstern MCP-server → ThunderPhone-agent	Stemmeagenten din kan kalle verktøyene på den eksterne serveren.
ThunderPhone → MCP-klienten din	MCP-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"
      }
    }
  }
}

En sk_live_-nøkkel kan få tilgang til organisasjonsdata og foreta anrop. Hold den utenfor nettleserkode, repositorier, skjermbilder og chatlogger. Bruk et hemmelighetslager som støttes av MCP-klienten din, og tilbakekall en nøkkel umiddelbart hvis den eksponeres.

Tilgjengelige verktøy

Verktøy	Argumenter	Hva det gjør
`list_agents`	ingen	Viser organisasjonens stemmeagenter med id, navn, produkt og stemme.
`get_agent`	`agent_id`	Henter én stemmeagent.
`place_call`	`agent_id`, `from_number`, `to_number`	Foretar et utgående anrop med samme validerings- og faktureringskontroller som REST-anropsendepunktet.
`get_call`	`call_id`	Henter anropsstatus, sammendrag og vurdering.
`list_calls`	valgfri `limit` (1–100), valgfri `status`	Viser nylige anrop.
`get_call_transcript`	`call_id`	Henter 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.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

Bruk ThunderPhone som en MCP-server

Autentiser

Tilgjengelige verktøy

Protokollmetoder

Foreta anrop på en trygg måte

Fullstendig wire-referanse

​Autentiser

​Tilgjengelige verktøy

​Protokollmetoder

​Foreta anrop på en trygg måte

​Fullstendig wire-referanse

Autentiser

Tilgjengelige verktøy

Protokollmetoder

Foreta anrop på en trygg måte

Fullstendig wire-referanse