telegram-archive-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TELEGRAM_ARCHIVE_URL | Yes | Telegram Archive URL |
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 | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_chat_statsC | Get statistics for a specific Telegram chat |
| get_messagesA | Get messages from a Telegram chat, newest first. Page with offset, or with the keyset cursor: pass the date and id of the last message you received as before_date and before_id to get the older ones (constant time on huge chats). after_id returns messages newer than an id. Dates are naive UTC. |
| get_messages_by_dateA | Get every message of a Telegram chat sent on one calendar day, oldest first. The day is taken in the given timezone (default UTC); the archive stores dates in UTC. Walks the chat with the keyset cursor, so it is cheap even on chats with hundreds of thousands of messages. |
| get_pinned_messagesC | Get pinned messages from a Telegram chat |
| get_topicsC | Get topics (forum threads) from a Telegram chat |
| list_chatsA | List all archived Telegram chats with their IDs, names, and types. Use this first to discover chat_id values needed by other tools. |
| list_foldersA | List all Telegram chat folders |
| refresh_statsA | Force recalculation of global telegram-archive statistics |
| search_messagesC | Search messages in a Telegram chat by keyword |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Chat folders | List of Telegram chat folders |
| Chat list | List of all archived chats with basic info |
| Global backup statistics | Chat count, message count, media count, total size |
| Health check | Health status of the telegram-archive instance |
TDQS
Scored across 9 tools
Most tools have clearly distinct purposes (e.g., list_chats, get_pinned_messages, search_messages). However, get_messages and get_messages_by_date both retrieve messages and could be confused at a glance, though the descriptions clarify their different use cases.
All tool names follow a consistent snake_case verb_noun pattern (get_, list_, search_, refresh_). There is no mixing of conventions, making the set highly predictable.
Nine tools is well-scoped for a Telegram archive reader, covering discovery, retrieval, search, and statistics without redundancy or bloat.
The surface covers core archive operations: listing chats/folders/topics, fetching messages by various criteria, searching, and stats. A minor gap exists for retrieving messages within a specific forum topic, as get_topics lists topics but no tool explicitly filters messages by topic.