How do I connect my own bot?

You need to provide the unique Bot Token you received from BotFather when you set up the MCP on Vinkius.

Which AI clients can I use with this MCP?

You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.

Can I send files through my AI agent?

Yes, the MCP includes capabilities to send photos, videos, audio, and documents to Telegram chats.

Does this MCP host the bot for me?

Vinkius hosts the MCP and manages the connection, so you don't need to run your own local infrastructure.

Can I manage group admins using the AI?

The MCP includes a capability to retrieve the list of chat administrators for any group your bot is in.

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.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Telegram Bot to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Turn your AI client into a powerful Telegram controller.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 13 capabilities

We ship only the actions that matter.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 13 available through Telegram Bot API.

01
Get chat members count
This capability returns the total number of members currently in a specific chat.
02
Get chat info
Use this to pull detailed metadata and configuration settings for a Telegram chat.
03
Get updates
This capability lets your agent see the latest incoming messages and events sent to the bot.
04
Get user profile photos
This capability retrieves a list of available profile photo sizes for a specific user.

Capability set02 / 04

05-07

3 capabilities in this set.

Part of 13 available through Telegram Bot API.

05
Send audio
This capability sends an audio file directly to a designated Telegram chat.
06
Send document
Use this to deliver documents to a chat via URL or file ID.
07
Send photo
This capability sends a photo to a chat and allows for an optional caption.

Capability set03 / 04

08-10

3 capabilities in this set.

Part of 13 available through Telegram Bot API.

08
Send video
This capability handles the delivery of video files to a Telegram chat.
09
Delete message
This capability allows your agent to remove a specific message from a Telegram chat.
10
Forward message
Use this to forward an existing message to another chat or channel.

Capability set04 / 04

11-13

3 capabilities in this set.

Part of 13 available through Telegram Bot API.

11
Get bot info
This capability retrieves the profile and configuration details of your specific Telegram bot.
12
Get chat admins
This capability pulls the list of users who hold administrator privileges in a chat.
13
Send message
This capability sends text messages to a chat using Markdown or HTML formatting.

Real work

What teams actually run

Channel Announcements

Tell your agent to post a specific update to a channel without opening the Telegram app.

System Alerts

Have your agent send automated notifications or documents to a group when a workflow triggers.

Member Audits

Ask your agent for the current member count or admin list of a specific group.

Message Cleanup

Instruct your agent to remove specific messages from a chat programmatically.

Automate a task

Put Telegram Bot API to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Telegram Bot API works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put Telegram Bot API to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

969ms average. Fast in production.

Telegram Bot API is checked daily against the live service.

Daily averagePeak 1113ms

Oct 3Today

Fastest day: 796ms
Slowest day: 1113ms
14-day trend: Slowing+16%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 13 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Telegram Bot API, so you can see the experience inside your AI.

It does not authenticate your account with Telegram Bot API. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Telegram Bot API Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_Vg8MzVtQU1vcw0I0oCEIcvZHYjA3i26my3VqsEZx/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Telegram Bot API capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "telegram-bot-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_Vg8MzVtQU1vcw0I0oCEIcvZHYjA3i26my3VqsEZx/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Telegram Bot API in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Telegram Bot API owners hand off.

This MCP is built for anyone who needs to bridge the gap between an AI agent and a Telegram-based community or workflow.

01
Community Managers
They hand off broadcast tasks and channel announcements to the agent.
02
Automation Engineers
They use the agent to trigger Telegram notifications within larger automated workflows.
03
Support Teams
They delegate chat management and message forwarding to the agent.

FAQ

Questions Telegram Bot API owners ask.

01
How do I connect my own bot?
You need to provide the unique Bot Token you received from BotFather when you set up the MCP on Vinkius.
02
Which AI clients can I use with this MCP?
You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.
03
Can I send files through my AI agent?
Yes, the MCP includes capabilities to send photos, videos, audio, and documents to Telegram chats.
04
Does this MCP host the bot for me?
Vinkius hosts the MCP and manages the connection, so you don't need to run your own local infrastructure.
05
Can I manage group admins using the AI?
The MCP includes a capability to retrieve the list of chat administrators for any group your bot is in.
06
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...).
07
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.
08
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.

Explore

More in Talk To Me

Connect Telegram Bot API to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Get chat members count

Get chat info

Get updates

Get user profile photos

05-07

Send audio

Send document

Send photo

08-10

Send video

Delete message

Forward message

11-13

Get bot info

Get chat admins

Send message

What teams actually run

Channel Announcements

System Alerts

Member Audits

Message Cleanup

Building your own app? The connector is yours to use.

Telegram Bot API Connector

Claude Desktop

Community Managers

Automation Engineers

Support Teams

How do I connect my own bot?

Which AI clients can I use with this MCP?

Can I send files through my AI agent?

Does this MCP host the bot for me?

Can I manage group admins using the AI?

How do I get a Telegram Bot Token?

Can I send messages to specific groups or channels?

What media types can the bot send?

Telegram Bot API AI Connector

Telegram Bot Notifier AI Connector

Telegram Bot AI Connector

Google Chat Webhook Notifier AI Connector

Suggestions

Discord Webhook Notifier AI Connector

ChatBot.com AI Connector

ChatFly AI Connector

The Botforge AI Connector