Wavix

официальный

Wavix — это глобальная коммуникационная платформа, предоставляющая API для голосовой связи, SMS, двухфакторной аутентификации и телефонных номеров. Наш MCP-сервер интегрирует эти возможности в AI-агентов и агентные рабочие процессы.

GitHub

Попробовать этот MCPСпонсировано

Что можно делать с Wavix MCP?

Отправка транзакционных SMS/MMS — Запросите отправку сообщения через sms_and_mms_messages_send, получив ID сообщения и статус доставки.
Запуск сценариев 2FA-верификации — Создайте код с помощью two_fa_verification_create, затем проверьте его через two_fa_verification_check.
Поиск и покупка телефонных номеров — Найдите доступные номера с помощью buy_numbers_list, добавьте в корзину через cart_add и завершите покупку с cart_checkout.
Поиск по транскрипциям звонков — Используйте cdrs_search для поиска звонков по ключевым словам в транскрипции, затем обогатите результаты с помощью cdrs_get.
Загрузка и транскрибация записей — Получите запись через call_recording_get, запросите транскрибацию с cdrs_retranscribe и получите результаты через cdrs_transcription_get.
Аудит биллинга и счетов — Просмотрите расходы с помощью billing_transactions_list и скачайте PDF-счета через billing_invoices_download.

Документация

Wavix MCP Server

Сервер Model Context Protocol, который предоставляет LLM и AI-агентам прямой доступ к телеком-платформе Wavix — SMS/MMS, голосовые звонки, 2FA, SIP-транки, управление телефонными номерами, регистрация 10DLC, запись звонков, речевая аналитика и биллинг.

Wavix — глобальная коммуникационная платформа для отправки SMS, совершения голосовых звонков и запуска 2FA-сценариев через единый API. Доступна бесплатная пробная версия; платное использование соответствует тарифному плану Wavix, привязанному к вашему аккаунту.

Самый быстрый способ использовать этот MCP-сервер — хостируемая конечная точка по адресу https://mcp.wavix.com/mcp: подключите к ней любой MCP-совместимый клиент и аутентифицируйтесь с помощью вашего Wavix API-ключа. Если вам нужно самостоятельное развёртывание (собственное развёртывание Wavix, работа за файрволом, выделенный экземпляр), см. раздел Запустите свой.

Содержание

Конечная точка
Установка — в один клик, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
Запустите свой (самостоятельное развёртывание)
Примеры
Инструменты → полный каталог в TOOLS.md
Ресурсы
Аутентификация (рекомендации, если токен скомпрометирован)
Устранение неполадок
Совместимость и ограничения
Поддержка, Участие в разработке, Безопасность, Лицензия

Конечная точка

Поле	Значение
URL	`https://mcp.wavix.com/mcp`
Транспорт	Streamable HTTP
Аутентификация	`Authorization: Bearer <api_key>`
Инструменты	см. TOOLS.md
Ресурсы	Документация Wavix + спецификация OpenAPI (автообнаружение)

Получите Wavix API-ключ в Wavix Console → Administration → API keys → Create new.

Установка

Перед началом: получите ваш Wavix API-ключ.

Войдите на https://wavix.com.
Откройте Administration → API keys.
Нажмите Create new (или скопируйте существующий ключ). Держите его под рукой — вы вставите его вместо YOUR_API_KEY ниже.

Установка в один клик

⚠️ Кнопки ниже заполняют MCP-конфигурацию вашего редактора токеном-заглушкой YOUR_API_KEY. После завершения установки редактором откройте сгенерированный конфиг и замените заглушку на ваш реальный API-ключ перед отправкой любого запроса — иначе каждый вызов будет возвращать 401 Unauthorized.

Чтобы удалить позже: откройте тот же файл конфигурации (~/.cursor/mcp.json, .vscode/mcp.json или эквивалентный для вашего редактора) и удалите запись wavix, либо удалите коннектор через интерфейс MCP / Connectors вашего редактора.

Claude Code

