@theyahia/voximplant-mcp

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

MCP-сервер для Voximplant API — облачная телефония: история и инициация звонков, SMS и A2P-рассылки, записи разговоров, сценарии VoxEngine, правила маршрутизации, состояние ACD/SmartQueue-очередей, телефонные номера и биллинг. 21 инструмент + 2 скилла.

Установка

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_ids | Caller ID и статус их верификации | | get_queues | ACD-очереди (опц. с навыками и числом операторов) | | 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