# Telegram Bot API MCP for AI Agents AI Agent Connect > Telegram Bot API MCP. Connect your AI client to Telegram to send messages, manage groups, and handle bot updates. Automate push notifications and media distribution directly from your prompt without needing to manage a separate dashboard or complex backend code. ## Overview - **Category:** talk-to-me - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_EBBLcQMGyuo21nzlMOK9XJu9nwvOIk3w1AQJjgaB/ai-agent-connect - **Tags:** instant-messaging, bot-integration, push-notifications, automated-replies, group-management, media-distribution ## Description This Connector gives your AI client a direct line to the Telegram platform. Instead of toggling between different tabs and manually copy-pasting text, your agent can act as a certified bot. It handles the heavy lifting of checking for new messages, replying to users, and managing group permissions. You can have your agent monitor a specific chat for keywords, send out formatted alerts when a build fails, or even moderate content by deleting inappropriate posts. It works by pulling in the actual Telegram Bot API capabilities, meaning your AI can send photos, documents, and text messages just like a human would. It is a core part of the Vinkius catalog, making it easy to bridge the gap between your local workflow and your global community. You get a way to manage a massive audience without the overhead of a traditional dashboard. This setup allows you to build functional community tools or automated alert systems in minutes by simply describing the desired outcome to your agent. ## Tools ### get_chat_member_count Tells you the total number of people in a specific chat. Use this to track your community growth over time. ### get_chat_details Fetches the basic info for a user, group, or channel. It provides context on the chat type and identity. ### get_bot_info Retrieves the username, ID, and other basic bot details. Use this to verify your bot's current configuration. ### delete_chat_message Removes a specific message from a chat permanently. This helps keep your community channels clean of spam. ### forward_message Moves a message from one chat to another while keeping the original sender info. Use this to move queries to private channels. ### get_chat_member Pulls specific details about a single member in a chat. This is useful for identifying specific users in a large group. ### pin_chat_message Fixes a message to the top of a chat so everyone sees it first. Use this for important rules or links. ### unpin_chat_message Removes a pinned message from the top of a chat. Use this when you need to update a featured announcement. ### edit_message_text Changes the text of a message you already sent. This is great for fixing typos or updating live status messages. ### list_chat_administrators Shows a list of everyone with admin rights in a group or channel. This is perfect for auditing your permissions. ### list_bot_updates Pulls in the latest messages and user interactions from your bot. This is how your agent sees what people are saying. ### send_document_by_url Sends a file to a chat using a public web link. Use this to share PDFs or other documents with your audience. ### send_text_message Sends a plain text message to a specific chat or user. This is the primary way to send replies and alerts. ### send_photo_by_url Sends an image to a chat using a public web link. Use this to push screenshots or banners to your members. ## Prompt Examples **Prompt:** ``` Check if anyone asked for the status in the last 5 minutes and reply with the link. ``` **Response:** ``` I've checked the latest updates. **Recent Activity:** - User_88: 'Is the site down?' - User_12: 'Need the status link.' I've sent the following reply to User_12: > *System Status:* All systems operational. You can view the live dashboard here: [link] ``` **Prompt:** ``` Who are the admins in the main channel and how many members do we have? ``` **Response:** ``` Here is the current audit for the main channel: **Administrators:** - @Admin_Alpha - @Mod_Beta - @System_Bot **Total Members:** 1,240 ``` **Prompt:** ``` Send a message to the group saying the maintenance is over. ``` **Response:** ``` Done. I've sent the following message to the group: *Maintenance Complete* 🚀 All services are back online. Thanks for your patience! ``` ## Capabilities ### Send text and media Push photos, documents, and text messages to specific chats or users. ### Moderate chat content Delete or edit existing messages to keep conversations clean. ### Monitor live updates Pull in new messages and user interactions in real time. ### Manage group permissions Check who is an admin and count how many members are in a chat. ### Pin and organize Keep important announcements at the top of a group or channel. ## Use Cases ### Automated Customer Support A developer needs to test a help bot. They use list_bot_updates to see queries and send_text_message to provide answers. ### Community Permission Audits A community manager needs to audit a group. They use list_chat_administrators to see who has power and get_chat_member_count to check size. ### Instant DevOps Alerts A DevOps engineer wants alerts. They use send_photo_by_url to push a screenshot of a failed build to a dedicated alert channel. ### Spam and Content Moderation A moderator needs to clean a chat. They use delete_chat_message to remove spam and edit_message_text to correct a pinned announcement. ## Benefits - Automate responses by using list_bot_updates to see what people are saying and send_text_message to reply instantly. - Manage large communities by using list_chat_administrators to audit permissions and get_chat_member_count to track growth. - Clean up your channels by using delete_chat_message to remove spam or edit_message_text to fix typos in old posts. - Distribute content easily by using send_photo_by_url and send_document_by_url to push assets from the web. - Keep users informed by using pin_chat_message to highlight rules or important links in your group. - Reduce manual work by using forward_message to move important user queries from a public group to a private one. ## How It Works The bottom line is that your AI becomes a functional Telegram bot that can read, write, and manage content autonomously. 1. Get a bot token from Telegram's BotFather and add it to your Vinkius MCP settings. 2. Give your AI client permission to access the Telegram Bot API. 3. Ask your agent to perform tasks like sending an alert or checking for new messages. ## Frequently Asked Questions **Can the Telegram Bot API MCP send images to my group?** Yes, it can send images to any chat or group where the bot is a member. You just need to provide a public URL for the image. **How do I use the Telegram Bot API MCP for moderation?** You can use it to delete spam, edit incorrect messages, and pin important announcements. Your AI agent can monitor the chat and act on these tasks automatically. **Does the Telegram Bot API MCP work for private chats?** It works for any chat the bot is invited to, including private messages from users who interact with your bot. **Can I use the Telegram Bot API MCP to see who is an admin?** Yes, the Connector can list all administrators for a specific group or channel, which is great for auditing your permissions. **How do I get started with the Telegram Bot API MCP?** You'll need to create a bot on Telegram via @BotFather to get a token. Once you have that, you can add it to your Vinkius MCP settings and start giving your AI commands. **Can the Telegram Bot API MCP send files like PDFs?** Yes, it can send documents or files to a chat using a direct download link from the web. **Can it read incoming messages?** Yes. Use `list_bot_updates` to pull the latest unacknowledged messages sent to your bot. This uses long polling — no webhook server required. **Can it send images and documents?** Yes. Use `send_photo_by_url` and `send_document_by_url` to share media by providing a public URL. The files are delivered directly to the target chat. **How do I create a bot token?** Open Telegram and message `@BotFather`. Send `/newbot`, follow the prompts to name your bot, and copy the HTTP API token it provides. Paste it into the field below.