Fast MCP Telegram MCP Server

by leshchenko1979 Your server? Claim it

answering

Fast MCP Telegram is answering right now. Last checked 10 min ago. 730 installs a week from pypi. It exposes 8 tools.

Multi-tenant Telegram gateway for AI agents — HTTP+stdio, 8 tools, MTProto User API

The linked repository no longer exists on GitHub — it was deleted or made private.

Installs per day peak 568 · avg 174 · -53% w/w

a month agotoday

Uptime history 47 days of history · worst day 60%

47 days agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

261 ms

Response time

average over 24h

730

Installs / week

npm and PyPI

What changed 3

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 10 August 2026. No other catalogue keeps this.

16 Sep a tool changed version

11 Sep a tool changed the parameters it asks for get_chat_info

10 Aug a tool description was rewritten get_chat_info

What the code does

We have not read this server's code yet · tools taken from the live server

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Known vulnerability in the package fast-mcp-telegram · GHSA-rxw2-pc8j-vxwm

Known vulnerability in the package fast-mcp-telegram · PYSEC-2026-2473

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 10 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add fast-mcp-telegram --transport http https://tg-mcp.l1979.ru/v1/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fast-mcp-telegram": {
      "url": "https://tg-mcp.l1979.ru/v1/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.fast-mcp-telegram]
url = "https://tg-mcp.l1979.ru/v1/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "fast-mcp-telegram": {
      "url": "https://tg-mcp.l1979.ru/v1/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "fast-mcp-telegram": {
      "url": "https://tg-mcp.l1979.ru/v1/mcp"
    }
  }
}

This one needs environment variables set before it will start: API_ID (Telegram API ID from my.telegram.org), API_HASH (Telegram API Hash from my.telegram.org), SERVER_MODE (Server mode: stdio (local), http-no-auth (dev), http-auth (prod)), SESSION_DIR (Custom session directory (defaults to ~/.config/fast-mcp-telegram/)). The author declared them in the registry entry; get the values from the project itself.

Available tools 8

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

messages

get_messages

Read or search messages in one chat: browse latest, search text, fetch by ids, or load replies to a message (comments, forum topics, threads). Use from_user to filter by sender (server-side, per-chat only). Use context to include neighboring messages and reply chains around each result. Use include_replies to fetch up to 5 direct replies per result. Do not combine message_ids with query or reply_to_id. Success: messages, has_more, optional total_count and discussion fields. Full documentation: https://github.com/alexeyleshchenko/fast-mcp-telegram/blob/main/docs/Tools-Reference.md

search_messages_globally

Search all Telegram chats at once (not scoped to one chat). Comma-separated query terms; optional filters by date, chat kind, and public username. Success: message list and metadata dict. Global search ignores include_total_count. Full documentation: https://github.com/alexeyleshchenko/fast-mcp-telegram/blob/main/docs/Tools-Reference.md

send

send_message

Send text and optional file attachments to a Telegram chat. Supports reply-to (including forum topics and channel discussion groups), parse_mode: classic markdown/html/auto (entities) or rich (Rich Message document; dialect auto-detected). parse_mode=rich cannot be combined with files. File attachments as http(s) URLs, local paths, or data: URIs. When files are provided, the message text becomes a caption. For channel posts with reply_to_id, automatically posts in the linked discussion group. Success: dict with message_id, date, chat, text, status='sent', and sender info (rich messages also set rich=true and rich_format). Error: dict with ok=false and error string. Use send_message to create new messages; use edit_message to modify existing ones. Use send_message_to_phone when targeting a phone number instead of a chat_id. Full documentation: https://github.com/alexeyleshchenko/fast-mcp-telegram/blob/main/docs/Tools-Reference.md

send_message_to_phone

Send to a phone number: may create a temporary contact, then send text or files. Supports parse_mode: classic markdown/html/auto or rich (Rich Message; dialect auto-detected). parse_mode=rich cannot be combined with files. Success: send result plus contact_was_new / contact_removed when applicable. Full documentation: https://github.com/alexeyleshchenko/fast-mcp-telegram/blob/main/docs/Tools-Reference.md

chat

