# Telegram Bot MCP

> Telegram Bot MCP lets you automate everything that happens inside your Telegram chats and groups. Use natural language commands from any AI client to broadcast announcements, manage media, monitor group membership, or route customer service messages—all programmatically.

## Overview
- **Category:** talk-to-me
- **Price:** Free
- **Tags:** bot-api, instant-messaging, notifications, chat-automation, webhook, media-delivery

## Description

Need to control a Telegram bot without opening the app? This MCP connects your existing bot directly to your agent, letting you automate complex communication tasks through simple conversation. You can send rich content—photos, documents, videos, and audio files—or just plain text formatted with Markdown or HTML. It also handles chat management; check who's in a group, find out how many members are online, or see the list of administrators. If you're building an AI workflow that needs to interact with people via Telegram, this MCP is what you need. Since Vinkius hosts thousands of connectors, integrating your bot into any agent flow—whether running on Claude, Cursor, or Windsurf—is straightforward and reliable.

## Tools

### delete_message
Deletes a message from any Telegram chat.

### forward_message
Forwards a specific message within a Telegram chat.

### get_chat_admins
Retrieves the current list of administrators in a given chat.

### get_chat_members_count
Returns the total number of members currently in a Telegram group or channel.

### get_chat_info
Retrieves general details about a specific Telegram chat, including its type and ID.

### get_bot_info
Fetches configuration information about your connected bot itself.

### get_updates
Retrieves the latest activity or updates that have happened within the Telegram bot's scope.

### get_user_profile_photos
Returns a list of available photo sizes for a user's profile pictures.

### send_audio
Sends an audio file directly to a specified Telegram chat.

### send_document
Transmits a document, like a PDF or ZIP file, into a Telegram chat.

### send_message
Sends formatted text messages to a Telegram chat, supporting Markdown and HTML styling.

### send_photo
Delivers an image photo to a Telegram chat; you can optionally include a caption with it.

### send_video
Transmits a video file into a specified Telegram chat.

## Prompt Examples

**Prompt:** 
```
Get information about my Telegram bot.
```

**Response:** 
```
Your bot 'MyAssistantBot' (@my_assistant_bot) is active. Bot ID: 123456789. It's currently configured to handle messages and commands.
```

**Prompt:** 
```
Send a message to my channel @mychannel saying 'Hello everyone!'
```

**Response:** 
```
Message sent successfully to @mychannel. The message ID is 456 and was delivered at 2024-01-01 10:00:00 UTC.
```

**Prompt:** 
```
How many members are in my group -1001234567890?
```

**Response:** 
```
Your group 'Tech Community' currently has 1,247 members. It's a supergroup with public visibility.
```

## Capabilities

### Broadcast and Format Content
Send text messages with rich formatting (Markdown/HTML), photos, documents, videos, and audio to any chat or channel.

### Monitor Chat Status
Retrieve detailed information about a chat, including the total member count or a list of who the admins are.

### Process Message History
Fetch recent updates from users or programmatically forward and delete specific messages within any group.

## Use Cases

### Onboarding New Users
A Community Manager needs to welcome new subscribers. They ask their agent, 'Send a warm welcome message and attach the PDF guide.' The agent then uses `send_document` and `send_message` to deliver the full kit automatically.

### Incident Alerting
A DevOps engineer needs to alert a team about a system failure. Instead of writing multiple messages, they instruct their agent: 'Send an urgent alert photo and a diagnostic report document.' The agent uses `send_photo` and `send_document`.

### Support Escalation
A support team member needs to hand off a chat. They ask the agent: 'Forward this entire conversation thread, including all media, to the Billing department.' The agent uses `forward_message` to keep the context intact.

### Auditing Group Membership
A moderator needs to check if certain users have been promoted. They ask their agent for 'the list of admin usernames in this group.' The agent executes `get_chat_admins` and provides the list.

## Benefits

- Stop manual broadcasting. You can send announcements to entire channels and groups using the `send_message` tool, eliminating one-by-one posting.
- Get real-time insights into community size. Use `get_chat_members_count` to know exactly how many people are in a group without checking the app.
- Manage support conversations efficiently. You can retrieve chat history using `get_updates`, allowing your agent to build context before responding.
- Control message flow. Need to clean up a thread? Use `delete_message` or `forward_message` to manage content programmatically.
- Deliver complex media packages. Send everything from simple text with formatting via `send_message` all the way up to large documents using `send_document`.

## How It Works

The bottom line is that once connected, you treat your Telegram bot like any other service tool, controlling it entirely through conversation.

1. Subscribe to this MCP on Vinkius and provide your unique Telegram Bot Token, which you get from BotFather.
2. Connect your preferred AI client—like Claude or Cursor—to the Vinkius catalog.
3. Use natural language commands in your agent. Your agent executes the necessary API calls to control your bot.

## Frequently Asked Questions

**How do I send formatted text using Telegram Bot MCP?**
You use the `send_message` tool. This function supports both Markdown and HTML formatting, so you can make your announcements look professional right out of the gate.

**Can I track who is in a chat using get_chat_members_count?**
Yes, `get_chat_members_count` provides an accurate count of members. It's useful for knowing if your broadcast reached the expected audience size.

**What is the difference between send_photo and send_document?**
Use `send_photo` when you are delivering a visual image, which might include an optional caption. Use `send_document` for files like PDFs or ZIPs that need to be downloaded by the recipient.

**Does Telegram Bot MCP handle message replies?**
You can manage message history using tools like `forward_message`. This allows you to pass along context from one user to another, which is essential for support roles.