Telegram Bot API Connector for AI agents.
14 live capabilities
Automate Telegram messaging and group management from your prompt.
Waiting for input…
Why people use Telegram Bot API
Telegram Bot API for automated community management
This Connector lets your AI agent handle those repetitive tasks for you. You can tell your agent to monitor the chat, delete spam, and pin new announcements automatically. It turns your prompt into a command center for your entire Telegram presence.
What Vinkius changes
That your AI becomes a functional Telegram bot that can read, write, and manage content autonomously.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Automated Customer Support
A developer needs to test a help bot.
- Real-world use case 02
Community Permission Audits
A community manager needs to audit a group.
- Real-world use case 03
Instant DevOps Alerts
A DevOps engineer wants alerts.
Complete set · 14capabilities
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 14 available through Telegram Bot API.
- 01 Capability
Get chat member count
Tells you the total number of people in a specific chat. Use this to track your community growth over time.
- 02 Capability
Get chat details
Fetches the basic info for a user, group, or channel. It provides context on the chat type and identity.
- 03 Capability
Get bot info
Retrieves the username, ID, and other basic bot details. Use this to verify your bot's current configuration.
- 04 Capability
Delete chat message
Removes a specific message from a chat permanently. This helps keep your community channels clean of spam.
05—08
4 capabilities in this set.
Part of 14 available through Telegram Bot API.
- 05 Capability
Forward message
Moves a message from one chat to another while keeping the original sender info. Use this to move queries to private channels.
- 06 Capability
Get chat member
Pulls specific details about a single member in a chat. This is useful for identifying specific users in a large group.
- 07 Capability
Pin chat message
Fixes a message to the top of a chat so everyone sees it first. Use this for important rules or links.
- 08 Capability
Unpin chat message
Removes a pinned message from the top of a chat. Use this when you need to update a featured announcement.
09—11
3 capabilities in this set.
Part of 14 available through Telegram Bot API.
- 09 Capability
Edit message text
Changes the text of a message you already sent. This is great for fixing typos or updating live status messages.
- 10 Capability
List chat administrators
Shows a list of everyone with admin rights in a group or channel. This is perfect for auditing your permissions.
- 11 Capability
List bot updates
Pulls in the latest messages and user interactions from your bot. This is how your agent sees what people are saying.
12—14
3 capabilities in this set.
Part of 14 available through Telegram Bot API.
- 12 Capability
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.
- 13 Capability
Send text message
Sends a plain text message to a specific chat or user. This is the primary way to send replies and alerts.
- 14 Capability
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.
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_EBBLcQMGyuo21nzlMOK9XJu9nwvOIk3w1AQJjgaB/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_EBBLcQMGyuo21nzlMOK9XJu9nwvOIk3w1AQJjgaB/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-api": {
"url": "https://edge.vinkius.com/vk_preview_EBBLcQMGyuo21nzlMOK9XJu9nwvOIk3w1AQJjgaB/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...". 14 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"telegram-bot-api": {
"url": "https://edge.vinkius.com/vk_preview_EBBLcQMGyuo21nzlMOK9XJu9nwvOIk3w1AQJjgaB/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...". 14 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"telegram-bot-api": {
"url": "https://edge.vinkius.com/vk_preview_EBBLcQMGyuo21nzlMOK9XJu9nwvOIk3w1AQJjgaB/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...". 14 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"telegram-bot-api": {
"url": "https://edge.vinkius.com/vk_preview_EBBLcQMGyuo21nzlMOK9XJu9nwvOIk3w1AQJjgaB/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...". 14 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add telegram-bot-api --transport http "https://edge.vinkius.com/vk_preview_EBBLcQMGyuo21nzlMOK9XJu9nwvOIk3w1AQJjgaB/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...". 14 tools are ready
Where the request belongs
Work Telegram can move forward.
This is for the developer who needs to build a functional bot quickly without writing backend logic, the community manager juggling dozens of channels, and the DevOps pro who needs instant alerts.
Chatbot Developer
Builds and tests conversational logic by pulling updates and sending replies.
Community Manager
Audits group permissions and manages high-volume chat moderation.
DevOps Engineer
Sets up automated push notifications for system failures or deployment statuses.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsTelegram Bot
Control Telegram bots programmatically. send messages, photos, documents, and manage chats via AI.
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.
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.
PubNub (Real-time Messaging)
Enable real-time messaging, presence tracking, and message history for your AI agent using PubNub's global data stream network.
Wati
Send WhatsApp messages at scale with official API access, chatbot automation, and shared team inbox for business conversations.
Bring your own AI
Change the model, client or framework. Keep Telegram 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.
The practical details behind the request, access and result.
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.
One connection away
Give your agent a direct line to Telegram.
Connect Telegram once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available