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 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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