Xonta MAX
Server Details
MAX messenger bots and mini-apps in English or Russian: Bot API, code checks, Telegram migration
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- mrsergeiluzhnov/xonta-max-mcp
- GitHub Stars
- 0
- Server Listing
- xonta-max-mcp
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 20 tools
Most tools are cleanly separated by task (validate vs build vs convert vs lint vs mock vs scaffold). The main soft overlap is among the reference tools — max_api_reference, max_endpoint_info, max_limits, and max_changelog all answer 'what are the facts' questions, though their granularity differs (topics, single method, limits table, dated changes). Mock tools (max_bridge_mock, max_mock_init_data, max_mock_update) are distinct artifacts but could be momentarily confused by an agent scanning names.
All 20 tools use the max_ prefix and snake_case, which is highly predictable. However, half are verb_noun (max_build_message, max_lint_code, max_split_text) while the reference-oriented ones are noun-only (max_api_reference, max_changelog, max_limits, max_endpoint_info, max_deeplink), so the action is not always encoded in the name.
20 tools is on the heavy side but justifiable given the breadth of the MAX platform surface (docs, codegen, validation, mocking, migration, ads analytics, meta). Each tool appears to own a distinct artifact or lookup, and nothing is obviously redundant. It sits at the upper edge of 'comfortable' rather than being bloated.
The surface covers the full developer lifecycle for MAX bots and mini-apps: reference docs, limits, changelog, scaffolding, message building/validation, text splitting, formatting conversion, deep links, webhook secrets, mocks, linting, migration, and ad tracking/analytics. Gaps are minor — e.g. no live API invocation or token/auth validation tool (it is explicitly a calculator/reference server), and error-code lookup is folded into max_limits rather than being its own surface.
Available Tools
20 toolsmax_ad_reportARead-onlyIdempotentInspect
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.
Inputs: placements (required), lang, events, campaign, +1 more.
max_api_referenceARead-onlyIdempotentInspect
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.
Inputs: lang, query, topic.
max_bridge_mockARead-onlyInspect
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.Inputs: lang, phone, user_id, platform, +4 more.
max_build_messageARead-onlyIdempotentInspect
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.
Inputs: lang, text, format, buttons, +5 more.
max_changelogARead-onlyIdempotentInspect
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.
Inputs: lang.
max_check_ad_postARead-onlyIdempotentInspect
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.
Inputs: text (required), lang, links, advertiser_site, +2 more.
max_check_webhook_secretARead-onlyIdempotentInspect
Check a MAX webhook secret against the rules (5-256 chars, A-Z a-z 0-9 _ -) or generate a strong one.
Inputs: lang, secret.
max_convert_formattingARead-onlyIdempotentInspect
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.
Inputs: text (required), source (required), lang, target.
max_deeplinkARead-onlyIdempotentInspect
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.
Inputs: kind (required), lang, text, payload, +3 more.
max_endpoint_infoARead-onlyIdempotentInspect
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).
Inputs: lang, path, verb.
max_limitsARead-onlyIdempotentInspect
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.
Inputs: lang.
max_lint_codeARead-onlyIdempotentInspect
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.
Inputs: code (required), lang.
max_migrate_from_telegramARead-onlyIdempotentInspect
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.
Inputs: code, lang.
max_mock_init_dataARead-onlyInspect
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.
Inputs: lang, user_id, chat_type, first_name, +3 more.
max_mock_updateARead-onlyInspect
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.
Inputs: update_type (required), lang, text, secret, +5 more.
max_scaffold_botARead-onlyInspect
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.
Inputs: lang, language.
max_split_textBRead-onlyIdempotentInspect
Split text into MAX messages of at most 4000 characters, cutting at paragraphs, lines or sentences.
Inputs: text (required), lang, limit.
max_tracking_linksARead-onlyIdempotentInspect
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=: 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.
Inputs: campaign (required), placements (required), lang, bot_name, +4 more.
max_validate_messageARead-onlyIdempotentInspect
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.
Inputs: body (required), lang, target, chat_type.
server_statusBRead-onlyIdempotentInspect
Server version, facts date, mode (hosted or local), languages and whether operator tools are active.
Inputs: lang.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Cross-posting between Telegram, MAX and VK: routes, copy rules, history import, chatbots.
Multi-tenant Telegram gateway for AI agents — HTTP+stdio, 8 tools, MTProto User API
Manage WhatsApp, Telegram and MAX mailings: audiences, drafts, moderation and sending.
Russian APIs for AI agents: YooKassa, CDEK, Bitrix24 and more. Ready scenarios with code. No key.
Related MCP Servers
- FlicenseAqualityDmaintenanceAn MCP server for MAX Messenger (Russia's national messenger by VK) that enables AI clients to send and read messages, manage chats and members, send media, and more through 21 tools.2180 npm12-
- AlicenseNot gradedqualityBmaintenanceEnables ChatGPT, Claude, Cursor, and other MCP clients to access a personal MAX account to read and search chats, receive live updates, manage groups, channels, contacts, and profile settings, and send messages, files, polls, and reactions with OAuth/QR login and configurable safeguards.1MIT

jetapi-mcp-serverofficial
AlicenseAqualityBmaintenanceOfficial JetAPI MCP server for sending WhatsApp, Telegram (personal account or bot), SMS, VK/OK and MAX messages and files from AI agents. Supports channel cascades, scheduling, bulk mailings, delivery status tracking, phone number lookup and webhook management.1468 npmMIT- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access a self-hosted MAX messenger personal account: browse chats, read and search message history, inspect context, pins and forwarded text, download attachments, and send text or files with receipts and retry protection. Also supports durable batch state for scheduled workflows, with local authentication and access control over Streamable HTTP.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.