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. |
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 | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/arielsacagiu/telegram-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server