voximplant-mcp

io.github.theYahia由 GitHub 账号 theYahia 发布v1.2.3更新于 Oct 27, 2026

MCP server for Voximplant — cloud telephony, call history, SMS (Russia)

已验证STDIO仅桌面沟通与协作商业与电商

概览

AI 生成的概览

面向 Voximplant 云电话的 MCP 服务器，让助手查询通话记录与录音、发送短信，并查看路由、队列和账单信息。

可以做什么
  • 查询通话记录、通话录音与录音存储，以及 ACD 和 SmartQueue 队列状态
  • 发送短信与 A2P 短信，并查看短信及 A2P 送达历史
  • 查看账户信息、余额与计费交易记录
  • 列出应用、路由规则、VoxEngine 场景，并更新场景代码或名称
  • 列出电话号码、主叫号码、ACD 队列、技能与用户
适用场景
适合需要让助手查询 Voximplant 通话量、未接来电、录音、短信送达、队列坐席或账户支出，或直接在对话中发起外呼与发送短信而不必打开 Voximplant 控制台的场景。
运行要求
通过 npx 从 npm 包以 stdio 在本地运行，也可选以 Streamable HTTP 方式在本地端口启动。需要 Voximplant 账户，并通过环境变量 VOXIMPLANT_ACCOUNT_ID 与 VOXIMPLANT_API_KEY 提供凭据；README 说明 api_key 方式已被标记为弃用但仍可用。
安装前请注意
该 API 密钥可访问整个电话账户。多个工具会操作真实系统：start_call 会发起通话，send_sms 与 send_a2p_sms 会发送短信，其中 send_a2p_sms 是面向最多 100 个号码的批量发送并产生费用；update_scenario 会修改线上场景代码。账户信息经过过滤以隐藏 api_key 与 callback_salt，但其他工具返回原始 API 响应。

安装

在 SourceWeft 中

  1. 打开 控制台中的 voximplant-mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

MCP-сервер для Voximplant — облачная телефония, звонки и SMS через ИИ

🌍 Часть WWmcp — коллекции из 46 MCP-серверов для развивающихся рынков (Россия, СНГ, MENA, Gulf, SE Asia, Africa). Единственная коллекция MCP, покрывающая не-западные API.

Если вы искали, как подключить Voximplant к нейросети, поднять историю звонков и записи разговоров или запустить обзвон и A2P-рассылку из чата — это оно. 21 инструмент и 2 скилла: звонки и их записи, SMS, сценарии VoxEngine, правила маршрутизации, очереди ACD/SmartQueue, телефонные номера и биллинг. Спрашиваете «сколько звонков потеряли вчера» — получаете цифру со ссылками на записи.

[npm] [CI] [License: MIT]

Установка

1. Получите ключи

VOXIMPLANT_ACCOUNT_ID и VOXIMPLANT_API_KEY — в панели управления Voximplant (раздел API).

Аутентификация по api_key официально помечена как deprecated, но рабочая — её достаточно, если доступ к аккаунту есть только у вас. Современная альтернатива — service-account JWT (RS256); этот сервер использует классический account_id + api_key.

2. Подключите сервер

Claude Desktop (claude_desktop_config.json):

json
{  "mcpServers": {    "voximplant": {      "command": "npx",      "args": ["-y", "@theyahia/voximplant-mcp"],      "env": {        "VOXIMPLANT_ACCOUNT_ID": "your-id",        "VOXIMPLANT_API_KEY": "your-key"      }    }  }}

Claude Code:

bash
claude mcp add voximplant -e VOXIMPLANT_ACCOUNT_ID=your-id -e VOXIMPLANT_API_KEY=your-key -- npx -y @theyahia/voximplant-mcp

VS Code / Cursor:

json
{  "servers": {    "voximplant": {      "command": "npx",      "args": ["-y", "@theyahia/voximplant-mcp"],      "env": {        "VOXIMPLANT_ACCOUNT_ID": "your-id",        "VOXIMPLANT_API_KEY": "your-key"      }    }  }}

Streamable HTTP:

bash
npx @theyahia/voximplant-mcp --http# Сервер: http://localhost:3000/mcp · health: http://localhost:3000/health · порт: PORT=8080

Инструменты (21)

ИнструментОписание
get_call_historyИстория звонков за период
start_callИнициировать исходящий звонок по правилу (номер передаётся сценарию через customData)
get_acd_stateСостояние ACD-очередей: звонки в очереди, статусы операторов
get_sq_stateТекущее состояние SmartQueue-очереди
get_recordingsСсылки на записи разговоров (и transcription_url) за период
get_record_storagesСписок хранилищ записей
send_smsОтправить SMS
get_sms_historyИстория SMS за период
get_a2p_sms_historyИстория доставки A2P-SMS
send_a2p_sms⚠️ Массовая A2P-рассылка (до 100 номеров) — действие с оплатой
get_account_infoИнформация об аккаунте (баланс, тариф). Секреты (api_key, callback_salt) скрыты
get_transaction_historyИстория биллинговых транзакций (расходы)
get_applicationsСписок приложений (опц. с правилами/сценариями)
get_rulesПравила маршрутизации приложения
get_phone_numbersТелефонные номера аккаунта (поддержка SMS, привязка)
get_caller_idsCaller ID и статус их верификации
get_queuesACD-очереди (опц. с навыками и числом операторов)
get_skillsКаталог навыков ACD для маршрутизации
get_scenariosСписок сценариев VoxEngine
update_scenarioОбновить код/имя сценария VoxEngine
get_usersСписок пользователей

Формат вывода: инструменты возвращают pretty-JSON ответа API; ошибки приходят как { "error": "..." } с флагом isError. Ответ get_account_info проходит строгий витлист — секретные поля (api_key, callback_salt) в него не попадают.

Скиллы (2)

СкиллОписание
skill-call-historyСводка истории звонков за последние 24 часа
skill-account-infoИнформация об аккаунте Voximplant

Примеры

Покажи историю звонков за вчераОтправь SMS на +79001234567Что сейчас в ACD-очередях — кто свободен?Покажи баланс и расходы за январьКакие у меня номера с поддержкой SMS?Обнови сценарий 123 — добавь логированиеНачни звонок на +79001234567 по правилу 456Дай ссылки на записи звонков за вчера

WWmcp — связки с соседними серверами

Voximplant закрывает голос и SMS; соседние серверы из WWmcp дополняют сценарий:

  • tgstat-mcp — аналитика Telegram-каналов
  • yookassa-mcp — платежи и чеки
  • vk-ads-mcp — рекламные кампании VK Ads

Пример сценария: «Найди должников по платежам (yookassa), обзвони их голосом по сценарию (voximplant) и отправь SMS-напоминание тем, кто не ответил».

Разработка

bash
npm installnpm run build      # компиляция в dist/ (тесты исключены)npm run typecheck  # проверка типов, включая тестыnpm test           # vitest

Проверка живых предположений об API (имена методов, параметры) — в docs/VERIFICATION.md.

⭐ Поддержать

Если сервер полезен — поставьте звезду этому репозиторию и WWmcp. Это помогает другим найти коллекцию серверов для не-западных API.

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

来源：README.md，提交 d4ecc50

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.2.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分