io.github.theYahia/voximplant-mcp

Official

by theYahia · TypeScript

voximplant-mcp

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

Interact with Voximplant cloud telephony system for calls, history, and SMS management.

Topics

claudemcpmodel-context-protocolrussian-apitypescriptvoximplantcpaasai-agentsanthropicemerging-marketsmcp-serversrussiatelephony

README.md7 KBView on GitHub

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

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_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

Примеры

code

Покажи историю звонков за вчера
Отправь 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 install
npm run build      # компиляция в dist/ (тесты исключены)
npm run typecheck  # проверка типов, включая тесты
npm test           # vitest

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

⭐ Поддержать

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

Лицензия

MIT

Install

claude_desktop_config.json

{
  "mcpServers": {
    "voximplant-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/voximplant-mcp@1.2.3"
      ]
    }
  }
}