Telegram MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SAMPLING_ENABLED | No | Enable/disable AI sampling entirely | true |
| TELEGRAM_BOT_TOKEN | Yes | Your Telegram bot token from @BotFather | |
| SAMPLING_MAX_TOKENS | No | Max tokens per AI response | 1000 |
| SAMPLING_ADMIN_USERS | No | Comma-separated user IDs who can use admin commands | |
| SAMPLING_ENABLE_POLL | No | Enable poll messages | true |
| SAMPLING_ENABLE_TEXT | No | Enable text messages | true |
| SAMPLING_SHOW_TYPING | No | Show typing indicator | true |
| SAMPLING_SILENT_MODE | No | Log but don't respond | false |
| SAMPLING_ENABLE_PHOTO | No | Enable photo messages | true |
| SAMPLING_ENABLE_VIDEO | No | Enable video messages | true |
| SAMPLING_ENABLE_VOICE | No | Enable voice messages | true |
| SAMPLING_MENTION_ONLY | No | Only respond when mentioned in groups | true |
| SAMPLING_ALLOWED_CHATS | No | Comma-separated chat IDs/usernames to allow (empty = all) | |
| SAMPLING_ALLOWED_USERS | No | Comma-separated user IDs to allow (empty = all) | |
| SAMPLING_BLOCKED_CHATS | No | Comma-separated chat IDs/usernames to ignore | |
| SAMPLING_BLOCKED_USERS | No | Comma-separated user IDs to ignore | |
| SAMPLING_ENABLE_CONTACT | No | Enable contact sharing | true |
| SAMPLING_ENABLE_STICKER | No | Enable sticker messages | true |
| SAMPLING_RESPOND_TO_DMS | No | Always respond in DMs | true |
| SAMPLING_ENABLE_DOCUMENT | No | Enable document uploads | true |
| SAMPLING_ENABLE_LOCATION | No | Enable location sharing | true |
| SAMPLING_IGNORE_COMMANDS | No | Ignore messages starting with / | true |
| SAMPLING_RATE_LIMIT_CHAT | No | Max requests per chat per minute | 20 |
| SAMPLING_RATE_LIMIT_USER | No | Max requests per user per minute | 10 |
| SAMPLING_KEYWORD_TRIGGERS | No | Only respond to messages with these keywords | |
| SAMPLING_MAX_MESSAGE_LENGTH | No | Maximum message length | 1000 |
| SAMPLING_MIN_MESSAGE_LENGTH | No | Minimum message length | 1 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| logging | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| SEND_MESSAGEB | Send a message to a Telegram chat or channel |
| GET_CHANNEL_INFOB | Get information about a Telegram channel or chat |
| FORWARD_MESSAGEC | Forward a message from one chat to another |
| PIN_MESSAGEB | Pin a message in a Telegram chat or channel |
| GET_CHANNEL_MEMBERSC | Get a list of channel administrators and members |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: sending, forwarding, pinning messages, getting channel info, and listing members. No overlap or ambiguity.
All tool names follow the same UPPER_SNAKE_CASE verb_noun pattern, e.g., SEND_MESSAGE, GET_CHANNEL_INFO. Highly consistent.
Five tools is perfectly scoped for a Telegram MCP server, covering essential messaging and channel operations without excess.
Covers core operations (send, forward, pin, info, members) but is missing update/delete message capabilities, which are reasonable gaps for a focused tool set.