aiogram-mcp

MCP server for aiogram Telegram bots — 30 tools, 7 resources, 3 prompts, event streaming

Connector by Py2755 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 3

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/py2755-aiogram-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

MCP server for aiogram Telegram bots — 30 tools, 7 resources, 3 prompts, event streaming

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools: 6 read · 21 write · 2 delete · 1 not yet classified
Secrets: 1 (API keys, tokens or passwords)
Install scripts: Not scanned yet
Runs as: Python package

Tools by what they do 30

Read from the source code; the running server may list different tools.

Read 6 · Look things up without changing anything.

answer_callback_query
get_bot_info
get_chat_info
get_chat_member_info
get_chat_members_count
get_user_profile_photos

Write 21 · Create, change, send or run things.

broadcast
edit_message
forward_message
pin_message
send_animation
send_audio
send_contact
send_document
send_interactive_message
send_location
send_message
send_photo

Show 9 more tools

send_poll
send_sticker
send_video
send_video_note
send_voice
set_chat_description
set_chat_title
subscribe_events
unsubscribe_events

Delete 2 · Delete, drop, revoke or wipe things.

ban_user
delete_message

Not yet classified 1 · We could not tell from the name and description.

unban_user

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

BOT_TOKEN

Tools (30)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

answer_callback_query
Answer a callback query from an inline keyboard button press. Args: callback_query_id: ID of the callback query (from the event). text: Optional notification text shown to the user. show_alert: Show as alert popup instead of toast notification.
ban_user
Ban a user from a chat.
broadcast
Send a message to multiple users or chats.
delete_message
Delete a message from a chat.
edit_message
Edit the text and/or inline keyboard of an existing message. Args: chat_id: Chat containing the message. message_id: ID of the message to edit. text: New message text. buttons: New inline keyboard (None to remove buttons). parse_mode: HTML, Markdown, MarkdownV2, or None.
forward_message
Forward an existing message from one chat to another.
get_bot_info
Return metadata about the current Telegram bot.
get_chat_info
Get details about a chat.
get_chat_member_info
Return role and user info for a chat member.
get_chat_members_count
Get the number of members in a chat.
get_user_profile_photos
Return a lightweight list of Telegram profile photo file IDs.
pin_message
Pin a message in a chat.
send_animation
Send a GIF/animation to a Telegram chat. Args: chat_id: Target chat ID. animation_url: URL or file_id of the animation. caption: Optional caption. parse_mode: HTML, Markdown, MarkdownV2, or None. disable_notification: Send silently.
send_audio
Send an audio file (music) to a Telegram chat. Args: chat_id: Target chat ID. audio_url: URL or file_id of the audio (MP3/M4A). caption: Optional caption. parse_mode: HTML, Markdown, MarkdownV2, or None. performer: Performer name. title: Track title. disable_notification: Send silently.
send_contact
Send a phone contact to a Telegram chat. Args: chat_id: Target chat ID. phone_number: Contact's phone number. first_name: Contact's first name. last_name: Contact's last name. disable_notification: Send silently.

Show 15 more tools

send_document
Send a document/file to a Telegram chat. Args: chat_id: Target chat ID. document_url: URL or file_id of the document. caption: Optional caption. parse_mode: HTML, Markdown, MarkdownV2, or None. disable_notification: Send silently.
send_interactive_message
Send a message with inline keyboard buttons. Args: chat_id: Target chat ID. text: Message text. buttons: Rows of buttons. Each button: {"text": "Label", "callback_data": "value"} or {"text": "Label", "url": "https://..."}. parse_mode: HTML, Markdown, MarkdownV2, or None. disable_notification: Send silently.
send_location
Send a location to a Telegram chat. Args: chat_id: Target chat ID. latitude: Latitude of the location. longitude: Longitude of the location. disable_notification: Send silently.
send_message
Send a text message to a Telegram chat or user.
send_photo
Send a photo to a Telegram chat.
send_poll
Send a poll to a Telegram chat. Args: chat_id: Target chat ID. question: Poll question (1-300 characters). options: List of answer options (2-10 strings). is_anonymous: Whether the poll is anonymous. type: "regular" or "quiz". allows_multiple_answers: Allow multiple answers (regular polls only). disable_notification: Send silently.
send_sticker
Send a sticker to a Telegram chat. Args: chat_id: Target chat ID. sticker: File ID or URL of the sticker (WEBP/TGS/WEBM). disable_notification: Send silently.
send_video
Send a video to a Telegram chat. Args: chat_id: Target chat ID. video_url: URL or file_id of the video. caption: Optional caption. parse_mode: HTML, Markdown, MarkdownV2, or None. duration: Duration in seconds. disable_notification: Send silently.
send_video_note
Send a video note (round video) to a Telegram chat. Args: chat_id: Target chat ID. video_note_url: URL or file_id of the video note. duration: Duration in seconds. length: Video width and height (diameter of the circle). disable_notification: Send silently.
send_voice
Send a voice message to a Telegram chat. Args: chat_id: Target chat ID. voice_url: URL or file_id of the voice message (OGG with OPUS). caption: Optional caption. parse_mode: HTML, Markdown, MarkdownV2, or None. duration: Duration in seconds. disable_notification: Send silently.
set_chat_description
Change the description of a group or channel.
set_chat_title
Change the title of a group or channel.
subscribe_events
Subscribe to real-time Telegram events. Receive notifications when new events match your filters. Read the telegram://events/queue resource to get event data. Args: chat_ids: Only events from these chats (None = all allowed chats). event_types: Filter by type: "message", "command" (None = all).
unban_user
Unban a previously banned user.
unsubscribe_events
Unsubscribe from real-time Telegram events. Args: subscription_id: The subscription ID returned by subscribe_events.

Signals

Stars: 3
Forks: 0
Open issues: 0
Weekly downloads: 53
Last commit: Mar 16, 2026 (7 months ago)
Last release: Mar 14, 2026 (7 months ago)
Last package publish: Mar 14, 2026 (7 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name: io.github.Py2755/aiogram-mcp
Version: 0.7.1
Auth: API key
Packages: pypi aiogram-mcp
License: MIT
Repository: github.com/Py2755/aiogram-mcp
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql

Cite this page

aiogram-mcp. Agent Mart. https://agentmart.dev/connectors/py2755-aiogram-mcp (last updated 2026-10-24)