Telegram Bot MCP. Manage Media, Read Context, Automate Messages
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Telegram Bot MCP Server lets your AI agent control any Telegram bot programmatically. You can send formatted text, photos, documents, videos, and audio files.
It also reads chat context—getting member counts, admin lists, and the latest updates—all without opening the app.
What your AI agents can do
Delete message
Deletes a specific message within a Telegram chat.
Forward message
Forwards an existing message from one chat to another.
Get bot info
Retrieves basic profile details, username, and configuration for the connected Telegram bot.
The AI agent sends text messages with support for Markdown or HTML formatting to a specified chat.
You send photos, videos, documents, audio files, and other media types directly to the target Telegram chat.
The agent retrieves metadata about a group or channel, including member counts and who has admin privileges within that chat.
You pull the latest updates from a bot, allowing your AI client to react immediately when users send new messages or trigger events.
The agent can forward existing messages between chats or programmatically delete specific messages within any group conversation.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Telegram Bot MCP Server: 13 Tools for Chat Automation
Use these 13 specialized tools to send structured messages, deliver rich media files, or pull detailed information about any Telegram chat.
019d8488delete message
Deletes a specific message within a Telegram chat.
019d8488forward message
Forwards an existing message from one chat to another.
019d8488get bot info
Retrieves basic profile details, username, and configuration for the connected Telegram bot.
019d8488get chat admins
Fetches a list of users who have administrator rights in a specific chat.
019d8488get chat info
Gets detailed metadata about any specified Telegram chat, including its type and ID.
019d8488get chat members count
Returns the current total number of members in a specific Telegram group or channel.
019d8488get updates
Pulls all recent activity and updates sent by users to the bot, allowing for real-time context gathering.
019d8488get user profile photos
Gets a list of available photo sizes associated with a user's profile picture.
019d8488send audio
Sends an audio file, specifying the file ID or URL, to a Telegram chat.
019d8488send document
Transmits files (PDFs, ZIPs, etc.) as documents to a specified Telegram chat.
019d8488send message
Sends plain text messages and formatted content using Markdown or HTML modes to a chat.
019d8488send photo
Transmits an image file, with the option to include a descriptive caption, to a Telegram chat.
019d8488send video
Sends a video file to the target Telegram chat.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Telegram Bot, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
This MCP Server lets your AI agent control any Telegram bot programmatically. You can send formatted text, photos, documents, videos, and audio files.
Sending Messages and Media:
When you use the send_message tool, your AI client sends plain text or formatted content using Markdown or HTML modes to a chat.
To deliver rich media, you've got options: You can send photos via send_photo, including an optional descriptive caption; you can transmit files like PDFs and ZIPs using send_document; you can blast out videos with send_video; and you can drop off audio files by calling send_audio.
Gathering Chat Context and Structure:
When you need to know what's going down in a group, the server provides deep access. You start by getting core data with get_bot_info, which pulls basic profile details and the bot's username.
To audit the chat structure, you can pull detailed metadata about any specified Telegram chat using get_chat_info, which returns the chat's type and unique ID.
For membership numbers, you just run get_chat_members_count to get the current total member count for a group or channel.
You also need to know who runs the show; calling get_chat_admins pulls an exact list of users with administrator rights in that chat.
Processing Real-Time Events and Updates:
The server allows you to process real-time activity by using get_updates. This tool constantly pulls all recent user updates sent to the bot, letting your agent react instantly whenever someone posts something. It gives you real-time context gathering capabilities that're crucial for any automated flow.
Managing Message State and Workflow:
The server handles message management so you don't have to open the app. You can forward existing messages from one chat location to another using forward_message. If a message needs to vanish, you use delete_message to wipe out specific messages within any Telegram chat.
Finally, if you need details about user profiles, get_user_profile_photos gives you a list of available photo sizes for the connected user.
How Telegram Bot MCP Works
- 1 First, subscribe to the server and provide your Telegram Bot Token, which you get from BotFather.
- 2 Next, connect this MCP Server to your preferred AI client (Claude, Cursor, etc.)
- 3 Finally, tell your agent what you need. For example: 'Get the member count for my support group' or 'Send a broadcast message with Markdown formatting.'
The bottom line is that your AI agent uses your provided bot token to execute native Telegram API calls, giving it direct control over your channel.
Who Is Telegram Bot MCP For?
Community Managers who handle mass announcements and need detailed group oversight. Support Teams that manage high-volume customer chats and require message forwarding/logging. Automation Engineers building mission-critical alert systems that must react instantly to Telegram activity.
Uses the agent to monitor incoming messages via get_updates, automatically forward urgent client queries, and confirm group membership using get_chat_members_count.
Runs broadcasts or announcements across multiple channels without manually accessing the Telegram app; uses send_message with formatting for consistency.
Integrates chat management into alerts, triggering actions like sending a critical alert via send_document when a specific system event occurs in a private group.
What Changes When You Connect
- Broadcast announcements instantly. Use
send_messageto send formatted alerts across groups or channels without manually opening the Telegram app. - Handle diverse media types reliably. Send photos (
send_photo), documents (send_document), videos, and audio files from your agent; it’s not just text. - Understand group structure instantly. Use
get_chat_members_countto know exactly how many people are in the chat before running a mass communication. - Maintain message history context. The
get_updatestool streams real-time activity, ensuring your agent always knows what users just said. - Control group permissions. Check who has power with
get_chat_admins, or manage conversation flow by usingforward_messageto route data between departments.
Real-World Use Cases
Triage incoming support tickets
A Support Agent needs to review a complex query. They ask the agent to check the chat info (get_chat_info) and get all recent updates (get_updates). The agent processes the thread, uses forward_message to route it to the billing department's group, and then sends an acknowledgment via send_message. Problem solved.
Run a community poll or survey
The Community Manager wants to send out a new set of guidelines. They use send_document for the PDF manual and follow up with a formatted announcement via send_message. This ensures all members get the official, structured information in one go.
Audit a restricted chat group
An Admin needs to know who can post rules changes. They use get_chat_admins immediately. If they also need to confirm the size of the community, they run get_chat_members_count. This provides instant oversight without needing elevated app permissions.
Alerting on system failures
The DevOps team sets up an alert. When a critical error is detected, the agent uses send_photo (attaching a screenshot) and sends it to the #alerts channel. The message includes context from get_chat_info, providing immediate visibility.
The Tradeoffs
Assuming simple text is enough
Trying to send a report just by calling 'send_message' when the content is actually an attached PDF.
→
Don't rely on plain text. Use send_document instead. This ensures the file attaches correctly and retains its original formatting, which is what you want.
Forgetting to check chat context
Attempting a mass broadcast without knowing if the channel is private or public, leading to failed messages.
→
Always run get_chat_info first. This validates the target chat's status and structure before you call send_message, preventing failed deployments.
Over-relying on raw message history
Just scraping visible messages in the client without checking if there are deeper, unread updates.
→
Always use get_updates to pull the latest events. This gives your agent a comprehensive stream of activity that's more reliable than just viewing the current screen.
When It Fits, When It Doesn't
Use this MCP Server if your core task involves manipulating or reading data specifically within the Telegram messaging environment—whether it’s sending formatted media, checking admin roles, or getting real-time updates. For instance, if you need to send a PDF and confirm who can delete messages in that group, these tools are necessary.
Don't use this server if your goal is general chat logging across multiple platforms (you'd need a centralized messaging API wrapper) or if you only need basic HTTP data retrieval. If all you need is to post information to a website, skip the Telegram tools and build a direct web hook instead. The boundary here is simple: Is the action happening inside Telegram? Yes = use this server.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Telegram Bot API. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 13 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually managing group communications is slow work.
Today, running announcements or support triage means jumping through hoops. You open the app, copy a file from your desktop, paste it into Telegram, then switch tabs to check who's in the chat, and finally, manually type out the message body. It takes clicks—a dozen clicks—and you risk human error every single time.
With this MCP server, those steps vanish. You tell your agent: 'Announce X.' The agent uses `send_message` to format the text, then calls `send_photo` with the attached image, and automatically verifies the target group count using `get_chat_members_count`. It’s one prompt, done.
Telegram Bot MCP Server: Control media delivery & chat context.
Before this server, sending a complex asset—like an annual report PDF or a tutorial video—required multiple steps: uploading the file manually, getting the correct link, and ensuring the message formatted correctly. If you missed one step, the entire communication failed.
Now, it's simple. You tell your agent to 'Send the Q3 report.' The agent executes `send_document`, handles the file ID, and delivers the asset with perfect formatting. It just works.
Common Questions About Telegram Bot MCP
How do I get a list of admins in my Telegram chat using get_chat_admins? +
You call get_chat_admins and pass the relevant Chat ID. The response gives you an array listing every user who has administrator rights, letting you audit group roles instantly.
Can I send a photo with Markdown formatting using send_photo? +
Yes, send_photo handles the image delivery. You use the advanced parameters in combination with send_message to ensure the caption uses proper Markdown or HTML styling.
What is the best tool for checking how many people are in a group? +
Use get_chat_members_count. This tool specifically returns the total count of members, which is faster and more direct than trying to parse general chat info using get_chat_info.
How does get_updates work for real-time alerts? +
get_updates pulls a stream of the latest activity. Your agent listens to this feed, allowing it to react—for example, running forward_message if it detects a keyword in an update.
What details does `get_bot_info` provide about my Telegram bot's setup? +
It returns your bot’s unique ID, username, and basic configuration parameters. You use this to confirm that the token you entered is active and connected correctly before building complex workflows.
When using `send_document`, what format are the file inputs expected in? +
The tool requires either a direct URL or the document's unique file ID. It supports standard formats like PDFs, ZIPs, and common office documents automatically.
What specific IDs do I need to pass when calling `delete_message`? +
You must provide both the target chat ID and the message's unique ID. This two-part input system ensures that your agent deletes exactly the message you intend, preventing accidental deletions.
Beyond counting members, what metadata does `get_chat_info` retrieve? +
This tool pulls comprehensive details about the chat environment, including its type (group/private), language settings, and general creation data. This context helps your agent understand where it is acting.
How do I get a Telegram Bot Token? +
Open Telegram, search for @BotFather, send /newbot, follow the prompts to name your bot, and copy the token provided (format: 123456:ABC-DEF...).
Can I send messages to specific groups or channels? +
Yes! Use the send_message tool with the chat_id of your target group, channel, or user. The bot must already be added to the group/channel as a member.
What media types can the bot send? +
The bot supports sending photos, documents, videos, and audio files. Simply provide a public URL or a file_id from Telegram's servers.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Discord Webhook Notifier
This MCP does exactly one thing: it sends messages to your Discord channels. That's its only function, and nothing else. Zero friction, incredible for giving your AI agents a voice.
Telegram Bot Alternative
Control and manage your Telegram bots — send messages, photos, and audit chats via AI.
Slack
Automate Slack messaging — send messages, search conversations, list channels and users directly from any AI agent.
You might also like
MapQuest
Mapping and location services via MapQuest — geocoding, directions, and POI search.
Railz
Financial data integration platform — connect accounting, banking, and commerce data via AI.
JokeAPI Alternative
Access thousands of jokes — audit categories and flags via AI.