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 | |
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