Skip to main content
Glama
@theyahia/voximplant-mcp

@theyahia/voximplant-mcp

by theYahia

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

{
  "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

Related MCP server: VoIPbin MCP Server

Инструменты (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 дополняют сценарий:

Пример сценария: «Найди должников по платежам (yookassa), обзвони их голосом по сценарию (voximplant) и отправь SMS-напоминание тем, кто не ответил».

Разработка

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

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

⭐ Поддержать

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

Лицензия

MIT


Часть WWmcp · Telegram: @vhodvai

Available Tools

23 tools
get_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

    C2.8/5.0

    Scored across 23 tools

    Disambiguation2/5

    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.

    Naming Consistency3/5

    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.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers