Odel
MCP server: One MCP server.

voximplant-mcp

@theyahiaMCP server · External

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

Phone callsv1.2.3MITTypeScript
Freeno charge per call
How to install

Runs on your machine from its package; the steps are below.

What it does

  1. Reads
  2. Writes
  3. High impact

At most: moves money, runs code or commands, deletes data, or sends messages for you.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

npm@theyahia/voximplant-mcpv1.2.3

Run

npx -y @theyahia/voximplant-mcp

MCP client config

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

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

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

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

npm CI License: MIT

Установка

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

Разработка

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

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

⭐ Поддержать

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

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

Similar modules

Browse Phone calls