MAX messenger bots and mini-apps in English or Russian: Bot API, code checks, Telegram migration
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Per placement: {name, id?, cost, views?, clicks?, starts?, leads?, orders?, revenue?, margin_pct?}
Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)
Optional bot_started updates, {'payload': …} objects or payload strings; starts are counted per placement id
Only count payloads of this campaign
Below this many orders a placement is flagged as low data
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http max https://mcp.xonta.ru/max/mcp
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.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| events | any | Optional bot_started updates, {'payload': …} objects or payload strings; starts are counted per placement id |
| campaign | any | Only count payloads of this campaign |
| min_orders | integer | Below this many orders a placement is flagged as low data |
| placements* | array | Per placement: {name, id?, cost, views?, clicks?, starts?, leads?, orders?, revenue?, margin_pct?} |
{
"type": "object",
"title": "max_ad_reportArguments",
"required": [
"placements"
],
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"events": {
"anyOf": [
{
"type": "array",
"items": {}
},
{
"type": "null"
}
],
"title": "Events",
"default": null,
"description": "Optional bot_started updates, {'payload': …} objects or payload strings; starts are counted per placement id"
},
"campaign": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Campaign",
"default": null,
"description": "Only count payloads of this campaign"
},
"min_orders": {
"type": "integer",
"title": "Min Orders",
"default": 5,
"minimum": 1,
"description": "Below this many orders a placement is flagged as low data"
},
"placements": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Placements",
"description": "Per placement: {name, id?, cost, views?, clicks?, starts?, leads?, orders?, revenue?, margin_pct?}"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| query | any | Free text in English or Russian, e.g. 'webhook certificate', 'callback answer', 'initData', 'GET /chats', 'attachment.not.ready' |
| topic | any | Return one whole topic instead of searching |
{
"type": "object",
"title": "max_api_referenceArguments",
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Query",
"default": null,
"description": "Free text in English or Russian, e.g. 'webhook certificate', 'callback answer', 'initData', 'GET /chats', 'attachment.not.ready'"
},
"topic": {
"anyOf": [
{
"enum": [
"auth",
"tls",
"webhook",
"messages",
"keyboard",
"formatting",
"uploads",
"chats",
"mini_apps",
"init_data",
"deeplinks",
"access",
"libraries",
"ads",
"sources"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Topic",
"default": null,
"description": "Return one whole topic instead of searching"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| phone | string | |
| user_id | integer | |
| platform | string | Platform to emulate: limits which Bridge features work |
| first_name | any | |
| entry_point | string | |
| start_param | any | Emulated ?startapp= value |
| test_bot_token | any | TEST token: initData and requestContact hash will be validly signed with it |
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.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| text | any | Message text, up to 4000 characters |
| format | any | Text markup |
| buttons | any | Rows of buttons. Short form: {text, payload} → callback, {text, url} → link, {text, web_app, payload?} → open_app; or full {type, text, ...} |
| chat_id | any | For the curl example |
| user_id | any | For the curl example, private dialog |
| image_urls | any | External image URLs to attach without uploading |
| reply_to_mid | any | Reply to this message id |
| disable_link_preview | boolean |
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.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
{
"type": "object",
"title": "max_changelogArguments",
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| text* | string | Ad post text as it will be published |
| links | any | Links used in buttons or elsewhere, if not in the text |
| advertiser_site | any | Site with the advertiser's details, if they are not in the text |
| channel_has_a_plus | any | Whether the channel has the A+ mark (RKN registry) |
| channel_subscribers | any | Subscribers of the channel where it goes |
{
"type": "object",
"title": "max_check_ad_postArguments",
"required": [
"text"
],
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"text": {
"type": "string",
"title": "Text",
"description": "Ad post text as it will be published"
},
"links": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Links",
"default": null,
"description": "Links used in buttons or elsewhere, if not in the text"
},
"advertiser_site": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Advertiser Site",
"default": null,
"description": "Site with the advertiser's details, if they are not in the text"
},
"channel_has_a_plus": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Channel Has A Plus",
"default": null,
"description": "Whether the channel has the A+ mark (RKN registry)"
},
"channel_subscribers": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Channel Subscribers",
"default": null,
"description": "Subscribers of the channel where it goes"
}
}
}Check a MAX webhook secret against the rules (5-256 chars, A-Z a-z 0-9 _ -) or generate a strong one.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| secret | any | Secret to check; omit to generate a new one |
{
"type": "object",
"title": "max_check_webhook_secretArguments",
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"secret": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Secret",
"default": null,
"description": "Secret to check; omit to generate a new one"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| text* | string | Formatted text |
| source* | string | Where the text comes from; 'markdown' = ordinary Markdown (e.g. LLM output) |
| target | string | MAX format to produce |
{
"type": "object",
"title": "max_convert_formattingArguments",
"required": [
"text",
"source"
],
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"text": {
"type": "string",
"title": "Text",
"description": "Formatted text"
},
"source": {
"enum": [
"telegram_markdownv2",
"telegram_html",
"markdown"
],
"type": "string",
"title": "Source",
"description": "Where the text comes from; 'markdown' = ordinary Markdown (e.g. LLM output)"
},
"target": {
"enum": [
"max_markdown",
"max_html"
],
"type": "string",
"title": "Target",
"default": "max_markdown",
"description": "MAX format to produce"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| kind* | string | start — open bot with payload; startapp — open mini-app; share — 'send to MAX' link for any site, no bot needed; mention — user mention markup |
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| text | any | share: text to prefill; mention: display name |
| payload | any | start: ≤128 chars; startapp: ≤512, A-Za-z0-9_- only |
| user_id | any | mention: MAX user id |
| bot_name | any | Bot public name as in max.ru/<name> (start, startapp) |
| button_label | any | share: label for the generated HTML button; default depends on lang |
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).
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| path | any | Path like '/messages', '/chats/{chatId}/pin' or a concrete one '/chats/-123/pin' |
| verb | any | HTTP method: GET, POST, PUT, PATCH, DELETE. Omit to list all endpoints |
{
"type": "object",
"title": "max_endpoint_infoArguments",
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Path",
"default": null,
"description": "Path like '/messages', '/chats/{chatId}/pin' or a concrete one '/chats/-123/pin'"
},
"verb": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Verb",
"default": null,
"description": "HTTP method: GET, POST, PUT, PATCH, DELETE. Omit to list all endpoints"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
{
"type": "object",
"title": "max_limitsArguments",
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| code* | string | Source code of a MAX bot or mini-app (any language), or a config / curl snippet |
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
{
"type": "object",
"title": "max_lint_codeArguments",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"title": "Code",
"description": "Source code of a MAX bot or mini-app (any language), or a config / curl snippet"
},
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| code | any | Telegram bot source (aiogram, python-telegram-bot, telebot, Telegraf, grammY, raw HTTP…). Omit to get only the method map |
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
{
"type": "object",
"title": "max_migrate_from_telegramArguments",
"properties": {
"code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Code",
"default": null,
"description": "Telegram bot source (aiogram, python-telegram-bot, telebot, Telegraf, grammY, raw HTTP…). Omit to get only the method map"
},
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| user_id | integer | |
| chat_type | string | Where the mini-app was opened |
| first_name | any | |
| age_seconds | integer | Make auth_date this many seconds old, to test expiry |
| start_param | any | Value from ?startapp= |
| test_bot_token | any | A TEST token to sign with. Omit to generate a random one. Never pass a production token to a hosted server |
{
"type": "object",
"title": "max_mock_init_dataArguments",
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"user_id": {
"type": "integer",
"title": "User Id",
"default": 100500
},
"chat_type": {
"enum": [
"DIALOG",
"CHAT",
"CHANNEL"
],
"type": "string",
"title": "Chat Type",
"default": "DIALOG",
"description": "Where the mini-app was opened"
},
"first_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "First Name",
"default": null
},
"age_seconds": {
"type": "integer",
"title": "Age Seconds",
"default": 0,
"minimum": 0,
"description": "Make auth_date this many seconds old, to test expiry"
},
"start_param": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Start Param",
"default": null,
"description": "Value from ?startapp="
},
"test_bot_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Test Bot Token",
"default": null,
"description": "A TEST token to sign with. Omit to generate a random one. Never pass a production token to a hosted server"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| text | any | Message text (message_created/edited, comments) or new title |
| secret | any | Webhook secret to put into X-Max-Bot-Api-Secret |
| chat_id | any | Chat id; default is generated |
| payload | any | Callback payload or bot_started deep link payload |
| chat_type | string | Where it happens |
| overrides | any | Deep-merge into the generated update |
| update_type* | string | message_created, message_callback, bot_started, bot_added, bot_removed, message_edited, message_removed, user_added, user_removed, comment_created, chat_title_changed, dialog_muted, bot_admin_permissions_changed, … |
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.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| language | string | python (httpx, no official SDK), typescript (@maxhub/max-bot-api) or go (official client v2) |
{
"type": "object",
"title": "max_scaffold_botArguments",
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"language": {
"enum": [
"python",
"typescript",
"go"
],
"type": "string",
"title": "Language",
"default": "python",
"description": "python (httpx, no official SDK), typescript (@maxhub/max-bot-api) or go (official client v2)"
}
}
}Split text into MAX messages of at most 4000 characters, cutting at paragraphs, lines or sentences.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| text* | string | Long text to send |
| limit | integer | Max characters per message |
{
"type": "object",
"title": "max_split_textArguments",
"required": [
"text"
],
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"text": {
"type": "string",
"title": "Text",
"description": "Long text to send"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 4000,
"maximum": 4000,
"minimum": 100,
"description": "Max characters per message"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| bot_name | any | Your bot's public name: each placement gets max.ru/<bot>?start=<id> |
| campaign* | string | Campaign name, e.g. 'black friday' |
| site_url | any | Landing page: each placement gets UTM tags and its erid |
| placements* | array | Channels where the ad goes: [{name, cost?, erid?}]. name may be a title or max.ru link |
| utm_medium | string | |
| promo_codes | boolean | Also make one promo code per placement |
| mini_app_bot |
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.
| Argument | Type | Description |
|---|---|---|
| body* | object | NewMessageBody JSON: {text, format, attachments, link, notify} |
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
| target | string | message — POST /messages, comment — POST /messages/{id}/comments |
| chat_type | any | Where it goes, for channel-specific rules |
{
"type": "object",
"title": "max_validate_messageArguments",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"title": "Body",
"description": "NewMessageBody JSON: {text, format, attachments, link, notify}",
"additionalProperties": true
},
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"target": {
"enum": [
"message",
"comment"
],
"type": "string",
"title": "Target",
"default": "message",
"description": "message — POST /messages, comment — POST /messages/{id}/comments"
},
"chat_type": {
"anyOf": [
{
"enum": [
"dialog",
"chat",
"channel"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Chat Type",
"default": null,
"description": "Where it goes, for channel-specific rules"
}
}
}Server version, facts date, mode (hosted or local), languages and whether operator tools are active.
| Argument | Type | Description |
|---|---|---|
| lang | any | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) |
{
"type": "object",
"title": "server_statusArguments",
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 16, 2026.
Takes a password, API key or token as an argument, so the secret passes through the model's context and chat logs.
Fix: Read credentials from the server's own configuration (environment, OAuth) instead of a tool argument.
{
"type": "object",
"title": "max_bridge_mockArguments",
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"phone": {
"type": "string",
"title": "Phone",
"default": "79990000000"
},
"user_id": {
"type": "integer",
"title": "User Id",
"default": 100500
},
"platform": {
"enum": [
"ios",
"android",
"desktop",
"web"
],
"type": "string",
"title": "Platform",
"default": "android",
"description": "Platform to emulate: limits which Bridge features work"
},
"first_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "First Name",
"default": null
},
"entry_point": {
"enum": [
"default",
"tabbar"
],
"type": "string",
"title": "Entry Point",
"default": "default"
},
"start_param": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Start Param",
"default": null,
"description": "Emulated ?startapp= value"
},
"test_bot_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Test Bot Token",
"default": null,
"description": "TEST token: initData and requestContact hash will be validly signed with it"
}
}
}{
"type": "object",
"title": "max_build_messageArguments",
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Text",
"default": null,
"description": "Message text, up to 4000 characters"
},
"format": {
"anyOf": [
{
"enum": [
"markdown",
"html"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Format",
"default": null,
"description": "Text markup"
},
"buttons": {
"anyOf": [
{
"type": "array",
"items": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
{
"type": "null"
}
],
"title": "Buttons",
"default": null,
"description": "Rows of buttons. Short form: {text, payload} → callback, {text, url} → link, {text, web_app, payload?} → open_app; or full {type, text, ...}"
},
"chat_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Chat Id",
"default": null,
"description": "For the curl example"
},
"user_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "User Id",
"default": null,
"description": "For the curl example, private dialog"
},
"image_urls": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Image Urls",
"default": null,
"description": "External image URLs to attach without uploading"
},
"reply_to_mid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reply To Mid",
"default": null,
"description": "Reply to this message id"
},
"disable_link_preview": {
"type": "boolean",
"title": "Disable Link Preview",
"default": false
}
}
}{
"type": "object",
"title": "max_deeplinkArguments",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"start",
"startapp",
"share",
"mention"
],
"type": "string",
"title": "Kind",
"description": "start — open bot with payload; startapp — open mini-app; share — 'send to MAX' link for any site, no bot needed; mention — user mention markup"
},
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Text",
"default": null,
"description": "share: text to prefill; mention: display name"
},
"payload": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Payload",
"default": null,
"description": "start: ≤128 chars; startapp: ≤512, A-Za-z0-9_- only"
},
"user_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "User Id",
"default": null,
"description": "mention: MAX user id"
},
"bot_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Bot Name",
"default": null,
"description": "Bot public name as in max.ru/<name> (start, startapp)"
},
"button_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Button Label",
"default": null,
"description": "share: label for the generated HTML button; default depends on lang"
}
}
}| webhook_url | any | If set, also returns a curl command that POSTs the update there |
{
"type": "object",
"title": "max_mock_updateArguments",
"required": [
"update_type"
],
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Text",
"default": null,
"description": "Message text (message_created/edited, comments) or new title"
},
"secret": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Secret",
"default": null,
"description": "Webhook secret to put into X-Max-Bot-Api-Secret"
},
"chat_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Chat Id",
"default": null,
"description": "Chat id; default is generated"
},
"payload": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Payload",
"default": null,
"description": "Callback payload or bot_started deep link payload"
},
"chat_type": {
"enum": [
"dialog",
"chat",
"channel"
],
"type": "string",
"title": "Chat Type",
"default": "dialog",
"description": "Where it happens"
},
"overrides": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Overrides",
"default": null,
"description": "Deep-merge into the generated update"
},
"update_type": {
"type": "string",
"title": "Update Type",
"description": "message_created, message_callback, bot_started, bot_added, bot_removed, message_edited, message_removed, user_added, user_removed, comment_created, chat_title_changed, dialog_muted, bot_admin_permissions_changed, …"
},
"webhook_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Webhook Url",
"default": null,
"description": "If set, also returns a curl command that POSTs the update there"
}
}
}| any |
| Bot with your mini-app: each placement gets ?startapp=<id> |
{
"type": "object",
"title": "max_tracking_linksArguments",
"required": [
"campaign",
"placements"
],
"properties": {
"lang": {
"anyOf": [
{
"enum": [
"ru",
"en"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lang",
"default": null,
"description": "Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG)"
},
"bot_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Bot Name",
"default": null,
"description": "Your bot's public name: each placement gets max.ru/<bot>?start=<id>"
},
"campaign": {
"type": "string",
"title": "Campaign",
"description": "Campaign name, e.g. 'black friday'"
},
"site_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Site Url",
"default": null,
"description": "Landing page: each placement gets UTM tags and its erid"
},
"placements": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Placements",
"description": "Channels where the ad goes: [{name, cost?, erid?}]. name may be a title or max.ru link"
},
"utm_medium": {
"type": "string",
"title": "Utm Medium",
"default": "seeding"
},
"promo_codes": {
"type": "boolean",
"title": "Promo Codes",
"default": true,
"description": "Also make one promo code per placement"
},
"mini_app_bot": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Mini App Bot",
"default": null,
"description": "Bot with your mini-app: each placement gets ?startapp=<id>"
}
}
}