electrical_services

Telegram MCP Server — Hosted Api Connectors Integration

MCP Server language Hosted language Public

Send messages, manage groups, run polls, and moderate Telegram communities — full Bot API access for AI agents.

@aerostack verified

• v0.1.0 • MIT • Updated Jun 28, 2026

add_circleAdd to Workspace

robot_2

Use with AI AssistantsMCP

Connect Claude, Cursor, or any MCP-compatible client — then call tools directly

① Add This MCP Server

Paste into your AI client config — then all its tools are available instantly.

.claude/mcp.json

{
  "mcpServers": {
    "telegram": {
      "url": "https://mcp.aerostack.dev/s/aerostack/mcp-telegram",
      "headers": {
        "Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
      }
    }
  }
}

Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.

② Call a Tool

Ask your AI assistant to call a specific tool, or send raw JSON-RPC:

+23 more

Natural Language Prompt

“Use the _ping tool to verify bot token by calling getme. used internally by aerostack to validate credentials”

Using a Workspace?

Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.

add_circleAdd to Workspace

description Overview

mcp-telegram — Telegram MCP Server

Build and operate Telegram bots from AI agents — send messages, manage groups and channels, moderate members, and run polls programmatically.

Telegram is a messaging platform with 900M+ active users and a powerful Bot API used by businesses for notifications, support, and community management. This MCP server gives your agents complete access to the Telegram Bot API: sending text, photos, documents, polls, and invoices; managing group and channel members; setting roles and permissions; pinning messages; and handling bot commands.

Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-telegram

What You Can Do

Send automated notifications to Telegram groups or channels from any system event or trigger
Moderate community groups — ban, restrict, or promote members based on automated rules
Create and manage polls to gather community feedback directly in Telegram
Build a full-featured Telegram bot assistant that handles commands, messages, and member events

Available Tools

Tool	Description
get_me	Get the bot's own profile information
get_my_commands	Get the list of commands registered for the bot
set_my_commands	Set the list of bot commands shown in the Telegram UI
get_webhook_info	Get current webhook configuration
get_updates	Get incoming updates (messages, callbacks) via long polling
get_chat_history	Get recent messages from a chat or group
send_message	Send a text message to a chat with Markdown/HTML formatting support
send_photo	Send a photo to a chat with optional caption
send_document	Send a document/file to a chat
send_poll	Send a poll to a group or channel
send_invoice	Send a payment invoice via Telegram Payments
edit_message	Edit an existing message text
delete_message	Delete a message from a chat
get_chat	Get details of a chat, group, or channel
get_chat_member	Get a specific member's status in a group or channel
get_chat_member_count	Get the total member count of a chat
get_chat_administrators	List all administrators in a group or channel
get_user_profile_photos	Get profile photos of a user
get_file	Get a file uploaded to Telegram by file ID
ban_member	Ban a user from a group or channel
unban_member	Unban a previously banned user
restrict_member	Restrict a member's permissions (mute, disable media, etc.)
promote_member	Promote a member to administrator with specific permissions
pin_message	Pin a message in a group or channel
set_chat_title	Update the title of a group or channel
set_chat_description	Update the description of a group or channel
create_invite_link	Generate a new invite link for a group or channel
send_chat_action	Send a typing/uploading indicator to a chat

Configuration

Variable	Required	Description	How to Get
TELEGRAM_BOT_TOKEN	Yes	Telegram Bot API token	Talk to @BotFather on Telegram → /newbot or /token

Quick Start

Add to Aerostack Workspace

Go to aerostack.dev → Your Project → MCPs
Search for "Telegram" and click Add to Workspace
Add your TELEGRAM_BOT_TOKEN under Project → Secrets

Once added, every AI agent in your workspace can send messages and manage your Telegram bot automatically — no per-user setup needed.

Example Prompts

"Send a message to our #alerts Telegram group: 'Deployment to production completed successfully'"
"Create a poll in the community channel asking users which feature they want next"
"Ban the user who has been spamming in our Telegram group — user ID 123456789"

Direct API Call

curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-telegram \
  -H 'Content-Type: application/json' \
  -H 'X-Mcp-Secret-TELEGRAM-BOT-TOKEN: your-token' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"send_message","arguments":{"chat_id":"-1001234567890","text":"Hello from the AI agent!"}}}'

License

MIT

terminal Tools (29)

Available tools on this MCP server. Each tool can be called directly from any AI agent.

terminal

_ping #1

Verify bot token by calling getMe. Used internally by Aerostack to validate credentials.

terminal

get_me #2

Get information about the bot itself — username, ID, capabilities (can_join_groups, supports_inline_queries, etc.)

