將 ThunderPhone 用作 MCP 伺服器

ThunderPhone 於以下位置提供 Model Context Protocol 伺服器：

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

將 MCP 用戶端指向該串流 HTTP 端點，即可將你所屬組織的智能體及通話設為工具使用。這與將遙距 MCP 伺服器連接至語音智能體的方向相反：

方向	結果
遙距 MCP 伺服器 → ThunderPhone 智能體	你的語音智能體可以呼叫遙距伺服器的工具。
ThunderPhone → 你的 MCP 用戶端	你的 MCP 用戶端可以呼叫 ThunderPhone 的智能體及通話工具。

驗證身分

在 組織 → 金鑰 下建立 sk_live_ 金鑰，並將其作為 Bearer 權杖傳送。MCP 端點接受組織 API 金鑰，不接受控制台工作階段 Cookie 或可公開使用的小工具金鑰。

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

可用工具

工具	參數	功能
`list_agents`	無	列出組織智能體，包括識別碼、名稱、產品及語音。
`get_agent`	`agent_id`	擷取一個智能體。
`place_call`	`agent_id`, `from_number`, `to_number`	撥出電話，並套用與 REST 通話端點相同的驗證及收費限制。
`get_call`	`call_id`	擷取通話狀態、摘要及評分。
`list_calls`	選填 `limit`（1–100）、選填 `status`	列出最近通話。
`get_call_transcript`	`call_id`	擷取通話的完整逐字稿。

所有工具均限於 API 金鑰所綁定的組織範圍內使用。來自其他組織的識別碼會被視為不可用。

協定方法

此端點實作串流 HTTP 用戶端所需的 MCP JSON-RPC 方法：

initialize
notifications/initialized
tools/list
tools/call

你可以直接檢視工具目錄：

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

使用工具名稱及參數呼叫工具：

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

工具結果會以 MCP 文字內容項目傳回。工具失敗會在結果中以 isError: true 傳回；未知的 JSON-RPC 方法會傳回協定錯誤。

安全撥打電話

place_call 遵循與 POST /v1/call相同的規則：智能體及電話號碼必須屬於該金鑰的組織，電話號碼必須符合撥出電話資格，組織必須有足夠餘額，並且必須完成任何適用的撥出電話確認程序。

應將可存取 place_call 的用戶端視為正式環境的撥號方。限制可以使用該用戶端的人員，在其提示中清楚指明預定使用的智能體及電話號碼，並在通話記錄中檢閱通話。

完整通訊參考

請參閱 MCP 伺服器 API，了解回應範例、JSON-RPC 錯誤及遙距伺服器管理 API。