voximplant-mcp

Voximplant MCP サーバー — AI によるクラウドテレフォニー、通話、SMS

🌍 WWmcp の一部です。新興市場（ロシア、CIS、MENA、Gulf、SE Asia、Africa）向けの46個の MCP サーバーを集めたコレクションです。西側以外の API を網羅する唯一の MCP コレクションです。

Voximplant をニューラルネットワークに接続する方法、通話履歴や録音を取得する方法、チャットから架電や A2P 配信を開始する方法をお探しなら、これがその答えです。21個のツールと2つのスキルを備えています。通話と録音、SMS、VoxEngine シナリオ、ルーティングルール、ACD/SmartQueue キュー、電話番号、課金に対応しています。「昨日、何件の通話を取りこぼしましたか」と尋ねると、録音へのリンク付きで件数を確認できます。

インストール

1. キーを取得する

VOXIMPLANT_ACCOUNT_ID と VOXIMPLANT_API_KEY は、Voximplant 管理パネル（API セクション）で取得できます。

api_key による認証は公式に deprecated, but working とされています。アカウントにアクセスできるのが自分だけであれば、これで十分です。現在の代替手段はサービスアカウント 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 で返します。エラーは isError フラグ付きの { "error": "..." } として返されます。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