tg-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TG_DIR | No | Where credentials.json and session.session live | ~/.tg |
| TG_DOWNLOAD_DIR | No | Where tg_download_media writes | $TG_DIR/downloads |
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 | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| tg_list_chatsA | List recent Telegram chats with their numeric ids, newest first. |
| tg_read_chatA | Read messages from a chat, oldest first. peer is a numeric id, an @username, or 'me' for Saved Messages. Optional since/until are YYYY-MM-DD. |
| tg_searchA | Search messages by text, across all chats or within one peer. |
| tg_download_mediaA | Download the media attached to one message. Returns the local path. message_id comes from tg_read_chat or tg_search. |
| tg_send_messageA | SEND a text message to a Telegram chat. This delivers immediately to a real person and cannot be unsent by this server. Use 'me' to write to Saved Messages. |
| tg_send_fileA | SEND a file to a Telegram chat, with an optional caption. Delivers immediately and cannot be unsent by this server. Use 'me' for Saved Messages. |
| tg_whoamiA | Which Telegram account this server is signed in as. |
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 7 tools
Each tool targets a distinct action: listing chats, reading messages, searching, downloading media, sending text, sending files, and identifying the account. There is no overlap, and the boundaries between tools are clear.
All tools share the 'tg_' prefix and most follow a verb_noun pattern (list_chats, read_chat, download_media, send_message, send_file). Two exceptions are 'search' (verb only) and 'whoami' (question format), which are minor deviations from the otherwise consistent pattern.
Seven tools is well-scoped for a Telegram server, covering core operations without being either too sparse or overly heavy. Each tool has a clear purpose and earns its place in the set.
The set covers the primary Telegram workflows: discovering chats, reading and searching messages, downloading media, sending text and files, and checking account identity. Minor gaps like message editing/deletion or chat management exist, but they are not critical for the server's apparent purpose.