# Telegram Bot MCP for AI Agents AI Agent Connect

> Telegram Bot lets you manage your entire Telegram bot presence through your AI client. You can send messages, upload photos, audit group members, and configure webhooks without ever opening a terminal. It turns bot administration into a natural conversation, letting your agent handle the heavy lifting of community management and messaging workflows.

## Overview
- **Category:** talk-to-me
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_FzVKXnygLyz0NR5IlCpxdCkTt1Yw5XjzgboUWNj5/ai-agent-connect
- **Tags:** bot-management, chat-administration, real-time-messaging, webhook, api-integration, notifications

## Description

The Telegram Bot MCP lets you manage your entire Telegram bot presence through your AI client. It turns bot administration into a natural conversation by letting your agent handle the direct interaction with the Telegram Bot API. Instead of writing scripts to fetch member counts or send broadcast messages, you just tell your agent what needs to happen. You can ask it to check who the admins are in a specific group or send out a photo with a specific caption. It handles the backend communication while you stay in your workspace. Whether you're running a support channel or a massive community, this tool makes it easy to keep things running. You can find this and thousands of other tools in the Vinkius catalog to keep your workflows organized. It's about moving from manual commands to natural conversation.

## Tools

### get_me
Fetch the basic profile details and identity of your Telegram bot. This helps you confirm the bot is active and correctly configured.

### get_updates
Pull the most recent messages and events sent to your bot. You can use this to see what users are saying in real time.

### get_webhook_info
Check the current status of your bot's webhooks. It tells you if your updates are being sent to the right place.

### leave_chat
Have your bot exit a specific group or private chat. This is useful for cleaning up old connections or moving to new groups.

### delete_webhook
Remove an existing webhook from your bot. Use this when you need to reset your connection or switch providers.

### get_chat_administrators
List all the administrators in a specific chat and their permissions. It makes auditing your group roles much faster.

### get_chat_member_count
Get the current number of members in a group or supergroup. Use this to track your community growth over time.

### get_chat
Retrieve the metadata and general details for a specific chat. It gives you a quick overview of a group's properties.

### get_file
Grab the specific information and metadata for files shared with your bot. This helps you keep track of shared media.

### send_message
Send text messages to any chat or user your bot has access to. It lets you push out updates or replies instantly.

### send_photo
Upload and send images to users or groups with custom captions. Use this to share visual content with your community.

### set_webhook
Configure a new webhook URL to receive real-time updates from Telegram. This is the primary way to connect your bot to external services.

## Prompt Examples

**Prompt:** 
```
Who is currently managing my group?
```

**Response:** 
```
I've checked the permissions for that group. Here are the current administrators:

| Admin Name | Role |
| :--- | :--- |
| Marcus R. | Owner |
| Jane Doe | Admin |
| BotAssistant | Admin

Would you like me to check their specific permission sets?
```

**Prompt:** 
```
Send a welcome photo to the group.
```

**Response:** 
```
Done! I've sent the welcome photo to the group. 

**Details:**
- **Status:** Delivered
- **Caption:** Welcome to our community! Please read the rules in the pinned message.
```

**Prompt:** 
```
Check my webhook status.
```

**Response:** 
```
I've retrieved your webhook information:

- **URL:** https://api.yourdomain.com/webhook
- **Status:** Active
- **Last Update:** 2 minutes ago

Everything looks like it's working correctly.
```

## Capabilities

### Send Rich Media
Your agent sends formatted text messages and photos to users or groups instantly.

### Audit Group Members
Quickly see who is in a chat and what specific permissions they have.

### Manage Webhooks
Set up, delete, or check the status of your bot's webhooks for real-time data.

### Handle Media Files
Retrieve specific information about files shared with your bot to keep content organized.

### Automate Group Exits
Have your agent remove the bot from groups that no longer meet your criteria.

## Use Cases

### Community Growth Tracking
A community manager asks their agent to check the member count and list the admins for a new group. The agent uses get_chat_member_count and get_chat_administrators to provide a summary.

### Rapid Support Response
A support lead needs to send a photo of a setup guide to a group. They ask the agent to send the photo, which uses send_photo to deliver the content instantly.

### Webhook Troubleshooting
A developer notices a bot is not responding. They ask the agent to check the webhook status and update the URL using get_webhook_info and set_webhook.

### Bot Cleanup
An operations lead wants to remove a bot from 50 old groups. They ask the agent to identify and leave those chats using leave_chat.

## Benefits

- Send out broadcast updates instantly using send_message without needing to write custom scripts or switch to a separate dashboard.
- Audit your entire group hierarchy in seconds with get_chat_administrators to ensure only the right people have permissions.
- Monitor your bot health and connectivity by checking webhook statuses with get_webhook_info or set_webhook directly.
- Keep your community organized by using get_chat_member_count to track growth and get_chat for a quick overview of group details.
- Share visual content and instructions with your users by using send_photo to push images and captions to any group.
- Manage your bot's footprint efficiently by using leave_chat to remove the bot from groups that no longer meet your criteria.

## How It Works

The bottom line is you get a conversational interface for every major Telegram Bot API action.

1. Subscribe to this Connector
2. Enter your Telegram Bot Token from @BotFather
3. Ask your agent to send a message or check a group status

## Frequently Asked Questions

**Can I use Telegram Bot MCP to send photos to my group?**
Yes, your agent can send photos directly to any group or user your bot is part of. You just describe the photo and the caption you want to include.

**How does Telegram Bot MCP help with group moderation?**
It allows your agent to audit group administrators and member counts instantly. This makes it much easier to manage permissions and keep your community organized.

**Can Telegram Bot MCP manage my bot's webhooks?**
Yes, it can set, delete, and check the status of your webhooks. This is great for ensuring your bot stays connected to your external services.

**Is Telegram Bot MCP good for community management?**
It's ideal for community managers who need to send announcements, check group status, and manage member roles without manually typing commands into a terminal.

**How do I get my bot token for Telegram Bot MCP?**
You can get your token from @BotFather on Telegram. Once you have it, you just provide it to your agent to start managing your bot.

**Can Telegram Bot MCP help me audit my chats?**
Absolutely. Your agent can pull details for specific chats and list all current administrators, providing a clear view of who has access to your spaces.

**How do I get my Telegram Bot Token?**
Message [**@BotFather**](https://t.me/botfather) on Telegram and follow the simple steps to create a new bot. He will provide a token string which you should paste here.

**Can the agent send images to a group?**
Yes. Use the `send_photo` tool providing the target Chat ID and a public image URL. Your agent will confirm the delivery and provide the message metadata.

**Is it possible to check who are the administrators of a chat?**
Yes. The `get_chat_administrators` tool retrieves a list of all users with admin privileges in a specific group or channel, including their custom titles.