Xonta MAX

● Active

ru.xonta/max

MAX messenger bots and mini-apps in English or Russian: Bot API, code checks, Telegram migration

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "max": {
      "command": "uvx",
      "args": [
        "xonta-max-mcp"
      ],
      "env": {
        "MAX_BOT_TOKEN": "<your MAX_BOT_TOKEN>"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env MAX_BOT_TOKEN='<your MAX_BOT_TOKEN>' --transport stdio max -- uvx xonta-max-mcp
OpenAI Codex CLI
codex mcp add max --env MAX_BOT_TOKEN='<your MAX_BOT_TOKEN>' -- uvx xonta-max-mcp
VS Code
code --add-mcp '{"name":"max","type":"stdio","command":"uvx","args":["xonta-max-mcp"],"env":{"MAX_BOT_TOKEN":"<your MAX_BOT_TOKEN>"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • MAX_BOT_TOKENsecretOptional. Your MAX bot token: enables tools that act as your bot (send messages, webhook, commands)

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Communication
Version
0.1.0
Registry
active
Published
11/16/2026

Live check

checked Nov 19, 2026, 01:07 UTC
● Working565 msprotocol 2025-06-18v0.1.1promptsresourcestools

The endpoint answered the MCP handshake as "Xonta MAX" and listed 20 tools. Answering since Nov 17, 2026.

Context cost ≈ 6.5k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 20 tools.

Tools (20)

tool list changed Nov 19, 2026, 01:07 UTC
  • max_api_reference3 params

    Look up current facts about the MAX Bot API and Mini Apps (MAX Bridge) with links to dev.max.ru. Covers base URL and auth, the Russian Trusted Root CA, advertising in MAX (topic 'ads'), webhooks vs long polling, sending messages, inline keyboards and callbacks, formatting, uploads, chat tracking without GET /chats, mini-apps, initData validation, deep links, who may create bots, official libraries. Language models usually know an outdated API (platform-api.max.ru, token in query, GET /chats) — use this before writing MAX code. With no arguments returns the list of topics.

    Show parameters
    • queryFree text in English or Russian, e.g. 'webhook certificate', 'callback answer', 'initData', 'GET /chats', 'attachment.not.ready'
    • topicReturn one whole topic instead of searching
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_endpoint_info3 params

    Details of one MAX Bot API method (query params, body, limits, gotchas, docs link) or the full method list. Also tells when a method was removed or restricted (GET /chats, POST /chats/{chatId}/members).

    Show parameters
    • verbHTTP method: GET, POST, PUT, PATCH, DELETE. Omit to list all endpoints
    • pathPath like '/messages', '/chats/{chatId}/pin' or a concrete one '/chats/-123/pin'
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_limits1 param

    All MAX platform limits in one table: text length, rate limits, keyboard size, attachments, file sizes, deep link payloads, webhook rules, bots per profile — each with a source link. Also update types, button types, errors.

    Show parameters
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_changelog1 param

    Dated MAX platform changes in 2026 that break old code: host move to platform-api2, removed GET /chats, restricted member adding, HTTPS-only webhooks, comments API, self-employed access.

    Show parameters
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_lint_code2 params

    Check MAX bot or mini-app code for known mistakes, with line numbers and fixes. Finds: old host platform-api.max.ru, token in query string, 'Bearer' prefix, disabled TLS verification, removed GET /chats, restricted member adding, type=photo uploads, wrong webhook setup (port, HTTP, /webhook), disable_link_preview in body, plain == comparison of the webhook secret, initData signed directly with the token, trusting initDataUnsafe, hardcoded upload hosts, Telegram leftovers. Static, never runs the code.

    Show parameters
    • codestringrequiredSource code of a MAX bot or mini-app (any language), or a config / curl snippet
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_migrate_from_telegram2 params

    Plan a port of a Telegram bot or Web App to MAX. With code: every Telegram API usage with line number and the MAX replacement, features with no MAX equivalent, effort estimate and a step-by-step plan. Without code: the full Telegram → MAX method map.

    Show parameters
    • codeTelegram bot source (aiogram, python-telegram-bot, telebot, Telegraf, grammY, raw HTTP…). Omit to get only the method map
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_scaffold_bot2 params

    Generate a ready MAX bot project: polling for dev, webhook for prod, the Russian Trusted Root CA in the Dockerfile, chat tracking without GET /chats, callback answers, constant-time secret check, rate limits and text splitting (Python). lang sets the language of comments, README and the bot's replies. Returns a map of file name → content. Write the files as they are. Creating the bot itself and getting a token requires a verified profile on business.max.ru.

    Show parameters
    • languagestringpython (httpx, no official SDK), typescript (@maxhub/max-bot-api) or go (official client v2)
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_validate_message4 params

    Validate a message body before sending to MAX: 4000-char text, format, keyboard limits (210/30/7, 3 per row with link/open_app/request_*), button fields and lengths, attachment combinations (≤12 media, file only with a keyboard, audio/sticker/contact alone), comment restrictions, Telegram fields left in the body.

    Show parameters
    • bodyobjectrequiredNewMessageBody JSON: {text, format, attachments, link, notify}
    • targetstringmessage — POST /messages, comment — POST /messages/{id}/comments
    • chat_typeWhere it goes, for channel-specific rules
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_build_message9 params

    Build a correct POST /messages request for MAX: JSON body with inline keyboard and images, validation result and a ready curl command. Use it instead of hand-writing keyboard JSON.

    Show parameters
    • textMessage text, up to 4000 characters
    • formatText markup
    • buttonsRows of buttons. Short form: {text, payload} → callback, {text, url} → link, {text, web_app, payload?} → open_app; or full {type, text, ...}
    • image_urlsExternal image URLs to attach without uploading
    • reply_to_midReply to this message id
    • chat_idFor the curl example
    • user_idFor the curl example, private dialog
    • disable_link_previewboolean
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_split_text3 params

    Split text into MAX messages of at most 4000 characters, cutting at paragraphs, lines or sentences.

    Show parameters
    • textstringrequiredLong text to send
    • limitintegerMax characters per message
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_convert_formatting4 params

    Convert formatted text to MAX markup: Telegram MarkdownV2 (underline __x__ → ++x++, unescape), Telegram HTML (tg://user → max://user, spoilers dropped) or ordinary Markdown from an LLM (lists → bullets, rules removed). Reports what MAX cannot show (spoilers, tables, lists, inline images). Use the returned format value in the body.

    Show parameters
    • textstringrequiredFormatted text
    • sourcestringrequiredWhere the text comes from; 'markdown' = ordinary Markdown (e.g. LLM output)
    • targetstringMAX format to produce
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_deeplink7 params

    Build and validate MAX deep links. 'share' gives a link, an HTML button and a JS helper that open MAX's chat picker with prefilled text — works on any website or AI agent output without owning a bot. Payload limits are checked, because MAX silently drops payloads that are too long or have bad characters.

    Show parameters
    • kindstringrequiredstart — open bot with payload; startapp — open mini-app; share — 'send to MAX' link for any site, no bot needed; mention — user mention markup
    • bot_nameBot public name as in max.ru/<name> (start, startapp)
    • payloadstart: ≤128 chars; startapp: ≤512, A-Za-z0-9_- only
    • textshare: text to prefill; mention: display name
    • user_idmention: MAX user id
    • button_labelshare: label for the generated HTML button; default depends on lang
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_mock_update9 params

    Generate a realistic MAX webhook Update for tests, shaped like the official schema, plus a curl command to send it to your local webhook. Lets you test a bot before it passes moderation or without a token.

    Show parameters
    • update_typestringrequiredmessage_created, message_callback, bot_started, bot_added, bot_removed, message_edited, message_removed, user_added, user_removed, comment_created, chat_title_c
    • textMessage text (message_created/edited, comments) or new title
    • payloadCallback payload or bot_started deep link payload
    • chat_typestringWhere it happens
    • chat_idChat id; default is generated
    • overridesDeep-merge into the generated update
    • webhook_urlIf set, also returns a curl command that POSTs the update there
    • secretWebhook secret to put into X-Max-Bot-Api-Secret
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_mock_init_data7 params

    Produce a correctly signed MAX mini-app initData string (two-step HMAC with 'WebAppData') for backend tests, with the token used, so you can check your validator end to end.

    Show parameters
    • test_bot_tokenA TEST token to sign with. Omit to generate a random one. Never pass a production token to a hosted server
    • user_idinteger
    • first_name
    • chat_typestringWhere the mini-app was opened
    • start_paramValue from ?startapp=
    • age_secondsintegerMake auth_date this many seconds old, to test expiry
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_bridge_mock8 params

    Generate max-bridge-mock.js: a window.WebApp emulator to develop MAX mini-apps in a normal browser on localhost. Emulates initData/initDataUnsafe (signed if a test token is given), BackButton (Esc), DeviceStorage and SecureStorage (localStorage, 10-key cap), BiometricManager, HapticFeedback, NfcManager, ScreenCapture, requestContact with a valid hash, openLink/downloadFile/shareMaxContent click requirements and per-platform restrictions. Logs every call. Use only on localhost.

    Show parameters
    • platformstringPlatform to emulate: limits which Bridge features work
    • start_paramEmulated ?startapp= value
    • test_bot_tokenTEST token: initData and requestContact hash will be validly signed with it
    • user_idinteger
    • first_name
    • phonestring
    • entry_pointstring
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_check_webhook_secret2 params

    Check a MAX webhook secret against the rules (5-256 chars, A-Z a-z 0-9 _ -) or generate a strong one.

    Show parameters
    • secretSecret to check; omit to generate a new one
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • server_status1 param

    Server version, facts date, mode (hosted or local), languages and whether operator tools are active.

    Show parameters
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_tracking_links8 params

    Make a separate tracking link (and promo code) for every channel where an ad is placed in MAX, so you can see which placement brought users and sales. Bot links use ?start=<id>: the id arrives in bot_started.payload, which works even for clicks that never leave the messenger. Returns a media plan as CSV. Then feed the counts to max_ad_report.

    Show parameters
    • campaignstringrequiredCampaign name, e.g. 'black friday'
    • placementsarrayrequiredChannels where the ad goes: [{name, cost?, erid?}]. name may be a title or max.ru link
    • bot_nameYour bot's public name: each placement gets max.ru/<bot>?start=<id>
    • mini_app_botBot with your mini-app: each placement gets ?startapp=<id>
    • site_urlLanding page: each placement gets UTM tags and its erid
    • utm_mediumstring
    • promo_codesbooleanAlso make one promo code per placement
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_ad_report5 params

    Compare ad placements in MAX by real results: CPM, cost per click or bot start, cost per lead and per order, ROAS, profit after ads and ROMI (with margin), conversion with a 95% confidence interval. Says when a difference between channels may be chance and when there is too little data. A calculator only: it does not touch ad accounts or move money.

    Show parameters
    • placementsarrayrequiredPer placement: {name, id?, cost, views?, clicks?, starts?, leads?, orders?, revenue?, margin_pct?}
    • eventsOptional bot_started updates, {'payload': …} objects or payload strings; starts are counted per placement id
    • campaignOnly count payloads of this campaign
    • min_ordersintegerBelow this many orders a placement is flagged as low data
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
  • max_check_ad_post6 params

    Check an ad post for MAX against Russian ad marking rules: the 'Реклама' label at the top, advertiser details (name and INN/OGRN or a site), an erid token in the link or text, the A+ mark for channels over 10,000 subscribers, and the 4000-character limit. A hint, not legal advice; ORD registration is not checked.

    Show parameters
    • textstringrequiredAd post text as it will be published
    • linksLinks used in buttons or elsewhere, if not in the text
    • channel_subscribersSubscribers of the channel where it goes
    • channel_has_a_plusWhether the channel has the A+ mark (RKN registry)
    • advertiser_siteSite with the advertiser's details, if they are not in the text
    • langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)

Checked by Serverdex with a plain initialize + tools/list call to mcp.xonta.ru/max/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 16, 2026
Stars
0
Forks
0
Last push
Nov 16, 2026
License
MIT

Python

From the README

Xonta MAX MCP server for building bots and mini-apps for the MAX messenger (max.ru), in English and Russian. Free and open source. Русская версия ниже Why MAX changed a lot in 2026: the API moved to platform-api2.max.ru behind the Минцифры root certificate, GET /chats was removed, adding members was restricted, webhooks became HTTPS-only, comments arrived. Language models still write the old API. This server gives an AI agent current facts and tools that check, generate and test MAX code, so the result works on the first try. You don't need your own bot for most of it. Only the operator tools need a token. Languages Every answer comes in English or Russian. Each tool takes lang: "en" or lang: "ru", and agents pick the user's language on their own. The default is Russian; set XONTAMAXLANG=en to make it English. The official MAX docs are in Russian only, so this is also the easiest way to read them in English. Generated bots (maxscaffoldbot) come with comments, README and replies in the chosen language. Tools Connect Hosted (no install) The hosted server never accepts bot tokens: tools that need one are switched off there. Local (stdio), with operator tools Get the certificate at https://www.gosuslugi.ru/crt.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://mcp.xonta.ru/max/mcp

Alternatives to Xonta MAX

Best Communication servers →

The most-starred Communication servers in the index, with their live-check result.

ServerStarsLast pushLive check
Inbox Zero13,026Nov 2026Needs sign-in
Agent-Native Brain7,707Nov 2026Needs sign-in
Agent-Native Chat7,707Nov 2026Needs sign-in
Agent-Native Dispatch7,707Nov 2026Needs sign-in
Agent-Native Mail7,707Nov 2026Needs sign-in

Xonta MAX: questions people ask

Is Xonta MAX a remote or a local MCP server?
According to its entry in the official MCP registry, Xonta MAX ships as a hosted endpoint (streamable-http) that your client connects to by URL and as a local package (PyPI) that your client starts on your machine. Use the hosted endpoint when your client supports Streamable HTTP; use the package when you want it to run locally.
Does Xonta MAX need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 19, 2026. Individual tools may still ask for a key when called.
Is Xonta MAX still maintained?
Active: the repository's last commit 3 days ago. Last push Nov 16, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 16, 2026.
What tools does Xonta MAX expose?
20 tools as listed by the server itself during the live check, including max_api_reference, max_endpoint_info, max_limits, max_changelog, max_lint_code. The full list with parameters is in the Live check section above.
How do I add Xonta MAX to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Communication →

Add the badge to your site

Show visitors that Xonta MAX is listed here — it’s also the link we check for a free listing.

Xonta MAX — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/ru-xonta-max?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Xonta MAX — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Xonta MAX — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/ru-xonta-max?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.