Xonta MAX
● Activeru.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.
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>"
}
}
}
}claude mcp add --env MAX_BOT_TOKEN='<your MAX_BOT_TOKEN>' --transport stdio max -- uvx xonta-max-mcpcodex mcp add max --env MAX_BOT_TOKEN='<your MAX_BOT_TOKEN>' -- uvx xonta-max-mcpcode --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.
- 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 UTCThe 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 UTCmax_api_reference3 paramsLook 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 parametersHide 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 searchinglangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_endpoint_info3 paramsDetails 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 parametersHide parameters
verbHTTP method: GET, POST, PUT, PATCH, DELETE. Omit to list all endpointspathPath 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 paramAll 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 parametersHide parameters
langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_changelog1 paramDated 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 parametersHide parameters
langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_lint_code2 paramsCheck 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 parametersHide parameters
codestringrequiredSource code of a MAX bot or mini-app (any language), or a config / curl snippetlangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_migrate_from_telegram2 paramsPlan 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 parametersHide parameters
codeTelegram bot source (aiogram, python-telegram-bot, telebot, Telegraf, grammY, raw HTTP…). Omit to get only the method maplangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_scaffold_bot2 paramsGenerate 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 parametersHide 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 paramsValidate 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 parametersHide parameters
bodyobjectrequiredNewMessageBody JSON: {text, format, attachments, link, notify}targetstringmessage — POST /messages, comment — POST /messages/{id}/commentschat_typeWhere it goes, for channel-specific ruleslangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_build_message9 paramsBuild 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 parametersHide parameters
textMessage text, up to 4000 charactersformatText markupbuttonsRows 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 uploadingreply_to_midReply to this message idchat_idFor the curl exampleuser_idFor the curl example, private dialogdisable_link_previewbooleanlangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_split_text3 paramsSplit text into MAX messages of at most 4000 characters, cutting at paragraphs, lines or sentences.
Show parametersHide parameters
textstringrequiredLong text to sendlimitintegerMax characters per messagelangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_convert_formatting4 paramsConvert 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 parametersHide parameters
textstringrequiredFormatted textsourcestringrequiredWhere the text comes from; 'markdown' = ordinary Markdown (e.g. LLM output)targetstringMAX format to producelangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_deeplink7 paramsBuild 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 parametersHide parameters
kindstringrequiredstart — open bot with payload; startapp — open mini-app; share — 'send to MAX' link for any site, no bot needed; mention — user mention markupbot_nameBot public name as in max.ru/<name> (start, startapp)payloadstart: ≤128 chars; startapp: ≤512, A-Za-z0-9_- onlytextshare: text to prefill; mention: display nameuser_idmention: MAX user idbutton_labelshare: label for the generated HTML button; default depends on langlangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_mock_update9 paramsGenerate 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 parametersHide parameters
update_typestringrequiredmessage_created, message_callback, bot_started, bot_added, bot_removed, message_edited, message_removed, user_added, user_removed, comment_created, chat_title_ctextMessage text (message_created/edited, comments) or new titlepayloadCallback payload or bot_started deep link payloadchat_typestringWhere it happenschat_idChat id; default is generatedoverridesDeep-merge into the generated updatewebhook_urlIf set, also returns a curl command that POSTs the update theresecretWebhook secret to put into X-Max-Bot-Api-SecretlangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_mock_init_data7 paramsProduce 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 parametersHide parameters
test_bot_tokenA TEST token to sign with. Omit to generate a random one. Never pass a production token to a hosted serveruser_idintegerfirst_namechat_typestringWhere the mini-app was openedstart_paramValue from ?startapp=age_secondsintegerMake auth_date this many seconds old, to test expirylangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_bridge_mock8 paramsGenerate 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 parametersHide parameters
platformstringPlatform to emulate: limits which Bridge features workstart_paramEmulated ?startapp= valuetest_bot_tokenTEST token: initData and requestContact hash will be validly signed with ituser_idintegerfirst_namephonestringentry_pointstringlangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_check_webhook_secret2 paramsCheck a MAX webhook secret against the rules (5-256 chars, A-Z a-z 0-9 _ -) or generate a strong one.
Show parametersHide parameters
secretSecret to check; omit to generate a new onelangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
server_status1 paramServer version, facts date, mode (hosted or local), languages and whether operator tools are active.
Show parametersHide parameters
langAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_tracking_links8 paramsMake 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 parametersHide parameters
campaignstringrequiredCampaign name, e.g. 'black friday'placementsarrayrequiredChannels where the ad goes: [{name, cost?, erid?}]. name may be a title or max.ru linkbot_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 eridutm_mediumstringpromo_codesbooleanAlso make one promo code per placementlangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_ad_report5 paramsCompare 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 parametersHide 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 idcampaignOnly count payloads of this campaignmin_ordersintegerBelow this many orders a placement is flagged as low datalangAnswer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
max_check_ad_post6 paramsCheck 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 parametersHide parameters
textstringrequiredAd post text as it will be publishedlinksLinks used in buttons or elsewhere, if not in the textchannel_subscribersSubscribers of the channel where it goeschannel_has_a_plusWhether the channel has the A+ mark (RKN registry)advertiser_siteSite with the advertiser's details, if they are not in the textlangAnswer 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-http
https://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.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Inbox Zero | 13,026 | Nov 2026 | Needs sign-in |
| Agent-Native Brain | 7,707 | Nov 2026 | Needs sign-in |
| Agent-Native Chat | 7,707 | Nov 2026 | Needs sign-in |
| Agent-Native Dispatch | 7,707 | Nov 2026 | Needs sign-in |
| Agent-Native Mail | 7,707 | Nov 2026 | Needs 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.
More Communication servers
Browse all Communication →Shaka
leocode09
Company email for Rwanda. Read and send mail from a Shaka mailbox over OAuth or an API key.
Bullpen
GreatPyreneseDad
AI sales team that works the phone: gets a real person on the line. Agents sign up by paying (MPP).
glim.sh
glim-sh
Give your agent live data from Twitter, Reddit, the web and GitHub. No API keys, no scraping stack.
Grabbit MCP
grabbit-sh
Find high-intent Reddit conversations and manage lead workflows from MCP-compatible AI agents.
Nextmail
nextmailhq
AI-native email for businesses, developers, and AI agents.
OpenMail
openmailsh
Gmail for agents: create inboxes, read and reply to mail, send email, manage domains. OAuth sign-in.
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.
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
[](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.