@theyahia/voximplant-mcp
This server integrates Voximplant's cloud telephony API into MCP, enabling call management, SMS, recordings, ACD queues, routing, and account operations.
Call Management
Retrieve call history for a specified date range with pagination (
get_call_history)Initiate outbound calls via a routing rule (
start_call)View currently active call sessions (
get_active_calls)Access call recordings and transcription links for a given period (
get_recordings)
SMS & Messaging
Send individual SMS messages (
send_sms)Retrieve SMS history filterable by date range, sender, and recipient (
get_sms_history)Send bulk A2P SMS campaigns (up to 100 numbers) (
send_a2p_sms)Retrieve A2P SMS delivery history (
get_a2p_sms_history)
ACD / SmartQueue
Get ACD queue state and operator availability (
get_acd_state,get_sq_state)List ACD queues with skills and agent counts (
get_queues)Retrieve ACD skills catalog (
get_skills)
Routing & Applications
List Voximplant applications, optionally with rules/scenarios (
get_applications)Retrieve routing rules for a specific application (
get_rules)
VoxEngine Scenarios
List available VoxEngine scenarios (
get_scenarios)Update the code or name of a scenario (
update_scenario)
Phone Numbers & Caller IDs
List account phone numbers with SMS support info and bindings (
get_phone_numbers)List Caller IDs and their verification status (
get_caller_ids)
Account & Billing
Get account info (balance, tariff, limits) with sensitive fields like
api_keyhidden (get_account_info)Retrieve billing transaction history (
get_transaction_history)
Users
List users on the Voximplant account (
get_users)
Pre-built Skills (Prompts)
skill-call-history: Summarize call history for the last 24 hoursskill-account-info: Quickly retrieve account balance, tariff, and limits
Error Handling: Errors are returned as {"error": "..."} with an isError flag.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@theyahia/voximplant-mcp Show my recent call history"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpVS 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=8080Related MCP server: VoIPbin MCP Server
Инструменты (21)
Инструмент | Описание |
| История звонков за период |
| Инициировать исходящий звонок по правилу (номер передаётся сценарию через customData) |
| Состояние ACD-очередей: звонки в очереди, статусы операторов |
| Текущее состояние SmartQueue-очереди |
| Ссылки на записи разговоров (и transcription_url) за период |
| Список хранилищ записей |
| Отправить SMS |
| История SMS за период |
| История доставки A2P-SMS |
| ⚠️ Массовая A2P-рассылка (до 100 номеров) — действие с оплатой |
| Информация об аккаунте (баланс, тариф). Секреты ( |
| История биллинговых транзакций (расходы) |
| Список приложений (опц. с правилами/сценариями) |
| Правила маршрутизации приложения |
| Телефонные номера аккаунта (поддержка SMS, привязка) |
| Caller ID и статус их верификации |
| ACD-очереди (опц. с навыками и числом операторов) |
| Каталог навыков ACD для маршрутизации |
| Список сценариев VoxEngine |
| Обновить код/имя сценария VoxEngine |
| Список пользователей |
Формат вывода: инструменты возвращают pretty-JSON ответа API; ошибки приходят как
{ "error": "..." }с флагомisError. Ответget_account_infoпроходит строгий витлист — секретные поля (api_key,callback_salt) в него не попадают.
Скиллы (2)
Скилл | Описание |
| Сводка истории звонков за последние 24 часа |
| Информация об аккаунте 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
Available Tools
23 toolsget_a2p_sms_historyB
История доставки A2P-SMS с фильтрами по номерам, статусу и периоду.
Inputs: count, offset, to_date, from_date, +3 more.
get_account_infoA
Получить информацию об аккаунте Voximplant (баланс, тариф, лимиты). Секретные поля (api_key, callback_salt) скрыты из ответа.
Inputs: no named parameters.
get_acd_stateB
Получить состояние ACD-очередей Voximplant (звонки в очереди, статусы операторов).
Inputs: acd_queue_id.
get_applicationsC
Список приложений Voximplant (опционально с правилами/сценариями).
Inputs: count, offset, with_rules, application_id, +2 more.
get_caller_idsB
Список Caller ID аккаунта и статус их верификации.
Inputs: count, active, offset.
get_call_historyB
Получить историю звонков Voximplant за период.
Inputs: to_date (required), from_date (required), count, offset.
get_phone_numbersB
Список телефонных номеров аккаунта Voximplant (привязка, поддержка SMS, продление).
Inputs: count, offset, country_code, sms_supported, +1 more.
get_queuesB
Список ACD-очередей Voximplant (опционально с навыками и числом операторов).
Inputs: count, offset, with_skills, application_id, +1 more.
get_recordingsA
Получить список записей разговоров за период. Возвращает URL для скачивания записи (и transcription_url, если транскрипция готова).
Inputs: to_date (required), from_date (required), count, offset, +1 more.
get_record_storagesB
Список хранилищ записей разговоров.
Inputs: record_storage_name.
get_rulesB
Получить правила маршрутизации Voximplant для приложения.
Inputs: application_id (required), count, offset.
get_scenariosC
Получить список сценариев Voximplant.
Inputs: count, offset, scenario_name.
get_skillsB
Каталог навыков (skills) ACD для маршрутизации.
Inputs: count, offset, skill_name.
get_sms_historyB
Получить историю SMS-сообщений за период с фильтрами по номерам.
Inputs: to_date (required), from_date (required), count, offset, +2 more.
get_sq_stateC
Текущее состояние SmartQueue-очереди (операторы, задачи).
Inputs: sq_queue_id (required), application_id (required), sq_queue_name.
get_transaction_historyC
История биллинговых транзакций за период (расходы аккаунта).
Inputs: to_date (required), from_date (required), count, offset, +1 more.
get_usersC
Получить список пользователей Voximplant.
Inputs: count, offset.
send_a2p_smsA
⚠️ ДЕЙСТВИЕ С ОПЛАТОЙ: массовая A2P-рассылка SMS (до 100 получателей) через зарегистрированный SenderID. Реально отправляет сообщения и тарифицируется — обязательно подтвердите номера и текст с пользователем перед вызовом, не вызывайте автоматически.
Inputs: text (required), src_number (required), dst_numbers (required), store_body.
send_smsC
Отправить SMS через Voximplant.
Inputs: source (required), sms_body (required), destination (required).
skill-account-infoA
Получить информацию об аккаунте Voximplant: баланс, тариф, лимиты.
Inputs: no named parameters.
skill-call-historyA
Получить сводку истории звонков за последние 24 часа.
Inputs: no named parameters.
start_callA
Инициировать исходящий звонок через Voximplant по правилу маршрутизации. Номер назначения передаётся сценарию через customData — сценарий VoxEngine должен его обработать.
Inputs: rule_id (required), destination (required), caller_id, script_custom_data.
update_scenarioC
Обновить код или имя сценария VoxEngine. Позволяет агенту динамически менять логику звонка.
Inputs: scenario_id (required), script, scenario_name.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 23 tools
There is direct overlap between get_account_info and skill-account-info, which appear to expose the same account information, and get_call_history and skill-call-history are also very similar. Additionally, get_acd_state, get_sq_state, and get_queues all touch queue/state concepts and may be confused without reading carefully.
Most tools follow a clear get_* pattern, with action verbs like send_, start_, and update_ for mutations. However, skill-account-info and skill-call-history break the convention using hyphenated noun phrases, creating a noticeable inconsistency in an otherwise predictable naming scheme.
23 tools is on the heavy side and borders on overwhelming for a single MCP server. The breadth is somewhat justified by Voximplant's wide platform surface, but duplicate account-info and call-history tools inflate the count without adding real capability.
The tool surface is heavily read-oriented: most resources are queryable, but mutation coverage is sparse. There is no create/delete/update for users, phone numbers, queues, rules, or scenarios beyond update_scenario, and no way to manage recordings or caller IDs, so agents cannot perform full lifecycle operations.
Maintenance
Related MCP Connectors
MCP server for Vonage API documentation, code snippets, tutorials, and troubleshooting.
Open-source MCP gateway with per-agent tool permissions, call approvals and tool-change review.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP Server that integrates various Vonage APIs as MCP tools, to make it easier for developers to work with and create Vonage applications.3Apache 2.0

VoIPbin MCP Serverofficial
AlicenseBqualityBmaintenanceAn MCP server that enables AI assistants to interact with the VoIPbin CPaaS platform, exposing tools for managing calls, flows, messaging, conferencing, and more.662MIT- AlicenseAqualityBmaintenanceMCP server for Planfix API enabling task, project, contact, and comment management with 10 tools and 2 skills.2043 npm5MIT
- AlicenseNot gradedqualityBmaintenanceMCP server that provides SMS sending, CSV bulk SMS, and voice calling capabilities via the Vonage API.Apache 2.0