voximplant-mcp

io.github.theYahiaPublished by GitHub account theYahiav1.2.3Updated Oct 27, 2026

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

VerifiedSTDIODesktop onlyCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

MCP server for Voximplant cloud telephony that lets an assistant query call history and recordings, send SMS, and inspect routing, queues and billing.

What you can do
  • Query call history, recordings and record storages, plus ACD and SmartQueue state
  • Send SMS and A2P SMS, and read SMS and A2P delivery history
  • Inspect account info, balance and billing transaction history
  • List applications, routing rules, VoxEngine scenarios and update scenario code or name
  • List phone numbers, caller IDs, ACD queues, skills and users
When to use it
Useful when you want to ask an assistant about Voximplant call traffic, lost calls, recordings, SMS delivery, queue staffing or account spend, or to trigger an outbound call or SMS from chat instead of the Voximplant panel.
Requirements
Runs locally over stdio via npx from the npm package, or optionally as a Streamable HTTP server on a local port. Needs a Voximplant account with VOXIMPLANT_ACCOUNT_ID and VOXIMPLANT_API_KEY set as environment variables; the README notes the api_key method is deprecated but still working.
Before you install
The API key grants access to the whole telephony account. Several tools act on real systems: start_call places calls, send_sms and send_a2p_sms send messages, and send_a2p_sms is a bulk send to up to 100 numbers that incurs charges; update_scenario changes live scenario code. Account info is filtered to hide api_key and callback_salt, but other tools return raw API responses.

Installation

In SourceWeft

  1. Open voximplant-mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

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

⭐ Поддержать

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

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

Source: README.md at commit d4ecc50

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.2.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts