Skip to main content
Glama
expremiental

telegram-mcp

by expremiental
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TELEGRAM_API_IDNoYour Telegram API ID (advanced, overrides broker)
TELEGRAM_API_HASHNoYour Telegram API hash (advanced, overrides broker)

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

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
digest_unreadA

KILLER-тул: дайджест непрочитанного.

T9: iter_dialogs → топ-N чатов с unread_count>0 → подтянуть per_chat последних сообщений. Чтение НЕ помечает прочитанным (mark_read не зовём). Ограничивать (FloodWait). read-only.

Выбор топа: сортируем чаты по unread_count по убыванию — наверх всплывает самый большой бэклог (что больше всего пропустил). Сообщения внутри чата — newest-first (как отдаёт iter_messages), не помечаем прочитанным.

download_mediaA

Скачать вложение из конкретного сообщения на диск (локально).

T11: get_messages(entity, ids=message_id) → message.download_media(dest). Точечно, не «все фото». read-only (download_*).

find_chatA

Найти чат ПОИСКОМ (не перебором диалогов): серверный contacts.Search.

contacts.SearchRequest отдаёт РАНЖИРОВАННЫЕ совпадения в my_results (свои контакты/чаты — релевантнее) и results (глобальные публичные); users/chats — лишь пул сущностей для резолва. Берём именно my_results→results, а НЕ весь пул (иначе глобальный шум). Fallback на локальный фильтр диалогов — TODO, только если тест покажет дыру по приватным группам (docs/decisions.md). read-only.

get_historyA

Последние сообщения чата (chat = id/username/ссылка/название → resolve).

T6: iter_messages(entity, limit) → {id, date, sender, text}. read-only.

list_chatsB

Список диалогов с непрочитанным: title, type, unread_count, последнее сообщение.

T5: iter_dialogs(limit, archived) → chat_brief(...). read-only.

get_meA

Текущий аккаунт: id, имя, username. T12: get_me(). read-only.

get_participantsC

Участники чата/группы. T12: iter_participants(entity, limit). read-only.

get_pinnedB

Закреплённые сообщения чата. T12: get_pinned / iter_messages(pinned). read-only.

resolve_chatA

Точный resolve чата/юзера по username/ссылке/id/точному имени.

T10: resolve_entity(ref) → chat_brief. read-only.

Если не найдено — исключение Telethon (ValueError/UsernameNotOccupiedError и т.п.) пробрасывается наверх, оунер обрабатывает его на интеграции.

search_in_chatA

Поиск сообщений ВНУТРИ чата по тексту.

T7: iter_messages(entity, search=query, limit). read-only.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

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/expremiental/telegram-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server