Aiogram MCP Server

Most Telegram MCP servers are thin wrappers with 3-5 tools. `aiogram-mcp` goes further:

Local serverstdioPython

What is the Aiogram MCP Server?

Most Telegram MCP servers are thin wrappers with 3-5 tools. aiogram-mcp goes further:

What the server does

  • 30 tools — — messaging, rich media, moderation, interactive keyboards, event subscriptions, broadcasting
  • 7 resources — — bot info, config, chat lists, message history, event queue, file metadata, audit log
  • 3 prompts — — ready-made moderation, announcement, and user report workflows
  • Structured output — — every tool returns typed Pydantic models with outputSchema for programmatic parsing
  • Real-time events — — the bot pushes Telegram events to AI clients via MCP notifications (no polling)
  • Interactive messages — — AI agents create inline keyboard menus, handle button presses, edit messages

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
send_messageSend text with HTML/Markdown formatting
send_photoSend a photo by URL with optional caption
forward_messageForward a message between chats
delete_messageDelete a message
pin_messagePin a message in a chat
send_interactive_messageSend a message with inline keyboard buttons (callback or URL)
edit_messageEdit text and/or keyboard of an existing message
answer_callback_queryRespond to a button press with a toast or alert
get_bot_infoGet bot metadata (username, capabilities)
get_chat_member_infoGet a user's role and profile in a chat
get_user_profile_photosGet a user's profile photos
get_chat_infoGet chat metadata (title, type, description)
get_chat_members_countGet number of members in a chat
ban_userBan a user (permanent or temporary)

Configuration

VariableDescriptionRequired
BOT_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use Aiogram MCP to send message.”
  • “Use Aiogram MCP to send photo.”
  • “Use Aiogram MCP to forward message.”

Frequently asked questions

Most Telegram MCP servers are thin wrappers with 3-5 tools. `aiogram-mcp` goes further: Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.