M
mrsergeiluzhnov/xonta-max-mcp
MCP server for building bots and mini-apps for the MAX messenger (max.ru), in English and Russian.
updated 2026-11-16
View on GitHub ↗Direct link · no redirect page
We have neither an install command nor a public remote endpoint from this repository, so we do not print a config. A made-up one is worse than none. How each client wires MCP up →
- Star count
- 0 ★ · mrsergeiluzhnov/xonta-max-mcp · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 3 sources
- Score
- score 300 · 3 sources · mcp
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: MCP servers. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
mrsergeiluzhnov/xonta-max-mcp;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# Xonta MAX
Excerpted from the repository README (abridged)
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 XONTA_MAX_LANG=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 (max_scaffold_bot) come with comments, README and replies in the chosen language.
## Tools
| Tool | What it does |
| max_api_reference | Current Bot API and Mini Apps facts by topic or free-text search, each with a dev.max.ru link |
| max_endpoint_info | One method: query, body, limits, gotchas, curl. Says when a method was removed |
| max_limits | Every limit in one place: text, rate, keyboard, attachments, files, deep links, webhook |
| max_changelog | Dated 2026 changes that break old code |
| max_lint_code | Finds old host, token in query, Bearer, disabled TLS, removed methods, webhook mistakes, unsafe secret compare, wrong initData HMAC, Telegram leftovers. Line numbers and fixes |
| max_migrate_from_telegram | Maps every Telegram API call in your code to MAX, lists what has no equivalent, gives a plan |
| max_scaffold_bot | Ready bot in Python, TypeScript or Go: polling + webhook, certificate in Dockerfile, chat tracking, callbacks |
| max_build_message | Message JSON with keyboard and images, validated, plus curl |
| max_validate_message | Checks a body: 4000 chars, 210/30/7 keyboard, 3 per row for link/open_app, attachment combinations |
| max_split_text | Splits long text into ≤4000-char messages at paragraph boundaries |
| max_convert_formatting | Telegram MarkdownV2/HTML or LLM Markdown → MAX markup, reports what MAX can't show |
| max_deeplink | ?start=, ?startapp=, mention, and a "Send to MAX" share link and button for any website, no bot needed |
| max_mock_update | Realistic webhook updates for all 19 types, plus curl to your local endpoint |
| max_mock_init_data | Correctly signed mini-app initData for backend tests |
| max_bridge_mock | window.WebApp emulator to build mini-apps in a normal browser on localhost |
| max_check_webhook_secret | Checks or generates a webhook secret |
| max_tracking_links | Ads: a separate bot link (?start=), mini-app link, UTM link and promo code for every channel where you place an ad, plus a media plan CSV |
| max_ad_report | Ads: CPM, cost per click or bot start, per lead and per order, ROAS, ROMI, with 95% intervals — says when a difference between channels may be chance |
| max_check_ad_post | Ads: checks a post against Russian ad marking rules: the «Реклама» label, advertiser details, erid token, A+ mark for big channels |
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 XONTA_MAX_LANG=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 (max_scaffold_bot) come with comments, README and replies in the chosen language.
## Tools
| Tool | What it does |
| max_api_reference | Current Bot API and Mini Apps facts by topic or free-text search, each with a dev.max.ru link |
| max_endpoint_info | One method: query, body, limits, gotchas, curl. Says when a method was removed |
| max_limits | Every limit in one place: text, rate, keyboard, attachments, files, deep links, webhook |
| max_changelog | Dated 2026 changes that break old code |
| max_lint_code | Finds old host, token in query, Bearer, disabled TLS, removed methods, webhook mistakes, unsafe secret compare, wrong initData HMAC, Telegram leftovers. Line numbers and fixes |
| max_migrate_from_telegram | Maps every Telegram API call in your code to MAX, lists what has no equivalent, gives a plan |
| max_scaffold_bot | Ready bot in Python, TypeScript or Go: polling + webhook, certificate in Dockerfile, chat tracking, callbacks |
| max_build_message | Message JSON with keyboard and images, validated, plus curl |
| max_validate_message | Checks a body: 4000 chars, 210/30/7 keyboard, 3 per row for link/open_app, attachment combinations |
| max_split_text | Splits long text into ≤4000-char messages at paragraph boundaries |
| max_convert_formatting | Telegram MarkdownV2/HTML or LLM Markdown → MAX markup, reports what MAX can't show |
| max_deeplink | ?start=, ?startapp=, mention, and a "Send to MAX" share link and button for any website, no bot needed |
| max_mock_update | Realistic webhook updates for all 19 types, plus curl to your local endpoint |
| max_mock_init_data | Correctly signed mini-app initData for backend tests |
| max_bridge_mock | window.WebApp emulator to build mini-apps in a normal browser on localhost |
| max_check_webhook_secret | Checks or generates a webhook secret |
| max_tracking_links | Ads: a separate bot link (?start=), mini-app link, UTM link and promo code for every channel where you place an ad, plus a media plan CSV |
| max_ad_report | Ads: CPM, cost per click or bot start, per lead and per order, ROAS, ROMI, with 95% intervals — says when a difference between channels may be chance |
| max_check_ad_post | Ads: checks a post against Russian ad marking rules: the «Реклама» label, advertiser details, erid token, A+ mark for big channels |
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/mrsergeiluzhnov-xonta-max-mcp/)
- Source
- awesome · https://github.com/mrsergeiluzhnov/xonta-max-mcp
- Browse by field
- MCP servers
- Listed by
- 3 independent sources
- added
- today
More MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.