Get information about the MAX bot: name, username, user_id, description. Use this to verify the bot is connected and working.

Get the list of all group chats where the bot is a participant. Returns chat_id, title, type, participant count, and last activity time. Use chat_id from results to read or send messages. NOTE: Only group chats are returned. Personal dialogs (type: dialog) are NOT included here — use get_updates to discover their chat_id.

Get full details of a specific chat by its ID: title, description, participant count, icon, pinned message, link.

Rename a chat, change its description, or update its icon. The bot must be an admin of the chat.

Show a typing indicator or other status to chat members. Use before sending a message to improve UX. Actions: typing_on, sending_photo, sending_video, sending_audio, sending_file, mark_seen.

Get the list of participants in a group chat. Returns user_id, name, username for each member.

Read messages from a MAX chat. Use either chat_id OR message_ids — they are mutually exclusive. With chat_id: returns recent messages from that chat (use count/from/to to filter). With message_ids: returns those specific messages only (do NOT provide chat_id).

Get a single message by its ID. Returns full message details including text, sender, attachments.

Send a text message to a MAX chat or user. Provide either chat_id (group chats/channels) or user_id (direct messages), not both. Supports markdown and HTML formatting. Use attachments to add inline keyboard buttons or media (use tokens from send_media).

Edit the text of an existing message sent by the bot. Optionally update attachments (inline keyboard buttons). Requires the message_id.

Delete a message sent by the bot. Requires the message_id.

Pin a message in a group chat. The bot must have admin rights in the chat.

Unpin the currently pinned message in a group chat. The bot must have admin rights.

Upload a file (image/video/audio/file) from a URL and send it as a message. The tool handles the full two-step upload process automatically: 1) get MAX upload URL, 2) upload file, 3) send message with attachment. Provide either chat_id or user_id.

Add one or more users to a group chat. The bot must be an admin of the chat. Provide user_ids to add.

Remove a user from a group chat. The bot must be an admin of the chat. Optionally block the user from rejoining. WARNING: If the user has privacy mode enabled in MAX settings, the bot will not be able to re-add them after removal — confirm with the user before proceeding.

Get the list of administrators in a group chat. Returns user_id, name, username, and permissions for each admin.

Grant admin rights to a chat member. The bot must be an admin or owner of the chat.

Revoke admin rights from a chat member. They remain a regular member. The bot must be an admin or owner of the chat. KNOWN MAX API BUG: The API returns success:true but rights may not actually be revoked. This is a confirmed issue on the MAX side — only the chat owner can reliably remove admin rights manually in the app.

Get incoming events: new messages, button clicks, user joins/leaves, etc. This is the ONLY way to get chat_id for personal dialogs (type: dialog). Use the returned marker in the next call to get only new events. Set timeout=0 for instant response, timeout>0 for long polling (waits up to N seconds for new events). Event types: message_created, message_edited, message_removed, message_callback, bot_started, bot_added, bot_removed, user_added, user_removed, message_chat_created. NOTE: Designed for development and manual polling only. For production bots use webhooks (POST /subscriptions) — in production the update queue accumulates quickly without continuous processing.

Respond to an inline button click (callback event from get_updates). You can update the original message text and/or show a notification popup to the user. Must be called within 30 seconds of the button press.