aiogram-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BOT_TOKEN | Yes | Telegram bot token from @BotFather, used to authenticate and connect to the Telegram API |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| send_messageC | Send a text message to a Telegram chat or user. |
| send_photoC | Send a photo to a Telegram chat. |
| forward_messageC | Forward an existing message from one chat to another. |
| delete_messageC | Delete a message from a chat. |
| pin_messageC | Pin a message in a chat. |
| get_bot_infoA | Return metadata about the current Telegram bot. |
| get_chat_member_infoB | Return role and user info for a chat member. |
| get_user_profile_photosC | Return a lightweight list of Telegram profile photo file IDs. |
| get_chat_infoC | Get details about a chat. |
| get_chat_members_countB | Get the number of members in a chat. |
| ban_userC | Ban a user from a chat. |
| unban_userC | Unban a previously banned user. |
| set_chat_titleC | Change the title of a group or channel. |
| set_chat_descriptionB | Change the description of a group or channel. |
| subscribe_eventsA | Subscribe to real-time Telegram events. Receive notifications when new events match your filters. Read the telegram://events/queue resource to get event data. |
| unsubscribe_eventsC | Unsubscribe from real-time Telegram events. |
| send_interactive_messageB | Send a message with inline keyboard buttons. |
| edit_messageA | Edit the text and/or inline keyboard of an existing message. |
| answer_callback_queryB | Answer a callback query from an inline keyboard button press. |
| send_documentB | Send a document/file to a Telegram chat. |
| send_voiceB | Send a voice message to a Telegram chat. |
| send_videoB | Send a video to a Telegram chat. |
| send_animationC | Send a GIF/animation to a Telegram chat. |
| send_audioB | Send an audio file (music) to a Telegram chat. |
| send_stickerC | Send a sticker to a Telegram chat. |
| send_video_noteB | Send a video note (round video) to a Telegram chat. |
| send_contactB | Send a phone contact to a Telegram chat. |
| send_locationB | Send a location to a Telegram chat. |
| send_pollC | Send a poll to a Telegram chat. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| moderation_prompt | Review a user's behavior and decide on moderation action. Fetches user info, chat context, and recent messages to help the AI agent make an informed moderation decision. |
| announcement_prompt | Draft a Telegram announcement message. Provides a structured template with formatting guidelines to help the AI agent compose an effective announcement. |
| user_report_prompt | Generate a comprehensive report about a user in a chat. Fetches profile data, chat membership, and message history to compile a detailed user activity report. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| bot_info | Metadata about the connected Telegram bot. |
| config | Current aiogram-mcp server configuration. |
| chats | List of active Telegram chats the bot has seen. |
| events_queue | Real-time event queue from Telegram. Returns recent events (messages, commands) received by the bot. Use subscribe_events tool to get push notifications when new events arrive. Each event has an 'id' field — use it to track which events you've seen. |
| audit_log | Audit log of all MCP tool invocations. |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Py2755/aiogram-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server