aiogram-mcp
Turns an existing aiogram bot into an MCP server so Claude can drive your Telegram bot directly. You get 30 tools spanning messaging, moderation, inline keyboards, and rich media, plus 7 resources for chat history and bot state, and real-time event streaming so the AI sees new messages without polling. The middleware sits alongside your existing handlers, meaning you add five lines to your bot code and suddenly Claude can send photos, ban users, create button menus, and react to callback queries. Built-in rate limiting prevents Telegram 429s, audit logs track every tool call, and permission levels let you lock the AI to read-only or full admin. Reach for this when you want an AI agent to manage a Telegram community or automate moderation without rewriting your bot from scratch.
- tools
- 30
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Mar 14, 2026
Tools
30 toolsPublic tool metadata for what this MCP can expose to an agent.
send_messageSend text with HTML/Markdown formatting
Send text with HTML/Markdown formatting
No parameter schema in public metadata yet.
send_photoSend a photo by URL with optional caption
Send a photo by URL with optional caption
No parameter schema in public metadata yet.
forward_messageForward a message between chats
Forward a message between chats
No parameter schema in public metadata yet.
delete_messageDelete a message
Delete a message
No parameter schema in public metadata yet.
pin_messagePin a message in a chat
Pin a message in a chat
No parameter schema in public metadata yet.
send_interactive_messageSend a message with inline keyboard buttons (callback or URL)
Send a message with inline keyboard buttons (callback or URL)
No parameter schema in public metadata yet.
edit_messageEdit text and/or keyboard of an existing message
Edit text and/or keyboard of an existing message
No parameter schema in public metadata yet.
answer_callback_queryRespond to a button press with a toast or alert
Respond to a button press with a toast or alert
No parameter schema in public metadata yet.
get_bot_infoGet bot metadata (username, capabilities)
Get bot metadata (username, capabilities)
No parameter schema in public metadata yet.
get_chat_member_infoGet a user's role and profile in a chat
Get a user's role and profile in a chat
No parameter schema in public metadata yet.
get_user_profile_photosGet a user's profile photos
Get a user's profile photos
No parameter schema in public metadata yet.
get_chat_infoGet chat metadata (title, type, description)
Get chat metadata (title, type, description)
No parameter schema in public metadata yet.
get_chat_members_countGet number of members in a chat
Get number of members in a chat
No parameter schema in public metadata yet.
ban_userBan a user (permanent or temporary)
Ban a user (permanent or temporary)
No parameter schema in public metadata yet.
unban_userUnban a user
Unban a user
No parameter schema in public metadata yet.
set_chat_titleChange the chat title
Change the chat title
No parameter schema in public metadata yet.
set_chat_descriptionChange the chat description
Change the chat description
No parameter schema in public metadata yet.
send_documentSend a file/document by URL with optional caption
Send a file/document by URL with optional caption
No parameter schema in public metadata yet.
send_voiceSend a voice message by URL
Send a voice message by URL
No parameter schema in public metadata yet.
send_videoSend a video by URL with optional caption
Send a video by URL with optional caption
No parameter schema in public metadata yet.
send_animationSend a GIF/animation by URL
Send a GIF/animation by URL
No parameter schema in public metadata yet.
send_audioSend audio/music by URL with performer and title
Send audio/music by URL with performer and title
No parameter schema in public metadata yet.
send_stickerSend a sticker by file_id or URL
Send a sticker by file_id or URL
No parameter schema in public metadata yet.
send_video_noteSend a round video note by URL
Send a round video note by URL
No parameter schema in public metadata yet.
send_contactSend a contact with phone number and name
Send a contact with phone number and name
No parameter schema in public metadata yet.
send_locationSend a geolocation pin
Send a geolocation pin
No parameter schema in public metadata yet.
send_pollCreate a poll with multiple options
Create a poll with multiple options
No parameter schema in public metadata yet.
subscribe_eventsSubscribe to real-time events with chat/type filters
Subscribe to real-time events with chat/type filters
No parameter schema in public metadata yet.
unsubscribe_eventsRemove a subscription
Remove a subscription
No parameter schema in public metadata yet.
broadcastSend a message to multiple chats (requires enable_broadcast=True)
Send a message to multiple chats (requires enable_broadcast=True)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
BOT_TOKEN*secretTelegram Bot API token from @BotFather
Readme
aiogram-mcp
Connect your Telegram bot to AI agents via the Model Context Protocol.
aiogram-mcp turns any aiogram bot into an MCP server. AI clients like Claude Desktop can then send messages, read chat history, build interactive menus, and react to events in real time — all through your existing bot, without rewriting a single handler.
Why aiogram-mcp?
Most Telegram MCP servers are thin wrappers with 3-5 tools. aiogram-mcp goes further:
Details
- Repository
- github.com/py2755/aiogram-mcp
- Categories
- Communication & Messaging, Media & Entertainment
- Package
aiogram-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related Communication & Messaging MCP servers
View all
Llama AI MCProcnubie/llamaai-mcpUse Llama AI Chat to test Meta Llama 4 Maverick on code review, long PDFs, and screenshots.0stars
Vibie Mcpshdomi8599/vibie-mcpDeploy HTML folders to vibie.page from Claude / Cursor — one-line install, OAuth, auto-update.0stars
Signalizsignaliz/signaliz-mcpB2B lead generation, email verification, company enrichment, and agentic GTM Ops.0stars
Sendpulse Mcptheyahia/sendpulse-mcpMCP server for SendPulse API — mailing lists, email sending, statistics. OAuth2 auth.0stars
Vibe Provisiontotte-dev/vibe-provisionProvision SaaS services from YAML and inject .env. Supports Clerk, Stripe, Resend and more.0stars
Agent-Native Brainbuilderio/agent-nativeCited company knowledge from Slack, meetings, transcripts, and decisions7.6Kstars