Brug ThunderPhone som en MCP-server

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:

Retning	Resultat
Ekstern MCP-server → ThunderPhone-agent	Din stemmeagent kan kalde den eksterne servers værktøjer.
ThunderPhone → din MCP-klient	Din 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"
      }
    }
  }
}

En sk_live_-nøgle kan få adgang til organisationsdata og foretage opkald. Hold den ude af browserkode, repositories, skærmbilleder og chatlogs. Brug et hemmelighedslager, der understøttes af din MCP-klient, og tilbagekald straks en nøgle, hvis den eksponeres.

Tilgængelige værktøjer

Værktøj	Argumenter	Hvad det gør
`list_agents`	ingen	Viser organisationens agenter med id, navn, produkt og stemme.
`get_agent`	`agent_id`	Henter én agent.
`place_call`	`agent_id`, `from_number`, `to_number`	Foretager et udgående opkald med samme validerings- og faktureringskontroller som REST-opkaldsendepunktet.
`get_call`	`call_id`	Henter opkaldsstatus, oversigt og vurdering.
`list_calls`	valgfri `limit` (1–100), valgfri `status`	Viser seneste opkald.
`get_call_transcript`	`call_id`	Henter 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.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

Brug ThunderPhone som en MCP-server

Godkendelse

Tilgængelige værktøjer

Protokolmetoder

Foretag opkald sikkert

Komplet wire-reference

​Godkendelse

​Tilgængelige værktøjer

​Protokolmetoder

​Foretag opkald sikkert

​Komplet wire-reference

Godkendelse

Tilgængelige værktøjer

Protokolmetoder

Foretag opkald sikkert

Komplet wire-reference