Telegram Bot API MCP. Read messages, manage content, and automate chat actions.

This MCP Server gives your agent direct access to Telegram's messaging backbone. You aren't messing around with a UI; you're writing code that sends commands straight through the platform's API.

First, you gotta know what bot you are. Use get_bot_info to pull basic identifying data, like your unique ID and username. That's always step one.

When it comes to keeping tabs on things, your agent pulls new user interactions using list_bot_updates. It monitors for general updates from users in real time, making it perfect for monitoring conversations as they happen. If you need details about a specific chat—whether that’s a private conversation or a massive group—you run get_chat_details to get the full breakdown.

You can also check how big the crowd is by calling get_chat_member_count, which returns the total member count for any specified chat or channel.

For auditing who's running the show, you use specific tools. To list everyone with management privileges in a group or channel, call list_chat_administrators. This pulls the usernames and IDs of all the current managers. You can also get granular info on who’s in charge by calling get_chat_details.

Sending stuff is where this thing shines. For plain text replies to any specified user or group, you use send_text_message, making sure you provide the exact chat ID and payload. Need to send a picture? You call send_photo_by_url and give it a full HTTPS link to the image. If you’re dropping off a big file, like a PDF report or a compressed archive, use send_document_by_url with its public download URL.

These methods let your agent distribute media files exactly how you want them.

When it comes time for cleanup and moderation, you've got serious power. If somebody posts something inappropriate, you can delete the whole thing by calling delete_chat_message. This removes a message from the chat history, regardless of whether the bot or another user sent it in a managed group. You don't have to scrap the message entirely; if you just want to fix what was said, use edit_message_text to change the content of a message that already went out through Telegram.

Your agent handles everything from monitoring new activity using list_bot_updates and replying instantly with send_text_message, all the way up to sending specific media payloads. You can audit membership counts with get_chat_member_count or list administrators with list_chat_administrators. It's about executing precise, verifiable API calls against the Telegram ecosystem. When you run these tools together—for instance, listing admins, checking member count, and then sending a formatted alert document—you get real-time control over chat content.