Send messages, manage groups, run polls, and moderate Telegram communities — full Bot API access for AI agents.
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.
{
"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:
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.
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
| 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 |
| Variable | Required | Description | How to Get |
|---|---|---|---|
| TELEGRAM_BOT_TOKEN | Yes | Telegram Bot API token | Talk to @BotFather on Telegram → /newbot or /token |
TELEGRAM_BOT_TOKEN under Project → SecretsOnce added, every AI agent in your workspace can send messages and manage your Telegram bot automatically — no per-user setup needed.
"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"
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!"}}}'
MIT
Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-telegram
Sub-50ms globally · Zero cold start
@aerostack
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
by @aerostack
Discover and invoke any MCP, Function, or Skill published to the Aerostack marketplace — the universal AI capability hub.
by @aerostack
Search indexes, manage records, browse data, and configure ranking in Algolia — AI-native instant search access.
by @aerostack
Query documents, run AQL, traverse graphs, and manage collections in your ArangoDB database — AI-native multi-model database access.
by @aerostack
Post, schedule, and analyze social media across 13 platforms — Facebook, Instagram, X, LinkedIn, TikTok, Bluesky, Threads, Reddit, Pinterest, YouTube, Telegram, Snapchat, Google Business.
by @aerostack
Manage projects, to-dos, messages, schedules, and campfire chats in Basecamp — AI-native project management.
by @aerostack
Run SQL queries, list datasets and tables, inspect schemas, and export results from Google BigQuery — AI-native data warehouse access.
Yes. Claude uses get_chat_history to detect violations, then calls ban_member or restrict_member with the user ID and restriction mask. promote_member can also elevate trusted users to admin.
Call get_webhook_info to inspect the current webhook, then use set_my_commands to register bot commands. Webhook URL updates require the Telegram Bot API token to be set in the MCP config.
Yes. send_invoice accepts title, description, currency, and price array. It uses Telegram's Payments API — you need a connected payment provider token configured in your bot settings.
get_chat_history returns messages for a chat ID with configurable offset and limit. Claude can summarize threads, extract action items, or flag unread mentions from the returned message objects.