# fast-mcp-telegram

> Telegram MCP Server and HTTP-MTProto bridge | Multi-user, web setup, Docker and MTProto-Proxy ready

- **URL**: https://www.freshcrate.ai/projects/fast-mcp-telegram
- **Author**: leshchenko1979
- **Category**: MCP Servers
- **Latest version**: `v0.28.2` (2026-06-04)
- **License**: MIT
- **Source**: https://github.com/leshchenko1979/fast-mcp-telegram
- **Homepage**: https://t.me/mcp_telegram
- **Language**: Python
- **GitHub**: 39 stars, 11 forks
- **Registry**: github
- **Tags**: `agent`, `agentic-ai`, `automation`, `claude`, `cursor`, `cursor-ai`, `docker`, `fastmcp`, `python`

## Description

Telegram MCP Server and HTTP-MTProto bridge | Multi-user, web setup, Docker and MTProto-Proxy ready

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.28.2` | 2026-06-04 | High | Folder filter query performance: use dialog.date instead of GetPeerDialogsRequest for flags entities  ## Fixes - **Folder filter (`folder=`) query hang** — Fixed a ~30s stall when querying Telegram folders that combine `include_peers` with date filters (e.g. `find_chats` with `folder="Без каналов"`, `min_date`). The hang was caused by `GetPeerDialogsRequest` receiving stale `access_hash` for certain entities from `iter_dialogs`, which blocked subsequent batches. Now `dialog.date` from the dialog |
| `0.24.0` | 2026-05-29 | High | Multi‑term global search is now up to 2× faster — parallel gather replaces sequential interleaving.  ## New Features - **`find_chats` / parallel multi‑term search** — Global search with comma‑separated terms (e.g. `query="alex, channel, bot"`) now runs all `SearchRequest` calls in parallel via `asyncio.gather()`. Results are merged round‑robin with deduplication. Measured **−48%** on the benchmark stand (0.54s → 0.28s for 3 terms).  This release makes multi‑term global search significantly faste |
| `0.19.0` | 2026-05-24 | High | For **one agent with multiple MCP connections** to the same server (same URL, different Bearer tokens): opt-in tool name prefixes so merged tool lists stay distinct.  **Multi-user shared servers** (each user, one token, one connection) already isolate sessions and do **not** need `PREFIX_MCP_TOOLS_WITH_ACCOUNT`.  ## New Features - **`PREFIX_MCP_TOOLS_WITH_ACCOUNT`** — Per-connection tool name prefix (`{username}_send_message` or `{user_id}_…`). Use when one agent wires several tokens to one HTTP |
| `0.18.0` | 2026-05-18 | High | Reliable forum thread and reply fetching: topic roots, in-topic anchors, and supergroup threads each use the right Telegram API path.  ## New Features - **`get_messages` `thread_scope`** - With `reply_to_id`, choose `auto` (default), `full`, or `direct`. Forum **topic ids** load the whole topic via GetReplies; a **message id inside a topic** uses in-topic search (offset jump + filter). Supergroup `full` uses `SearchRequest` with `top_msg_id`. Channel posts still resolve to the linked discussion |
| `0.17.3` | 2026-05-12 | High | **Full Changelog**: https://github.com/leshchenko1979/fast-mcp-telegram/compare/0.17.2...0.17.3 |
| `0.17.2` | 2026-05-05 | High | **Full Changelog**: https://github.com/leshchenko1979/fast-mcp-telegram/compare/0.17.1...0.17.2 |
| `0.17.1` | 2026-05-03 | High | Direct CDN resend and improved find_chats performance with date-based filtering.  ## New Features - **`send_message` file_id passthrough**: Resending files from `get_messages` now uses Telegram's CDN directly — no download/upload through the server. Works for all media types (photos, documents, videos, etc.). URL format standardized to `/v1/attachments/{uuid}/{filename}`. - **`find_chats` date filtering for per-chat search**: Added `min_date` and `max_date` parameters to filter messages with |
| `0.16.6` | 2026-04-22 | High | Major docs overhaul  **Full Changelog**: https://github.com/leshchenko1979/fast-mcp-telegram/compare/0.16.5...0.16.6 |
| `0.16.4` | 2026-04-20 | High | **Full Changelog**: https://github.com/leshchenko1979/fast-mcp-telegram/compare/0.16.3...0.16.4 |
| `0.16.3` | 2026-04-14 | High | **Full Changelog**: https://github.com/leshchenko1979/fast-mcp-telegram/compare/0.16.2...0.16.3 |

## Citation

- HTML: https://www.freshcrate.ai/projects/fast-mcp-telegram
- Markdown: https://www.freshcrate.ai/projects/fast-mcp-telegram.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/fast-mcp-telegram/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._