ThunderPhone 2.0 er lanceret.Selvbetjening fra 2 cent/min.Læs mere om lanceringen
Kom i gang

Connect tools & data

Brug ThunderPhone som en MCP-server

Forbind en vilkårlig Streamable HTTP MCP-klient til ThunderPhone for at liste agenter, inspicere opkald og transskriptioner samt foretage udgående opkald med en organisations-API-nøgle.

ThunderPhone eksponerer en Model Context Protocol-server på:

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

Peg en MCP-klient mod det Streamable HTTP-endepunkt for at gøre din organisations agenter og opkald tilgængelige som værktøjer. Dette er den modsatte retning af at forbinde en ekstern MCP-server til en stemmeagent:

RetningResultat
Ekstern MCP-server → ThunderPhone-agentDin stemmeagent kan kalde den eksterne servers værktøjer.
ThunderPhone → din MCP-klientDin MCP-klient kan kalde ThunderPhone-værktøjer for agenter og opkald.

Godkendelse

Opret en sk_live_-nøgle under Organisation → Nøgler, og send den som et Bearer-token. MCP-endepunktet accepterer organisationens API-nøgler, ikke dashboardets sessionscookies eller publicerbare widgetnøgler.

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

Tilgængelige værktøjer

VærktøjArgumenterHvad det gør
list_agentsingenViser organisationens agenter med id, navn, produkt og stemme.
get_agentagent_idHenter én agent.
place_callagent_id, from_number, to_numberForetager et udgående opkald med samme validerings- og faktureringskontroller som REST-opkaldsendepunktet.
get_callcall_idHenter opkaldsstatus, oversigt og vurdering.
list_callsvalgfri limit (1–100), valgfri statusViser seneste opkald.
get_call_transcriptcall_idHenter det komplette transkript for et opkald.

Alle værktøjer er afgrænset til den organisation, der er knyttet til API-nøglen. Et id fra en anden organisation opfører sig som utilgængeligt.

Protokolmetoder

Endepunktet implementerer de MCP JSON-RPC-metoder, der kræves for Streamable HTTP-klienter:

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

Du kan inspicere værktøjskataloget 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": {}
  }'

Kald et værktøj med dets navn og argumenter:

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

Værktøjsresultater er MCP-tekstindholdselementer. Værktøjsfejl returneres i resultatet med isError: true; ukendte JSON-RPC-metoder returnerer en protokolfejl.

Foretag opkald sikkert

place_call følger de samme regler som POST /v1/call: agenten og nummeret skal tilhøre nøglens organisation, nummeret skal være berettiget til udgående opkald, organisationen skal have tilstrækkelig saldo, og enhver relevant bekræftelse af udgående opkald skal være gennemført.

Behandl en klient med adgang til place_call som en produktionsklient til opkald. Begræns, hvem der kan bruge klienten, gør den tilsigtede agent og det tilsigtede nummer tydelige i dens egen prompt, og gennemgå opkald i Opkaldshistorik.

Komplet wire-reference

Se MCP Servers API for svareksempler, JSON-RPC-fejl og API'et til administration af eksterne servere.