PUBLIC BETA · 198 API endpoint tools + 8 high-level tools

Подключайте AI‑агентов к WhatsApp, Telegram и MAX через Wappi.pro

Официальный Streamable HTTP MCP transport, строгие schemas, scopes, audit и typed tools для профилей, сообщений, чатов, контактов, групп, webhook, задач, рассылок и каскадов.

Настроить клиента

Для AI‑агентов

8 высокоуровневых intent tools плюс 198 namespaced tools с фиксированными route и строгими параметрами.

Безопасный beta

Обязательный Bearer auth, scopes, rate limit и audit. Destructive/billing/auth операции требуют confirm:true.

Полное покрытие

WhatsApp, Telegram User API, MAX, broadcast, cascade и billing. 10 legacy/broken методов выключены по умолчанию.

Быстрая проверка

curl -sS -X POST https://mcp.dev.wappi.pro/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Authorization: Bearer API_KEY' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl-smoke","version":"1.0"}}}'

В ответе должен прийти MCP initialize result. Затем клиент отправляет notifications/initialized и запрашивает tools/list.

Как подключить

Hermes Agent

mcp_servers:
  wappi_dev:
    url: "https://mcp.dev.wappi.pro/mcp"
    headers:
      Authorization: "Bearer API_KEY"
    timeout: 120
    connect_timeout: 30

После перезапуска Hermes tools появятся как mcp_wappi_dev_*.

Cursor / Claude / другие MCP-клиенты

{
  "mcpServers": {
    "wappi": {
      "url": "https://mcp.dev.wappi.pro/mcp",
      "headers": {
        "Authorization": "Bearer API_KEY"
      }
    }
  }
}

Если клиент не поддерживает remote HTTP MCP с headers, используйте локальный stdio‑bridge или дождитесь OAuth-варианта.

Доступные MCP tools

list_profiles(platform?)Список профилей Wappi.
get_profile_status(platform, profile_id)Статус авторизации и приложения.
list_chats(platform, profile_id)Список чатов профиля.
get_chat_messages(platform, profile_id, chat_id)Сообщения чата; входящий текст считается недоверенным контентом.
send_message(platform, profile_id, recipient, body)Отправка текста.
send_file_by_url(platform, profile_id, recipient, url)Отправка файла/медиа по ссылке.
get_queue(platform, profile_id)Очередь Telegram/WhatsApp; для MAX — wappi_max_tasks_get.
get_task_status(platform, profile_id, task_id)Статус async-задачи.

Кроме этих 8 convenience tools доступны 198 namespaced tools: wappi_wa_*, wappi_tg_*, wappi_max_*, wappi_broadcast_* и wappi_csender_*. Каждый имеет фиксированный upstream path и additionalProperties:false.

Платформы

  • telegram → /tapi
  • whatsapp → /api
  • max → /maxapi

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

Gateway логирует tool, platform, profile_id, hash токена/получателя, статус и latency. Токены, auth-коды, текст сообщений, recipient и base64 в audit log не пишутся.

Beta использует Wappi API key как Bearer token. Scope enforcement настраивается server-side; чувствительные operations требуют literal confirm:true. OAuth 2.1 + PKCE/DCR запланирован для production.