voximplant-mcp

Voximplant MCP 服务 — 通过 AI 使用云电话、拨打电话和发送 SMS

🌍 属于 WWmcp — 面向新兴市场（俄罗斯、独联体、MENA、Gulf、SE Asia、Africa）的 46 个 MCP 服务集合。唯一覆盖非西方 API 的 MCP 集合。

如果你正在寻找如何将 Voximplant 接入神经网络、获取通话历史记录和录音，或在聊天中发起外呼和 A2P 群发，这就是你要找的内容。包含 21 个工具和 2 个技能：通话及其录音、SMS、VoxEngine 脚本、路由规则、ACD/SmartQueue 队列、电话号码和账单。询问“昨天有多少通电话未接通”，即可获得数字以及录音链接。

安装

1. 获取密钥

在 Voximplant 控制面板（API 部分）获取 VOXIMPLANT_ACCOUNT_ID 和 VOXIMPLANT_API_KEY。

基于 api_key 的身份验证已被官方标记为 deprecated，但仍可使用——如果只有你能访问该账户，这种方式就足够了。现代替代方案是 service-account JWT（RS256）；此服务使用经典的 account_id + api_key。

2. 连接服务

Claude Desktop（claude_desktop_config.json）：

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

Claude Code：

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

VS Code / Cursor：

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

Streamable HTTP：

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_ids	Caller ID 及其验证状态
get_queues	ACD 队列（可选包含技能和坐席数量）
get_skills	用于路由的 ACD 技能目录
get_scenarios	VoxEngine 脚本列表
update_scenario	更新 VoxEngine 脚本代码/名称
get_users	用户列表

**输出格式：**工具会返回 API 响应的格式化 JSON；错误会以 { "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-напоминание тем, кто не ответил».

Разработка

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

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

⭐ Поддержать

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

Лицензия

MIT

---

Часть WWmcp · Telegram: @vhodvai