Server data from the Official MCP Registry
MCP server for MAX Messenger by VK. 21 tools: messages, media, buttons, members, events.
MCP server for MAX Messenger by VK. 21 tools: messages, media, buttons, members, events.
Valid MCP server (3 strong, 1 medium validity signals). 6 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (3/3 approved).
6 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: MAX_TOKEN
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-woyaxnini-max-messenger": {
"env": {
"MAX_TOKEN": "your-max-token-here"
},
"args": [
"-y",
"@woyax/mcp-max-messenger"
],
"command": "npx"
}
}
}From the project's GitHub README.
The first MCP server for MAX Messenger — Russia's national messenger by VK (75M+ users).
Connect AI clients (Claude Desktop, Cursor, n8n, and any MCP-compatible app) to MAX: send and read messages, manage chats and members, send media, handle button presses, format with HTML/Markdown — all through the open Model Context Protocol standard.
21 tools with full coverage of MAX Bot API.
Add to your Claude Desktop config:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"max-messenger": {
"command": "npx",
"args": ["-y", "@woyax/mcp-max-messenger"],
"env": {
"MAX_TOKEN": "YOUR_BOT_TOKEN"
}
}
}
}
Restart Claude Desktop. The MAX tools will appear automatically.
MAX_TOKEN=YOUR_BOT_TOKEN MCP_TRANSPORT=http MCP_PORT=3000 npx @woyax/mcp-max-messenger
Connect any MCP client to http://your-server:3000/mcp.
| Tool | Description |
|---|---|
get_messages | Read messages from a chat (by chat_id or message_ids) |
send_message | Send a message with text, HTML/Markdown, inline keyboard, media attachments |
edit_message | Edit message text and attachments |
delete_message | Delete a message |
pin_message | Pin a message in a chat |
unpin_message | Unpin the currently pinned message |
| Tool | Description |
|---|---|
send_media | Upload and send photo, video, audio, or file by URL |
send_action | Show typing indicator, "sending photo/video/audio/file", mark as read |
| Tool | Description |
|---|---|
get_bot_info | Bot info: name, ID, username, description |
get_chats | List all group chats the bot participates in |
get_chat | Full chat details: participants, pinned message, owner |
edit_chat | Rename chat, change description or icon |
| Tool | Description |
|---|---|
get_chat_members | List chat members with roles |
get_admins | List chat administrators with permissions |
set_admin | Grant admin rights to a member |
remove_admin | Revoke admin rights |
add_members | Add users to a group chat |
remove_member | Remove a user from a group chat |
| Tool | Description |
|---|---|
get_updates | Incoming events: messages, button presses, new dialogs (long polling) |
answer_callback | Respond to inline button press: show notification or update message |
5 button types supported: callback, link, message, request_contact, request_geo_location.
Once connected to Claude Desktop, use natural language:
"Send a message to chat 123456789: 'The meeting starts in 10 minutes'"
"Send an approval request with Approve/Reject buttons to the team chat"
"Show me the last 10 messages from the announcements chat"
"Send this photo to the chat: https://example.com/image.jpg"
"Who are the members of the sales group? Make Alex an admin."
"Check for new incoming messages and button presses"
| Variable | Required | Default | Description |
|---|---|---|---|
MAX_TOKEN | ✅ | — | Your MAX bot token |
MCP_TRANSPORT | ❌ | stdio | Transport: stdio or http |
MCP_PORT | ❌ | 3000 | Port for HTTP mode |
# Local stdio mode (default)
npx @woyax/mcp-max-messenger
# Remote HTTP mode
npx @woyax/mcp-max-messenger --transport http --port 3000
Two independent layers — tools work identically in both modes:
src/
├── core/ # Business logic — shared between modes
│ ├── max-client.ts # MAX API HTTP client
│ ├── types.ts # TypeScript types for MAX API
│ └── tools/
│ ├── bot.ts # get_bot_info
│ ├── chats.ts # get_chats, get_chat, edit_chat, send_action
│ ├── messages.ts # send/get/edit/delete/pin/unpin, send_media
│ ├── members.ts # get_chat_members, get_admins, set/remove_admin, add/remove_members
│ └── updates.ts # get_updates, answer_callback
├── transports/ # Transport layer — selected at runtime
│ ├── stdio.ts # Local mode (Claude Desktop, Cursor)
│ └── http.ts # Remote mode (Streamable HTTP)
└── index.ts # Entry point: transport selection
Authorization: <token> — no Bearer prefixhttps://platform-api.max.ruGET /chats returns group chats onlyget_updates — use the returned chat_id with all standard toolsremove_admin may return success: true without actually revoking rights — confirmed bug on MAX sideopen_app button type returns "Field 'webApp' cannot be null" — MAX API bugadd_members may fail with add.participant.privacy if the user has privacy mode enabledanswer_callback testing via n8n webhook workflowBuilt by Oleg Alekseev — ERP/AI integration architect.
Need help integrating AI agents with your ERP, CRM, or MAX? Custom MCP servers, n8n workflows, AI automation — contact me.
MIT + Commons Clause © Oleg Alekseev
Free to use for personal and corporate purposes. Selling as a hosted service requires author's permission. See LICENSE for details.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
by mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.