aiogram-mcp
JSON →MCP server for Telegram bots built with aiogram. 30 tools, 7 resources, 3 prompts â messaging, rich media, moderation, interactive keyboards, real-time event streaming, rate limiting, permissions, and audit logging.
Install
pip install aiogram-mcp Tools · 22
- send_message Send text with HTML/Markdown formatting
- send_photo Send a photo by URL with optional caption
- forward_message Forward a message between chats
- delete_message Delete a message
- pin_message Pin a message in a chat
- send_interactive_message Send a message with inline keyboard buttons (callback or URL)
- edit_message Edit text and/or keyboard of an existing message
- answer_callback_query Respond to a button press with a toast or alert
- get_bot_info Get bot metadata (username, capabilities)
- get_chat_member_info Get a user's role and profile in a chat
- get_user_profile_photos Get a user's profile photos
- get_chat_info Get chat metadata (title, type, description)
- get_chat_members_count Get number of members in a chat
- ban_user Ban a user (permanent or temporary)
- unban_user Unban a user
- set_chat_title Change the chat title
- set_chat_description Change the chat description
- send_document Send a file/document by URL with optional caption
- send_voice Send a voice message by URL
- send_video Send a video by URL with optional caption
- send_animation Send a GIF/animation by URL
- send_audio Send audio/music by URL
Environment variables
YOUR_BOT_TOKEN