claude mcp add --transport http wavix https://mcp.wavix.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Используйте claude mcp list для проверки и /mcp внутри сессии для получения статуса.

Claude Desktop / Claude Web

Настройки → Connectors → Add custom connector:

Имя: Wavix
URL: https://mcp.wavix.com/mcp
Транспорт: Streamable HTTP
Заголовок аутентификации: Authorization: Bearer <api_key>

Cursor (вручную)

Добавьте в ~/.cursor/mcp.json (или в проектный .cursor/mcp.json):

{
  "mcpServers": {
    "wavix": {
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Cursor 2.4+ отображает полный каталог; более ранние версии ограничены 40 инструментами.

VS Code (вручную, GitHub Copilot Chat)

Создайте .vscode/mcp.json в вашем рабочем пространстве (или добавьте тот же объект servers под ключом "mcp" в пользовательском settings.json):

{
  "servers": {
    "wavix": {
      "type": "http",
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

См. руководство по MCP-серверам VS Code для актуальной схемы.

Codex CLI

Codex CLI поддерживает MCP через stdio. Подключитесь к хостируемому серверу через mcp-remote. Отредактируйте ~/.codex/config.toml:

[mcp_servers.wavix]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.wavix.com/mcp",
  "--header",
  "Authorization:Bearer ${WAVIX_API_KEY}"
]

[mcp_servers.wavix.env]
WAVIX_API_KEY = "YOUR_API_KEY"

Windsurf / другие клиенты

Подойдёт любой MCP-клиент, поддерживающий транспорт Streamable HTTP с пользовательскими заголовками. Используйте:

URL: https://mcp.wavix.com/mcp
Заголовок: Authorization: Bearer <api_key>

Настраиваете через AI-агента? Укажите вашему агенту на llms-install.md — это машиночитаемое руководство по установке, которое предоставляет модели URL, заголовок и конфигурацию для каждого клиента в детерминированном формате, чтобы она не импровизировала со значениями конечных точек.

Запустите свой

Хостируемый сервер работает из коробки для большинства пользователей. Разверните самостоятельно, если вам нужно указать на непубличное развёртывание Wavix, работать за файрволом или действовать внутри собственной инфраструктуры.

Docker

docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server

Сервер прослушивает порт 8000 и предоставляет MCP-конечную точку по адресу /mcp. Укажите вашему клиенту http://<host>:8000/mcp.

Из исходного кода

git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp

Требуется Python 3.10+.

Конфигурация

Переменная окружения	По умолчанию	Назначение
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	Переопределение вышестоящей конечной точки Wavix API (для внутренних развёртываний или staging)

Для запуска сервера учётные данные Wavix не требуются — они передаются в каждом запросе из заголовка Authorization: Bearer <api_key> MCP-клиента. При самостоятельном развёртывании вы отвечаете за завершение TLS перед сервером (nginx, Caddy, облачный балансировщик) перед публичным доступом.

Примеры

Конкретные промпты, которые можно использовать в любом подключённом клиенте.

Номера телефонов ниже (+1 310 555 0100, +44 7700 900123) находятся в зарезервированных тестовых диапазонах (NANP 555 и Ofcom 070 09xx) — их можно безопасно копировать дословно, через них недоступны реальные абоненты.

Отправка транзакционного SMS

Промпт: «Отправь SMS с +13105550100 на +447700900123 с текстом "Your verification code is 4821".»

Агент вызывает sms_and_mms_messages_send с from, to и text. Возвращается ID сообщения и статус доставки.

Запуск 2FA-проверки

Промпт: «Отправь 2FA-код подтверждения на +13105550100 через SMS. Когда я передам тебе полученный код, проверь, корректен ли он.»

Агент вызывает two_fa_verification_create, ждёт, пока вы поделитесь кодом, полученным по SMS, затем вызывает two_fa_verification_check. Полезно для прототипирования сценариев без пароля без написания интеграционного кода.

Поиск и покупка телефонного номера

Промпт: «Найди доступный американский бесплатный номер с поддержкой SMS, добавь его в корзину и оформи заказ.»

Агент последовательно вызывает buy_numbers_list (фильтрация по стране и функциям), cart_add и cart_checkout. Подтвердите у пользователя перед оформлением заказа — это списывает средства с аккаунта.

Поиск по транскрипциям звонков

Промпт: «Покажи все входящие звонки со вчерашнего дня длиннее двух минут, в которых звонящий упомянул "refund".»

Агент использует cdrs_search по транскрипциям, затем обогащает каждый результат через cdrs_get для получения полных метаданных звонка.

Получение записи и её транскрибация

Промпт: «Получи запись звонка abc-123, попроси Wavix транскрибировать её и верни транскрипцию.»

Агент вызывает call_recording_get (возвращает предварительно подписанный URL для скачивания), cdrs_retranscribe, затем опрашивает cdrs_transcription_get.

Аудит биллинга

Промпт: «Сколько мы потратили на SMS в прошлом месяце? Дай мне ссылку для скачивания последнего счёта в формате PDF.»

Агент вызывает billing_transactions_list с фильтром по типу и дате, затем billing_invoices_list + billing_invoices_download. Инструмент загрузки возвращает предварительно подписанный URL на PDF, а не сам файл — откройте URL в браузере или передайте его вашему клиенту для получения документа.

Инструменты

122 инструмента, сгенерированных из спецификации Wavix OpenAPI. Аргументы соответствуют параметрам запроса и полям тела.

Группа	#	Охват
SMS и MMS	10	Отправка, список, получение сообщений; идентификаторы отправителя; отписки
Управление звонками	9	Начало / ответ / завершение звонков; воспроизведение аудио; сбор DTMF
Запись звонков	4	Список, скачивание (предварительно подписанный URL), удаление
Стриминг звонков	2	Запуск / остановка медиапотока
Вебхуки звонков	3	Список, создание, удаление
CDR	7	Список, экспорт, получение; поиск по транскрипциям и повторная транскрибация
Речевая аналитика	4	Загрузка, транскрибация, получение исходного файла
2FA	6	Создание / проверка / отмена / повторная отправка кода; события
Мои номера	6	Список, обновление, освобождение; маршрутизация SMS / голоса; загрузка документов
Покупка	5	Страны, регионы, города; поиск доступных номеров
Корзина	4	Добавление, удаление, получение, оформление заказа
Валидатор номеров	3	Одиночная и пакетная валидация
SIP-транки	5	Полный CRUD
10DLC	30	Бренды, кампании, верификация, доказательства, подписки на события
Профиль	3	Получение / обновление профиля; конфигурация аккаунта
API-ключи	4	Список, создание, активация / деактивация, удаление
Субаккаунты	5	Список, создание, получение, обновление; транзакции
Биллинг	3	Транзакции, счета, скачивание выписок
Голосовые кампании	2	Запуск и получение
Wavix Embeddable (WebRTC)	5	CRUD токенов виджета
Сокращатель ссылок	2	Создание коротких ссылок; метрики

См. TOOLS.md для полного списка инструментов с однострочными описаниями. Авторитетным источником является спецификация Wavix OpenAPI — ваш клиент всегда видит актуальный живой каталог.

Ресурсы

Помимо инструментов, сервер предоставляет документацию Wavix в виде MCP-ресурсов, чтобы модель могла получать авторитетный контекст по запросу, а не полагаться на прежние знания.

Схема URI	Содержимое
`wavix://docs/<path>`	Страницы документации с docs.wavix.com (автообнаружение через `llms.txt`).
`wavix://api/openapi.yaml`	Полная спецификация Wavix OpenAPI 3.0.

Оба источника — docs.wavix.com и спецификация Wavix OpenAPI — публично доступны, и их можно просматривать напрямую без аутентификации.

Ресурсы загружаются лениво при resources/read и кэшируются на сервере с TTL 1 час. Вышестоящий Bearer-токен никогда не передаётся хостерам документации — только на api.wavix.com.

Аутентификация

Каждый запрос от клиента должен включать:

Authorization: Bearer <api_key>

Сервер передаёт этот заголовок на api.wavix.com в каждом запросе. Токен:

никогда не логируется,
никогда не передаётся при переходах между хостами (например, предварительно подписанные URL для скачивания S3),
никогда не отправляется хостерам документации.

Если ваш клиент переходит по предварительно подписанному URL, возвращённому call_recording_get, billing_invoices_download, speech_analytics_file_get или ten_dlc_brand_evidence_get, загружайте его напрямую без заголовка Authorization.

Если токен скомпрометирован

В консоли Wavix немедленно деактивируйте ключ (или вызовите api_keys_deactivate).
Создайте замену через api_keys_create или консоль.
Обновите конфигурацию клиента и переподключитесь.
Проверьте billing_transactions_list и cdrs_list на предмет неожиданной активности.

Устранение неполадок

Симптом	Вероятная причина / решение
`401 Unauthorized` из любого инструмента	Отсутствует или недействителен заголовок `Authorization: Bearer …`. Проверьте, что API-ключ активен в консоли Wavix.
Инструмент возвращает `download_url`, а не сам файл	Ожидаемо. Конечные точки записей, счетов, речевой аналитики и доказательств 10DLC возвращают предварительно подписанные URL (см. Аутентификация). Получите URL напрямую без заголовка `Authorization`.
Клиент показывает только ~40 инструментов, а не полный каталог	Старые клиенты применяют ограничение на количество инструментов на сервер. Обновите (Cursor 2.4+, последняя версия VS Code, последняя версия Claude).
`Tool not found` для инструмента, указанного в этом README	Локальный клиент может кэшировать старый список инструментов. Перезапустите клиент или удалите и добавьте сервер заново.
4xx с массивом `errors`	Ошибка валидации от API Wavix. Проверьте `errors`; сверьтесь с соответствующей страницей `wavix://docs/*` или спецификацией OpenAPI.
Невозможно подключиться к серверу	Проверьте DNS и исходящий HTTPS к `mcp.wavix.com:443`.
Агент неожиданно вызывает деструктивный инструмент	Большинство клиентов могут требовать подтверждения перед вызовами инструментов — включите эту настройку и перейдите на выделенный MCP API-ключ (см. Лучшие практики).

Совместимость и ограничения

Совместим с любым MCP-клиентом, поддерживающим транспорт Streamable HTTP (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, пользовательские MCP SDK) и любой агентной средой с MCP-адаптером клиента.
Старые клиенты могут применять ограничение на количество инструментов на сервер; обновитесь до последней версии, чтобы получить доступ к полному каталогу.
Лимиты скорости и плата за использование зависят от тарифного плана вашей учетной записи Wavix. См. Цены Wavix.

Журнал изменений

Размещенный сервер обновляется непрерывно по мере развития спецификации Wavix OpenAPI; новые инструменты появляются автоматически, а существующие аргументы инструментов могут получать дополнительные поля. Изменения документации для этого репозитория отслеживаются в Релизах. При существенных изменениях поведения, влияющих на входные данные инструментов или аутентификацию, мы будем публиковать уведомление как там, так и в примечаниях к выпуску Wavix.

Поддержка

Документация по продукту: https://docs.wavix.com
Справочник API: https://docs.wavix.com/api-reference
Вопросы / обратная связь: support@wavix.com

Вклад в проект

Этот репозиторий доступен в исходном коде, но не открыт для внешних вкладов. Запросы на включение автоматически закрываются, а Issues / Discussions отключены. Отправляйте отчеты об ошибках, запросы функций и отзывы на support@wavix.com. Подробности см. в CONTRIBUTING.md.

Если вы обнаружите ошибку в базовом фреймворке FastMCP, сообщите о ней выше по течению.

Безопасность

Чтобы сообщить об уязвимости безопасности, отправьте электронное письмо на support@wavix.com с темой Security: <short summary>, а не открывайте публичный issue. Подробности см. в SECURITY.md.