telegram-mcpl
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TELEGRAM_BOT_WAKE | No | Deprecated 'any|listed' admission alias; owner /bots wake commands remain aliases. | |
| TELEGRAM_BOT_TOKEN | No | Alternative token input; a private token file (TELEGRAM_BOT_TOKEN_FILE) is preferable. | |
| TELEGRAM_MEDIA_DIR | No | Optional canonical absolute path of a private (mode 0700, owned by the connector user) directory for non-image originals. Required for non-image fetch_media; must already exist. Linux only. | |
| TELEGRAM_REACTIONS | No | 'on' (default), 'off'; subscribe to message_reaction and message_reaction_count only when on. | on |
| TELEGRAM_NEW_TOPICS | No | Exact 'open' (default/unset) or 'closed'; controls initial owner approval of newly learned forum topics in enrolled groups. Invalid values abort startup. | open |
| TELEGRAM_PREVIEW_MS | No | Minimum interval for chunk previews; default 900; range 50–10000. | 900 |
| TELEGRAM_STATE_FILE | No | Durable JSON state path; default ./telegram.state.json. | ./telegram.state.json |
| TELEGRAM_UPLOAD_ROOT | No | Optional root enabling relative path uploads for send_document; without it only inline data works. Must be a trusted export directory; Linux-only. | |
| TELEGRAM_MANAGED_BOTS | No | '1' enables owner-private managed-bot onboarding (off by default; '0' or unset keeps behavior unchanged). Requires TELEGRAM_OWNER_USER_ID and a bot with Bot Management Mode enabled in BotFather. | |
| TELEGRAM_BOT_ADMISSION | No | 'any' (fresh default) or opt-in 'listed'; controls ambient/addressed bot delivery, not host inference. | any |
| TELEGRAM_OWNER_USER_ID | No | Optional positive owner ID enabling private /groups, /topics and /bots commands; requires chat/user allow-lists containing exactly this owner ID. | |
| TELEGRAM_WHISPER_MODEL | No | Model name or local model directory read by scripts/transcribe.py. | |
| TELEGRAM_ALBUM_QUIET_MS | No | Album quiet interval; default 800; range 20–10000; hard coalescing window 5 seconds. | 800 |
| TELEGRAM_BOT_HOURLY_CAP | No | Maximum delivery attempts per bot per one-hour window from its first attempt; default 30, range 1–1000. | 30 |
| TELEGRAM_BOT_TOKEN_FILE | No | Private file containing the bot token. | |
| TELEGRAM_DRAFT_STALE_MS | No | Stop draft previews after this long without new text; default 25000; range 1000–120000. | 25000 |
| TELEGRAM_REACTIONS_FROM | No | 'all' (default), 'owner'; all admitted actors, or only the configured human TELEGRAM_OWNER_USER_ID. Owner mode requires that owner setting. | all |
| TELEGRAM_REACTIONS_WAKE | No | 'off' (default), 'on'; on submits merged incoming reaction events; off appends bounded notes to the next real incoming message in the same chat and topic. | off |
| TELEGRAM_ROUTING_HEADER | No | Exact 'on' (default) or 'off'; incoming text includes short reply coordinates and sender ID/escaped username. 'off' preserves the previous wire payload byte-for-byte. | on |
| TELEGRAM_ALLOWED_BOT_IDS | No | Optional comma-separated positive safe-integer bot IDs, at most 64 IDs / 1087 characters; no duplicates, usernames or owner ID. Unioned with owner-added runtime IDs; list is inactive in any mode; empty denies bots in listed mode. | |
| TELEGRAM_MAX_MEDIA_BYTES | No | Max original download, default 20 MiB; up to Telegram's 20 MiB cloud-download limit. | |
| TELEGRAM_ALLOWED_CHAT_IDS | No | Required comma-separated nonzero numeric chat IDs; no wildcard or empty default. | |
| TELEGRAM_ALLOWED_USER_IDS | No | Optional comma-separated positive numeric actor IDs; when present, missing actors are refused. | |
| TELEGRAM_MAX_INLINE_BYTES | No | Max raw photo bytes in one incoming delivery, default 8 MiB; remaining originals stay fetchable. | |
| TELEGRAM_MAX_UPLOAD_BYTES | No | Default 20971520 (20 MiB), accepts 1–50000000 bytes, and cannot exceed Telegram's 50 MB Bot API limit. | |
| TELEGRAM_DECISION_AUTO_PIN | No | '0' or '1'; default '1' when recording is on, '0' otherwise; explicit '1' requires recording enabled. | |
| TELEGRAM_DRAFT_LIFETIME_MS | No | Hard draft lifetime from the first chunk, even while growing; default 120000; range 1000–600000. | 120000 |
| TELEGRAM_DECISION_RECORDING | No | 'off', 'manual', or 'all' (default 'all'); controls optional automatic button decision recording. | all |
| TELEGRAM_MESSAGE_FORWARDING | No | Defaults to '1', advertising forward_message and telegram.forwarding. Set to '0' to disable both. | 1 |
| TELEGRAM_BOT_MAX_REPLY_DEPTH | No | Maximum consecutive bot-authored ancestors present in the update; default 3, range 1–8. | 3 |
| TELEGRAM_BOT_MIN_INTERVAL_MS | No | Minimum interval per bot delivery attempt; default 10000, range 1–600000. | 10000 |
| TELEGRAM_DEFAULT_BUTTONS_JSON | No | Optional callback-only rows, e.g. [[{"text":"Continue","callback_data":"continue"}]], attached to authoritative host publishes. | |
| TELEGRAM_MAX_MEDIA_TOTAL_BYTES | No | Ceiling for all stored non-image originals in TELEGRAM_MEDIA_DIR, default 1 GiB (min 20 MiB, max 64 GiB). No automatic cleanup; the operator removes files. | |
| TELEGRAM_TRANSCRIBE_TIMEOUT_MS | No | Default 120000; range 100–600000. | 120000 |
| TELEGRAM_TRANSCRIBE_COMMAND_JSON | No | Optional executable argv array; connector appends the local audio filename; stdout must contain transcript text. | |
| TELEGRAM_MANAGED_BOT_CREDENTIAL_DIR | No | Required with TELEGRAM_MANAGED_BOTS=1, no default. Canonical absolute path to an existing private directory (real directory, connector user, mode 0700; every ancestor a real directory owned by root or the connector user and not group/other-writable, except root-owned sticky directories such as /tmp; no symlink anywhere in the path) outside the media and state directories and outside every model-visible workspace mount. The connector never creates it. | |
| TELEGRAM_MANAGED_BOT_INTENT_TTL_SECONDS | No | Lifetime of one live creation request, default 1800 (60–86400). | 1800 |
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
ActivityMaintained
ResponsivenessNo issues