Aiogram Mcp
Operate and debug aiogram Telegram bots from your agent with tools, resources, prompts, and live event streaming over MCP.
Overview
aiogram-mcp is an MCP server for the Build phase that exposes 30 tools, 7 resources, 3 prompts, and event streaming for aiogram Telegram bots over stdio.
What is this MCP server?
- 30 MCP tools for aiogram bot development and runtime control
- 7 resources and 3 prompts packaged for agent-guided bot workflows
- Event streaming for observing Telegram updates while coding
- PyPI package aiogram-mcp (v0.7.1) via uvx with required BOT_TOKEN secret
- 30 tools, 7 resources, 3 prompts
- Server version 0.7.1
- PyPI identifier aiogram-mcp; transport stdio
What problem does it solve?
Building Telegram bots in the IDE means constant context switching between BotFather, logs, and aiogram docs with no structured agent access to bot state.
Who is it for?
Indie devs building aiogram-based Telegram products who want MCP-native bot control during active integration sprints.
Skip if: Teams on non-aiogram Telegram stacks or builders who only need static Bot API curls without an running bot process.
What do I get? / Deliverables
After configuring BOT_TOKEN and the MCP entry, your agent can drive aiogram operations, read resources, and stream events while you implement handlers and integrations.
- Agent-callable control over aiogram bot operations via 30 tools
- Streamed Telegram events for in-IDE debugging
- Prompt and resource-backed workflows for bot feature implementation
Recommended MCP Servers
Journey fit
Telegram bot wiring is product build work—connecting your agent to the channel customers actually use. aiogram-mcp is a third-party messaging integration surface, which maps directly to build integrations rather than distribution or support tooling alone.
How it compares
Telegram bot operations MCP bridge, not a Telegram marketing or analytics suite.
Common Questions / FAQ
Who is Aiogram Mcp for?
Solo builders using the aiogram framework who want their coding agent to manage bot tools, resources, and events through MCP.
When should I use Aiogram Mcp?
During build integrations when you are wiring commands, webhooks, and handlers and need live Telegram context inside Claude Code or Cursor.
How do I add Aiogram Mcp to my agent?
Set the secret BOT_TOKEN from @BotFather, install or run Aiogram Mcp from PyPI (uvx runtime hint), and register the stdio MCP server in your host configuration.