Telegram MCP Server
by arielsacagiu
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_HOST | No | Host to bind for http/sse transports. Defaults to '127.0.0.1'. | |
| MCP_PORT | No | Port to bind for http/sse transports. Defaults to '8765'. | |
| MCP_TRANSPORT | No | Transport protocol: stdio (default), http, or sse. | |
| TELEGRAM_API_ID | Yes | Your Telegram API ID from my.telegram.org/apps | |
| MCP_ALLOWED_HOSTS | No | Comma-separated list of allowed Host headers for DNS-rebinding protection. Optional. | |
| TELEGRAM_API_HASH | Yes | Your Telegram API hash from my.telegram.org/apps | |
| MCP_ALLOWED_ORIGINS | No | Comma-separated list of allowed origins for CORS. Optional. | |
| TELEGRAM_EVENT_FEED | No | Set to '1' to enable the incoming event feed by default. | |
| TELEGRAM_PROXY_HOST | No | Proxy host. | |
| TELEGRAM_PROXY_PORT | No | Proxy port. | |
| TELEGRAM_PROXY_RDNS | No | Whether to use remote DNS (true/false). Optional. | |
| TELEGRAM_PROXY_TYPE | No | Proxy type: socks5, socks4, http, or mtproxy. | |
| TELEGRAM_APP_VERSION | No | App version reported to Telegram. | |
| TELEGRAM_ALIASES_FILE | No | Path to the aliases JSON file. Defaults to the state directory. | |
| TELEGRAM_DEVICE_MODEL | No | Device model reported to Telegram. Defaults to host platform. | |
| TELEGRAM_PROXY_SECRET | No | MTProxy secret (required when TELEGRAM_PROXY_TYPE=mtproxy). | |
| TELEGRAM_SESSION_NAME | No | Name of a file-based Telegram session (alternative to TELEGRAM_SESSION_STRING). | |
| TELEGRAM_CONTACT_FUZZY | No | Set to '0' to disable fuzzy contact suggestions. Defaults to '1'. | |
| TELEGRAM_EXPOSED_TOOLS | No | Set to 'read-only' to expose only read-only tools, or 'read-only+tool1,tool2' to add specific write tools. Defaults to 'all'. | |
| TELEGRAM_PROXY_PASSWORD | No | Proxy password (optional). | |
| TELEGRAM_PROXY_USERNAME | No | Proxy username (optional). | |
| TELEGRAM_SESSION_STRING | Yes | Your Telegram session string generated by session_string_generator.py. Required for authentication. Alternatively, use TELEGRAM_SESSION_NAME for a file-based session. | |
| TELEGRAM_SYSTEM_VERSION | No | System version reported to Telegram. | |
| TELEGRAM_EVENT_FEED_FILE | No | Path to the incoming event feed JSONL file. | |
| TELEGRAM_SESSION_STRINGS | No | Whitespace, comma, or semicolon-separated list of interchangeable session strings for a session pool. Takes precedence over TELEGRAM_SESSION_STRING. | |
| TELEGRAM_ALLOW_SERVER_ROOTS_FALLBACK | No | Set to '1' to fall back to server CLI roots when client roots are empty or fail. |
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
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivitySlowing
ResponsivenessNo issues