terminal

get_my_commands #3

Get the current command list visible to users in the bot menu. Optionally filter by language.

terminal

set_my_commands #4

Set or replace the bot command list shown to users in the menu. Replaces all existing commands.

terminal

get_webhook_info #5

Get current webhook configuration — URL, pending update count, last error message. Useful for diagnosing webhook issues.

terminal

get_updates #6

Pull pending messages and events via long polling. Use offset (last update_id + 1) to mark previous updates as read. Returns up to 100 updates.

terminal

get_chat_history #7

Get recent messages in a specific chat by filtering updates from getUpdates. NOTE: Bot API has no dedicated getChatHistory endpoint — this tool calls getUpdates with a large limit and filters by chat_id. Only returns messages the bot has received (not full chat history). For complete history, store messages as they arrive.

terminal

send_message #8

Send a text message to a chat. Supports HTML/Markdown formatting, reply buttons, inline keyboard, and reply-to.

terminal

send_photo #9

Send a photo to a chat. Accepts a URL (bot downloads it) or a file_id (previously uploaded photo).

terminal

send_document #10

Send a file/document to a chat. Accepts a URL (bot downloads it) or a file_id.

terminal

send_poll #11

Send a multiple-choice or quiz poll to a chat.

terminal

send_invoice #12

Send a Telegram native payment invoice to a chat. Requires a payment provider token from BotFather.

terminal

edit_message #13

Edit the text of a previously sent message (bot-authored messages only).

terminal

delete_message #14

Delete a message from a chat. Bot must be admin with delete_messages permission in groups/channels.

terminal

get_chat #15

Get detailed information about a chat, group, or channel — title, description, member count, invite link, pinned message.

terminal

get_chat_member #16

Get a specific user's status and permissions in a chat — member/admin/banned, join date, permission flags.

terminal

get_chat_member_count #17

Get the total number of members in a group or channel.

terminal

get_chat_administrators #18

Get the full list of administrators in a group or channel with their permission flags.

terminal

get_user_profile_photos #19

Get a user's profile photo history (returns file_ids — use get_file to get download URLs).

terminal

get_file #20

Get file info and a download URL for any file sent to the bot (photos, documents, audio, etc.).

terminal

ban_member #21

Ban a user from a group or channel. Bot must be admin with ban_users permission.

terminal

unban_member #22

Remove a ban from a user, allowing them to rejoin via invite link.

terminal

restrict_member #23

Restrict a group member's permissions (mute, prevent media/polls/links). Bot must be admin.

terminal

promote_member #24

Grant admin rights to a group/channel member with specific permission flags. Bot must be admin.

terminal

pin_message #25

Pin a message in a group or channel. Bot must have pin_messages permission.

terminal

set_chat_title #26

Rename a group or channel. Bot must be admin with change_info permission.

terminal

set_chat_description #27

Update the description of a group or channel. Bot must be admin with change_info permission.

terminal

create_invite_link #28

Create a unique invite link for a chat with optional expiry, member limit, and join request approval.

terminal

send_chat_action #29

Show a typing/uploading indicator in a chat. Actions auto-clear after 5 seconds or when a message is sent.

Details

upgrade Version 0.1.0

gavel License MIT

wifi Transport streamable-http

lock Access Public

category Category API Connectors

terminal Tools 29

language Live Endpoint

https://mcp.aerostack.dev/s/aerostack/mcp-telegram

Sub-50ms globally · Zero cold start

Publisher

@aerostack verified

Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.

Frequently asked questions

What is the Telegram MCP server and what can it do? +

The Telegram MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `get_me`, `get_my_commands`, `set_my_commands`, `get_webhook_info`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.

Is the Telegram MCP server hosted, or do I have to run it myself? +

It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.

Which AI agents and editors can use the Telegram MCP server? +

Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same Telegram MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.

How do I install the Telegram MCP server in Claude Desktop? +

Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-telegram": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-telegram"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.

How do I use the Telegram MCP server in Cursor? +

In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-telegram", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-telegram"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.

Does Telegram MCP require authentication? +

Yes. Telegram requires authentication. Check the MCP's documentation for the required credentials.

Telegram MCP Server — Hosted Api Connectors Integration

description Overview

mcp-telegram — Telegram MCP Server

What You Can Do

Available Tools

Configuration

Quick Start

Add to Aerostack Workspace

Example Prompts

Direct API Call

License

terminal Tools (29)

Details

Publisher

Tags

More in API Connectors

Aerostack Registry

Algolia

Arangodb

Ayrshare

Basecamp

Bigquery

Frequently asked questions