Fast MCP Telegram MCP Server

io.github.leshchenko1979/fast-mcp-telegram

answering

Fast MCP Telegram is answering right now. Last checked 5 min ago. 1 460 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 680 · avg 229 · +233% w/w

a month agotoday

Uptime history 39 hours of history

39 hours agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

238 ms

Response time

average over 24h

1 460

Installs / week

npm and PyPI

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 5 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"
    }
  }
}

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/leshchenko1979/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/leshchenko1979/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/leshchenko1979/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/leshchenko1979/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. Full documentation: https://github.com/leshchenko1979/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/leshchenko1979/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/leshchenko1979/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/leshchenko1979/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	137 ms	5 min ago

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 send and messages. 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 238 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 238 ms on average, which is faster than 55% 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 1 460 times in the last week. Week over week that is +233%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.