get_chat_info

Load profile and metadata for one user, bot, group, or channel. Success: info dict; forum chats may include topics up to topics_limit; user targets may include common_chats up to common_chats_limit. Full documentation: https://github.com/alexeyleshchenko/fast-mcp-telegram/blob/main/docs/Tools-Reference.md

chats

find_chats

Find users/groups/channels by name, username, or phone. Comma-separated usernames are searched in parallel and results are merged round-robin. Global search (query required) searches all Telegram; with min_date, max_date, or filter, search uses dialog list or a named filter; include_peers filters use last-activity from GetPeerDialogs; flag-based filters use dialog list dates. Success: dict with key chats (list of chat objects). Full documentation: https://github.com/alexeyleshchenko/fast-mcp-telegram/blob/main/docs/Tools-Reference.md

edit

edit_message

Replace the text of an existing message in a Telegram chat. Only works on messages sent by the authenticated account. Cannot edit media or other message attributes — text only. parse_mode: classic markdown/html/auto or rich (Rich Message; dialect auto-detected). Success: dict with message_id, date, chat, text, status='edited', and edit_date (rich messages also set rich=true and rich_format). Error: dict with ok=false and error string (e.g. message not found or not editable). Use edit_message to update a previously sent message; use send_message to create new ones. Full documentation: https://github.com/alexeyleshchenko/fast-mcp-telegram/blob/main/docs/Tools-Reference.md

invoke

invoke_mtproto

Low-level Telegram API (MTProto) invoke for methods not wrapped by other tools. Dangerous methods require allow_dangerous=true. Success: API result dict or normalized error. Full documentation: https://github.com/alexeyleshchenko/fast-mcp-telegram/blob/main/docs/Tools-Reference.md

Endpoints

URL	Transport	State	Latency	Checked
https://tg-mcp.l1979.ru/v1/mcp	streamable-http	answering	267 ms	10 min ago

Alternatives to Fast MCP Telegram

same job, measured the same way

Fast MCP Telegram

by alexeyleshchenko

Multi-tenant Telegram gateway for AI agents — HTTP+stdio, 8 tools, MTProto User API

local only

aiogram-mcp

by py2755

MCP server for aiogram Telegram bots — 30 tools, 7 resources, 3 prompts, event streaming

143 installs/wk local only

Oracle H

by tponscr-debug

Human approval gate for AI agents. Critical actions approved or rejected by a human via Telegram.

20 installs/wk local only

TG multi-account MCP

by mesteriis

Self-hosted, consent-based access to Telegram accounts and bots for MCP clients

local only

Better Telegram MCP

by n24q02m

Telegram for AI agents: messages, chats, media, and contacts in bot and user-account modes.

2 385 installs/wk local only

Dynamic Telegram Bot API MCP

by patricktobias86

A dynamic, self-refreshing MCP gateway for the complete Telegram Bot API

541 installs/wk local only

Telemost MCP Server

by telemost

Telegram channel analytics and statistics for AI agents, pay-per-call in USDC via x402.

56 installs/wk 20 tools answering

e2a — email for AI agents

by mnexa-ai

Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.

53 installs/wk answering

Fast MCP Telegram — questions

Answers built from our own checks of this server.

What can Fast MCP Telegram do?

It exposes 8 tools, read directly from the server on our last check. Among them: edit_message, find_chats, get_chat_info, get_messages, invoke_mtproto, search_messages_globally and 2 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Fast MCP Telegram mostly used for?

Its tools cluster around messages and send. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Fast MCP Telegram working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 261 ms. The bar chart above shows every period we have measured.

Is Fast MCP Telegram still maintained?

The linked repository no longer exists on GitHub — it was deleted or made private. We show this because it changes what you can expect: an unmaintained server may keep answering for months and then stop without warning.

How do I connect Fast MCP Telegram?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Fast MCP Telegram need an API key?

No. Fast MCP Telegram completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 8 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Fast MCP Telegram?

It answers our handshake in 261 ms on average, which is faster than 56% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

How many people use Fast MCP Telegram?

The pypi package fast-mcp-telegram was installed 730 times in the last week. Week over week that is -53%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.