# Telegram Bot MCP for AI Agents AI Agent Connect > Telegram Bot lets you control your Telegram bot through your AI client. Send text, photos, documents, and videos, or manage group members and chat info without leaving your workspace. It is the bridge between your agent and the Telegram Bot API. ## Overview - **Category:** talk-to-me - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Vg8MzVtQU1vcw0I0oCEIcvZHYjA3i26my3VqsEZx/ai-agent-connect - **Tags:** bot-api, instant-messaging, notifications, chat-automation, webhook, media-delivery ## Description This Telegram Bot MCP connects your AI client to your personal Telegram bot. Imagine you're running a massive community and need to push out updates across dozens of channels simultaneously. Instead of opening a separate app and clicking through menus, you just tell your AI client what to say. It handles the heavy lifting of broadcasting announcements, forwarding messages from one group to another, or checking how many people are in a specific chat. It turns your Telegram bot into an active participant in your automated workflows. Because Vinkius makes it easy to manage these connections, you can swap between different tasks without context switching. You can send a file to a customer or prune a group's admin list by giving your agent plain-English instructions. If you need to keep your channels updated with the latest news, your agent can grab a URL and post it with a caption immediately. If you want to keep your group clean, your agent can scan for specific types of messages and remove them. This means you don't have to be glued to your phone or a desktop app all day. You can set up complex sequences where your agent monitors incoming pings and reacts with specific files or text. It turns a manual, multi-step process into a single conversation with your AI. ## Tools ### get_chat_info The get_chat_info tool pulls the basic details of a group or channel. Use it to verify chat settings and status. ### get_bot_info The get_bot_info tool pulls your bot's profile details. This is useful for verifying your bot's identity and config. ### get_updates The get_updates tool shows what users are sending to your bot. This is the primary way to monitor incoming pings. ### delete_message The delete_message tool removes a message from a chat. Use this to clean up spam or old content automatically. ### forward_message The forward_message tool moves a message from one chat to another. It is great for migrating info without retyping it. ### get_chat_admins The get_chat_admins tool shows who has admin rights in a group. Use this to audit your permissions and security. ### get_chat_members_count The get_chat_members_count tool shows the size of a chat. It helps you track community growth over time. ### get_user_profile_photos The get_user_profile_photos tool shows the sizes of a user's profile photos. Use this to check media availability. ### send_audio The send_audio tool sends an audio file to a specific chat. It works for podcasts or voice notes. ### send_document The send_document tool shares a file or PDF with a chat. This is the go-to for sending whitepapers and logs. ### send_message The send_message tool sends text to any chat. You can use Markdown or HTML to style the text for better readability. ### send_photo The send_photo tool posts a photo with an optional caption. Great for visual updates and news. ### send_video The send_video tool shares a video file in a chat. It works for clips, tutorials, and demos. ## Prompt Examples **Prompt:** ``` Alert my channel @news_hub that the site is down for maintenance. ``` **Response:** ``` ### Maintenance Alert Sent I've posted the following message to **@news_hub**: > **⚠️ Maintenance Notice** > Our site is currently down for scheduled maintenance. We expect to be back online in 30 minutes. **Details:** - **Status:** Offline - **Estimated Time:** 30 minutes - **Reason:** Database optimization ``` **Prompt:** ``` How many people are in the community group? ``` **Response:** ``` ### Community Statistics I checked the group details for you: - **Group Name:** Tech Community - **Total Members:** 1,247 - **Admin Count:** 5 *Note: Member counts are pulled in real-time.* ``` **Prompt:** ``` Forward the last message from the support chat to the dev channel. ``` **Response:** ``` ### Message Forwarded I've moved the latest message from the **Support Chat** to the **Dev Channel**. **Original Message:** "The login button is returning a 500 error on mobile." **Forward Status:** Success **Destination:** @dev_channel ``` ## Capabilities ### Send multi-media messages Dispatch photos, videos, and audio files to any chat. ### Manage group memberships Get member counts and admin lists for any chat. ### Format text content Send messages using Markdown or HTML for rich styling. ### Handle message history Forward messages or delete old ones automatically. ### Fetch bot profile data Get your bot's username and configuration details. ## Use Cases ### Community Alerts A manager asks their agent to notify 20 groups about a server restart. The agent sends a notification to every channel instantly. ### Support Routing A support lead asks the agent to forward a customer's message to the tech team. The agent moves the content to a different chat. ### Media Distribution A creator asks the agent to share a new tutorial video in a channel. The agent posts the media with a custom caption. ### Member Auditing A group owner asks who are the admins in my group. The agent pulls the current permission list in seconds. ## Benefits - Send formatted updates with Markdown or HTML to reach your audience with clear structure. - Manage large-scale broadcasts by sharing files and images across multiple channels at once. - Keep your communities clean by automatically removing spam or outdated content. - Track your growth and engagement by pulling live data like member counts and chat settings. - Simplify administrative tasks by auditing permissions without ever opening the Telegram app. ## How It Works The bottom line is you get a direct line of command between your AI agent and your Telegram bot. 1. Get your Bot Token from BotFather. 2. Connect the Telegram Bot MCP via Vinkius. 3. Give your AI client permission to send commands. ## Frequently Asked Questions **Can the Telegram Bot MCP send images and videos to my groups?** Yes, it can send photos, videos, and audio files to any chat or channel. You just tell your AI client which file to share and which group it belongs to. **How does the Telegram Bot MCP handle message formatting?** It supports both Markdown and HTML parsing. This means your AI can send messages with bold text, italics, links, and structured lists. **Can I use this to manage my Telegram group admins?** Yes, the Connector can pull the list of current administrators for any chat. This makes it easy to audit your permissions without opening the Telegram app. **Is the Telegram Bot MCP good for community broadcasting?** It is ideal for broadcasting. You can ask your AI client to send a specific message to multiple channels at once, saving you from manual copy-pasting. **Can the Telegram Bot MCP delete messages for me?** Yes, it can delete messages from a chat. This is useful for cleaning up spam or removing outdated information automatically. **Does the Telegram Bot MCP work with Claude or Cursor?** Yes, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf, allowing you to control your bot through those apps. **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.