Използвайте ThunderPhone като MCP сървър

ThunderPhone предоставя сървър за Model Context Protocol на адрес:

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

Насочете MCP клиент към тази крайна точка за Streamable HTTP, за да предоставите агентите и обажданията на вашата организация като инструменти. Това е обратната посока на свързването на отдалечен MCP сървър към гласов агент:

Посока	Резултат
Отдалечен MCP сървър → ThunderPhone агент	Вашият гласов агент може да извиква инструментите на отдалечения сървър.
ThunderPhone → вашият MCP клиент	Вашият MCP клиент може да извиква инструментите на ThunderPhone за агенти и обаждания.

Удостоверяване

Създайте ключ sk_live_ в Организация → Ключове и го изпратете като Bearer токен. MCP крайната точка приема API ключове на организацията, а не „бисквитки“ за сесия в таблото или публикуеми ключове за уиджети.

{
  "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 ключа. Идентификатор от друга организация се държи като недостъпен.

Методи на протокола

Крайната точка реализира MCP JSON-RPC методите, необходими за клиенти на Streamable HTTP:

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 като клиент, който извършва обаждания в продукционна среда. Ограничете кой може да използва клиента, посочете ясно предвидените агент и номер в собствения му промпт и преглеждайте обажданията в История на обажданията.

Пълна справка за протокола

Вижте API за MCP сървъри за примери за отговори, JSON-RPC грешки и API за управление на отдалечени сървъри.