Telegram Bot API Connector for AI agents.
13 live capabilities
Automate community messaging and chat management via your AI client.
Waiting for input…
Why people use Telegram Bot API
Telegram Bot Chat Automation: Stop the manual grind of copy-pasting
With this Connector, you just tell your AI client what needs to happen. It handles the broadcasting to every channel, forwards specific messages, and updates your records in one go. You get a way to manage your entire community from a single chat window.
What Vinkius changes
You get a direct line of command between your AI agent and your Telegram bot.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Community Alerts
A manager asks their agent to notify 20 groups about a server restart.
- Real-world use case 02
Support Routing
A support lead asks the agent to forward a customer's message to the tech team.
- Real-world use case 03
Media Distribution
A creator asks the agent to share a new tutorial video in a channel.
Complete set · 13capabilities
The complete Telegram Bot API capability set.
These are the exact actions your AI can choose when you ask it to work with Telegram Bot API.
01—04
4 capabilities in this set.
Part of 13 available through Telegram Bot API.
- 01 Capability
Get chat info
The get_chat_info capability pulls the basic details of a group or channel. Use it to verify chat settings and status.
- 02 Capability
Get bot info
The get_bot_info capability pulls your bot's profile details. This is useful for verifying your bot's identity and config.
- 03 Capability
Get updates
The get_updates capability shows what users are sending to your bot. This is the primary way to monitor incoming pings.
- 04 Capability
Delete message
The delete_message capability removes a message from a chat. Use this to clean up spam or old content automatically.
05—07
3 capabilities in this set.
Part of 13 available through Telegram Bot API.
- 05 Capability
Forward message
The forward_message capability moves a message from one chat to another. It is great for migrating info without retyping it.
- 06 Capability
Get chat admins
The get_chat_admins capability shows who has admin rights in a group. Use this to audit your permissions and security.
- 07 Capability
Get chat members count
The get_chat_members_count capability shows the size of a chat. It helps you track community growth over time.
08—10
3 capabilities in this set.
Part of 13 available through Telegram Bot API.
- 08 Capability
Get user profile photos
The get_user_profile_photos capability shows the sizes of a user's profile photos. Use this to check media availability.
- 09 Capability
Send audio
The send_audio capability sends an audio file to a specific chat. It works for podcasts or voice notes.
- 10 Capability
Send document
The send_document capability shares a file or PDF with a chat. This is the go-to for sending whitepapers and logs.
11—13
3 capabilities in this set.
Part of 13 available through Telegram Bot API.
- 11 Capability
Send message
The send_message capability sends text to any chat. You can use Markdown or HTML to style the text for better readability.
- 12 Capability
Send photo
The send_photo capability posts a photo with an optional caption. Great for visual updates and news.
- 13 Capability
Send video
The send_video capability shares a video file in a chat. It works for clips, tutorials, and demos.
Set up in minutes
One URL. Then ask Telegram Bot API to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Telegram Bot API from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_Vg8MzVtQU1vcw0I0oCEIcvZHYjA3i26my3VqsEZx/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Telegram Bot API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Telegram Bot API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_Vg8MzVtQU1vcw0I0oCEIcvZHYjA3i26my3VqsEZx/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Telegram Bot API URL.
- Step 03
Save and start
Save the connection and enable Telegram Bot API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"telegram-bot": {
"url": "https://edge.vinkius.com/vk_preview_Vg8MzVtQU1vcw0I0oCEIcvZHYjA3i26my3VqsEZx/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Telegram Bot API
Open Agent mode in chat and ask: "Using Telegram Bot API, help me...". 13 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"telegram-bot": {
"url": "https://edge.vinkius.com/vk_preview_Vg8MzVtQU1vcw0I0oCEIcvZHYjA3i26my3VqsEZx/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Telegram Bot API
Ask Copilot: "Using Telegram Bot API, help me...". 13 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"telegram-bot": {
"url": "https://edge.vinkius.com/vk_preview_Vg8MzVtQU1vcw0I0oCEIcvZHYjA3i26my3VqsEZx/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Telegram Bot API
Open Cascade and ask: "Using Telegram Bot API, help me...". 13 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"telegram-bot": {
"url": "https://edge.vinkius.com/vk_preview_Vg8MzVtQU1vcw0I0oCEIcvZHYjA3i26my3VqsEZx/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Telegram Bot API
Ask Cline: "Using Telegram Bot API, help me...". 13 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add telegram-bot --transport http "https://edge.vinkius.com/vk_preview_Vg8MzVtQU1vcw0I0oCEIcvZHYjA3i26my3VqsEZx/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Telegram Bot API
Ask Claude: "Using Telegram Bot API, show me...". 13 tools are ready
Where the request belongs
Work Telegram Bot API can move forward.
Community managers, automation engineers, and support leads who need to manage high-volume Telegram traffic without manual clicking.
Community Manager
Sends out daily updates to 50+ groups at once and monitors member growth.
Automation Engineer
Sets up automated alerts and notification pipelines from external scripts to Telegram.
Support Team Lead
Routes customer messages between different chat departments using automated forwarding.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsTelegram Bot
Control and manage your Telegram bots. send messages, photos, and audit chats via AI.
Telegram Bot API
Connect your AI natively to Telegram. Read user messages, administrate chats, send push notifications, and automate media distribution directly from the prompt.
Telegram Bot Notifier
This MCP does exactly one thing: it sends messages to your Telegram chats. That's its only function, and nothing else. Incredible for giving your AI agents a voice on mobile.
Wati
Send WhatsApp messages at scale with official API access, chatbot automation, and shared team inbox for business conversations.
Netease Yunxin IM
Equip your AI Agent with Netease Yunxin to massively manage Live Chat Rooms, moderate IM participants, and broadcast messages.
Sendbird
Manage Sendbird chat infrastructure. orchestrate users, channels, and moderation directly from your AI agent.
Bring your own AI
Change the model, client or framework. Keep Telegram Bot API connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Telegram Bot API.
The practical details behind the request, access and result.
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 capability 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.
One connection away
Give your agent a direct line to Telegram Bot API.
Connect Telegram Bot API once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available