English Français العربية

voximplant-mcp

السجل الرسمي أخرى

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @theyahia/voximplant-mcp
Claude Code 
claude mcp add voximplant-mcp -- npx -y @theyahia/voximplant-mcp@1.2.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "voximplant-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/voximplant-mcp@1.2.3"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. MCP-сервер для Voximplant — облачная телефония, звонки и SMS через ИИ
  2. Установка
  3. Инструменты (21)
  4. Скиллы (2)
  5. Примеры
  6. WWmcp — связки с соседними серверами
  7. Разработка
  8. ⭐ Поддержать
  9. Лицензия

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

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

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

Установка

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):

{
  "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_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-напоминание тем, кто не ответил».

Разработка

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

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

⭐ Поддержать

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

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

الأسئلة الشائعة

ما هو voximplant-mcp؟

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

كيف أثبّت voximplant-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add voximplant-mcp -- npx -y @theyahia/voximplant-mcp@1.2.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج voximplant-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل voximplant-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون voximplant-mcp؟

ينشره theYahia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.