Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.github.leshchenko1979/fast-mcp-telegram

REMOTE · TG-MCP.L1979.RU · 2 COMPONENTS

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

0 this week 76 Trust /100

Last scanned (7 hours ago)

Scores higher than 66% of remote servers

Reachable. Last reached 5 Nov 2026.

Category Communication

Recent critical change

Authorization (31 Aug 2026). See the changelog before you install this server.

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security57
Transport & Reachability100
Schema Quality & AI Usability61
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 3475 tokens (~434/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 8 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 20 Oct 26 0
    • A breaking change shipped without a version bump: still 3.4.7 ▼ security
    • Tool “edit_message” rewrote its description, which is the text the model reads security
    • “edit_message” made “message_id” required, so existing callers break ▼ functional
    • “send_message” reworded the description of “save_as_draft” cosmetic
    • “send_message_to_phone” reworded the description of “save_as_draft” cosmetic
    • “edit_message” dropped the optional parameter “save_as_draft” cosmetic
  • 19 Oct 26 0
    • Tool “edit_message” rewrote its description, which is the text the model reads security
    • Tool “send_message_to_phone” rewrote its description, which is the text the model reads security
    • Tool “send_message” rewrote its description, which is the text the model reads security
    • Schema quality: 367 → 446 ▼ functional
    • “send_message_to_phone” added an optional parameter “schedule_date” cosmetic
    • “send_message_to_phone” added an optional parameter “save_as_draft” cosmetic
    • “send_message” added an optional parameter “schedule_date” cosmetic
    • “send_message” added an optional parameter “save_as_draft” cosmetic
    • “edit_message” added an optional parameter “schedule_date” cosmetic
    • “edit_message” added an optional parameter “save_as_draft” cosmetic
    • “edit_message” made “message_id” optional cosmetic
  • 2 Oct 26 76
    • Tool “search_messages_globally” rewrote its description, which is the text the model reads security
    • Tool “get_messages” rewrote its description, which is the text the model reads security
  • 30 Sept 26 0
    • Stability: 0.97 → pass security
  • 29 Sept 26 0
    • Stability: pass → 0.97 functional
  • 28 Sept 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 26 Sept 26 0
    • Tool “edit_message” rewrote its description, which is the text the model reads security
    • Tool “send_message_to_phone” rewrote its description, which is the text the model reads security
    • Tool “send_message” rewrote its description, which is the text the model reads security
    • Tool “search_messages_globally” rewrote its description, which is the text the model reads security
    • Tool “invoke_mtproto” rewrote its description, which is the text the model reads security
    • Tool “get_messages” rewrote its description, which is the text the model reads security
    • Tool “get_chat_info” rewrote its description, which is the text the model reads security
    • Tool “find_chats” rewrote its description, which is the text the model reads security
    • “invoke_mtproto” added an optional parameter “include_sensitive” cosmetic
  • 25 Sept 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 5 Nov 2026 · Probed https://tg-mcp.l1979.ru/v1/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=tg-mcp.l1979.ru CN=YR1,O=Let's Encrypt,C=US 10 Oct 2026 8 Jan 2027 RSA 4096 SHA256-RSA 6b1aa6f789eeb85def42db25c5ceebdce94
SANs: tg-mcp.l1979.ru
CN=YR1,O=Let's Encrypt,C=US (CA) CN=Root YR,O=ISRG,C=US 3 Sept 2025 2 Sept 2028 RSA 2048 SHA256-RSA a20253f15f2691c05dc1ce13b9bcca4e
CN=Root YR,O=ISRG,C=US (CA) CN=ISRG Root X1,O=Internet Security Research Group,C=US 13 May 2026 2 Sept 2032 RSA 4096 SHA256-RSA f24b6d17f9d9ad7cb1c9fea78782699f

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of tg-mcp.l1979.ru. — Not signed

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
ru. present 26734 8 Verified
l1979.ru. absent Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://tg-mcp.l1979.ru/v1/mcp Verified 200
http (plaintext) http://tg-mcp.l1979.ru/v1/mcp HTTPS enforced 301 https://tg-mcp.l1979.ru/v1/mcp
MCP tools · 8 exposed · ~3,475 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
edit_message ~414

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). schedule_date (ISO 8601) reschedules an already-queued message; it does not turn a delivered message into a scheduled one, and the result then carries status='scheduled'. 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

NameTypeReqDescription
chat_idstringyesTarget chat: numeric id (e.g. -100…), username without @, or 'me' for Saved Messages.
messagestringyesMessage text. When sending files, used as caption.
message_idintegeryesMessage id in this chat to edit (from get_messages or Telegram).
parse_modestring–'markdown'/'html'/'auto': classic entity formatting (auto detects). 'rich': Telegram Rich Message document; dialect auto-detected (known HTML tags outside code → rich HTML, else rich markdown). Defau…
schedule_datestring–ISO 8601 instant at which Telegram should deliver the message, e.g. '2026-10-20T09:00:00Z' or '2026-10-20T12:00:00+03:00'. Must be in the future. On send: queues the message instead of delivering now…
NameTypeReqDescription
actionstring––
chatobject––
codeinteger––
datestring––
draft_savedboolean––
edit_datestring––
errorstring––
error_codestring––
exceptionobject––
message_idinteger––
okboolean––
operationstring––
paramsobject––
reply_markupobject––
reply_to_idinteger––
richboolean––
rich_formatstring––
schedule_datestring––
scheduledboolean––
senderobject––
statusstring––
textstring––
topic_idinteger––

No examples provided.

find_chats ~380

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

NameTypeReqDescription
chat_typestring–Comma-separated chat kinds: private, bot, group, channel. Case-insensitive; extra spaces allowed.
folderstring–Telegram folder name (case-insensitive exact match after normalization). In Telegram's UI these are called folders; internally they are "dialog filters" — saved filter presets that group chats by cus…
limitinteger–Maximum chats to return (recommended 50 or less).
max_datestring–Inclusive maximum date filter (ISO 8601 date or datetime). Omit for no upper bound.
min_datestring–Inclusive minimum date filter (ISO 8601 date or datetime). Omit for no lower bound.
publicboolean–If true, prefer chats with a public username; if false, without. Does not apply to private DMs. Omit to skip this filter.
querystring–Name, username (no @), phone (+country…), or comma-separated usernames for batch lookup. Example: 'alice,bob,charlie'. Required for global search unless you use min_date/max_date or folder alone.
NameTypeReqDescription
actionstring––
chatsarray––
codeinteger––
errorstring––
error_codestring––
exceptionobject––
okboolean––
operationstring––
paramsobject––

No examples provided.

get_chat_info ~150

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/leshchenko1979/fast-mcp-telegram/blob/main/docs/Tools-Reference.md

NameTypeReqDescription
chat_idstringyesTarget chat: numeric id (e.g. -100…), username without @, or 'me' for Saved Messages.
common_chats_limitinteger–Max common groups to list for user targets.
topics_limitinteger–Max forum topics to list when the chat is a forum.
NameTypeReqDescription
actionstring––
codeinteger––
common_chatsarray––
common_chats_has_moreboolean––
errorstring––
error_codestring––
exceptionobject––
first_namestring––
idinteger––
is_botboolean––
is_channelboolean––
is_forumboolean––
is_groupboolean––
is_userboolean––
last_namestring––
okboolean––
operationstring––
paramsobject––
participants_countinteger––
phonestring––
titlestring––
topicsarray––
topics_has_moreboolean––
usernamestring––

No examples provided.

get_messages ~692

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. Results are ordered by ascending date-time (oldest first) in every mode, including message_ids and nested context lists; limit selects the newest N. 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

NameTypeReqDescription
auto_expand_batchesinteger–Extra search batches to run when filters narrow results. Higher values may return more matches at the cost of latency.
chat_idstringyesTarget chat: numeric id (e.g. -100…), username without @, or 'me' for Saved Messages.
contextinteger–Number of surrounding messages to include as context for each search result. 0 = disabled (default). 1-10 = include N messages before and N after each result. Also fetches the message being replied t…
from_userstring–Only return messages from this sender. Not a display-name or contact-name search — bare strings resolve like chat_id via get_entity (usernames are case-insensitive and may match an unrelated channel)…
include_repliesboolean–If true, fetch up to 5 direct replies per search result and attach as replies. Each result costs one API call (not batchable). Default: false.
include_total_countboolean–If true, response may include total_count where supported (per-chat search; ignored for global search).
limitinteger–Maximum messages to return (recommended 50 or less).
max_datestring–Inclusive maximum date filter (ISO 8601 date or datetime). Omit for no upper bound.
message_idsarray–Exact message ids to fetch. Mutually exclusive with query and reply_to_id.
min_datestring–Inclusive minimum date filter (ISO 8601 date or datetime). Omit for no lower bound.
querystring–Search within this chat only; comma-separated terms. Omit to browse latest or use message_ids / reply_to_id modes.
reply_to_idinteger–Anchor message id: channel post id, forum topic_id from get_chat_info, or a message id for direct replies. Use with thread_scope.
thread_scopestring–Only with reply_to_id. auto: full forum topic (topic_id) or channel comment thread via getReplies; else direct replies. full: nested branch under a message id (forum in-topic uses search window, not…
NameTypeReqDescription
_warningstring––
actionstring––
codeinteger––
errorstring––
error_codestring––
exceptionobject––
has_moreboolean––
messagesarray––
okboolean––
operationstring––
paramsobject––
total_countinteger––

No examples provided.

invoke_mtproto ~346

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. PII and credential-shaped fields (phone, access_hash) are dropped from a successful result by default; pass include_sensitive=true for the raw payload. A bare message id needs a chat binding: requests with no peer field (messages.GetMessages, messages.DeleteMessages) are refused, because a bare id resolves against an arbitrary dialog. Use channels.GetMessages or messages.GetHistory, which carry the binding. messages.GetHistory cannot address a forum topic (no thread_id/top_msg_id in the schema, and channels.GetHistory does not exist) -- use messages.Search with top_msg_id, or the high-level get_messages with reply_to_id. Full documentation: https://github.com/leshchenko1979/fast-mcp-telegram/blob/main/docs/Tools-Reference.md

NameTypeReqDescription
allow_dangerousboolean–If false, destructive methods (e.g. deletes) are blocked. Set true only when intended.
include_sensitiveboolean–If true, return the raw result including PII and credential-shaped fields (phone, access_hash). Default false drops them.
method_full_namestringyesTelegram API method, e.g. "messages.GetHistory" or "users.GetFullUser" (normalization applied).
params_jsonstringyesJSON object string of TL parameters as in Telegram API docs; nested TL uses "_": "typeName" discriminator.
resolveboolean–If true, resolve string/int peer-like fields to TL Input* entities before invoke.
NameTypeReqDescription
_string––
actionstring––
chatsarray––
codeinteger––
dateinteger––
errorstring––
error_codestring––
exceptionobject––
idinteger––
messagesarray––
okboolean––
operationstring––
paramsobject––
result–––
usersarray––

No examples provided.

search_messages_globally ~319

Search all Telegram chats at once (not scoped to one chat). Comma-separated query terms; optional filters by date, chat kind, and public username. Results are ordered by ascending date-time (oldest first); limit selects the newest N. 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

NameTypeReqDescription
auto_expand_batchesinteger–Extra search batches to run when filters narrow results. Higher values may return more matches at the cost of latency.
chat_typestring–Comma-separated chat kinds: private, bot, group, channel. Case-insensitive; extra spaces allowed.
include_total_countboolean–If true, response may include total_count where supported (per-chat search; ignored for global search).
limitinteger–Maximum messages to return (recommended 50 or less).
max_datestring–Inclusive maximum date filter (ISO 8601 date or datetime). Omit for no upper bound.
min_datestring–Inclusive minimum date filter (ISO 8601 date or datetime). Omit for no lower bound.
publicboolean–If true, prefer chats with a public username; if false, without. Does not apply to private DMs. Omit to skip this filter.
querystringyesSearch terms, comma-separated for multiple terms (OR-style global search). Required.
NameTypeReqDescription
_warningstring––
actionstring––
codeinteger––
errorstring––
error_codestring––
exceptionobject––
has_moreboolean––
messagesarray––
okboolean––
operationstring––
paramsobject––
total_countinteger––

No examples provided.

send_message ~650

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. schedule_date (ISO 8601, must be in the future) queues the message instead of delivering it now, so the result carries status='scheduled' plus scheduled and schedule_date. save_as_draft=true saves the text as the chat's draft instead of sending it (empty message clears the draft; user sessions only, bots cannot; text-only, so no files, no parse_mode='rich', no schedule_date). 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

NameTypeReqDescription
chat_idstringyesTarget chat: numeric id (e.g. -100…), username without @, or 'me' for Saved Messages.
filesarray–List of attachment URLs, local paths, or data URIs (one or more strings). data: URIs (data:<mime>;base64,<payload>) work in all server modes; local paths work in stdio mode only.
messagestringyesMessage text. When sending files, used as caption.
parse_modestring–'markdown'/'html'/'auto': classic entity formatting (auto detects). 'rich': Telegram Rich Message document; dialect auto-detected (known HTML tags outside code → rich HTML, else rich markdown). Defau…
reply_to_idinteger–Telegram message id to reply to. For forums, topic root id; for channel posts, post id (may create a comment). Omit for a new top-level message.
save_as_draftboolean–If true, save the text as the chat's draft instead of sending it (an empty text clears the existing draft). User sessions only — bot accounts cannot call messages.saveDraft. Cannot be combined with s…
schedule_datestring–ISO 8601 instant at which Telegram should deliver the message, e.g. '2026-10-20T09:00:00Z' or '2026-10-20T12:00:00+03:00'. Must be in the future. On send: queues the message instead of delivering now…
NameTypeReqDescription
actionstring––
chatobject––
codeinteger––
datestring––
draft_savedboolean––
edit_datestring––
errorstring––
error_codestring––
exceptionobject––
message_idinteger––
okboolean––
operationstring––
paramsobject––
reply_markupobject––
reply_to_idinteger––
richboolean––
rich_formatstring––
schedule_datestring––
scheduledboolean––
senderobject––
statusstring––
textstring––
topic_idinteger––

No examples provided.

send_message_to_phone ~524

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. schedule_date (ISO 8601, future) queues the message instead of delivering now; save_as_draft=true saves the text as the draft in that chat instead of sending. 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

NameTypeReqDescription
filesarray–List of attachment URLs, local paths, or data URIs (one or more strings). data: URIs (data:<mime>;base64,<payload>) work in all server modes; local paths work in stdio mode only.
first_namestring–First name when creating a temporary contact.
last_namestring–Last name when creating a temporary contact.
messagestringyesMessage text. When sending files, used as caption.
parse_modestring–'markdown'/'html'/'auto': classic entity formatting (auto detects). 'rich': Telegram Rich Message document; dialect auto-detected (known HTML tags outside code → rich HTML, else rich markdown). Defau…
phone_numberstringyesE.164 phone number with country code, e.g. +1234567890 (must be on Telegram).
remove_if_newboolean–If true, delete the contact after send when it was created only for this send.
reply_to_msg_idinteger–Reply to this message id in the target chat after resolve.
save_as_draftboolean–If true, save the text as the chat's draft instead of sending it (an empty text clears the existing draft). User sessions only — bot accounts cannot call messages.saveDraft. Cannot be combined with s…
schedule_datestring–ISO 8601 instant at which Telegram should deliver the message, e.g. '2026-10-20T09:00:00Z' or '2026-10-20T12:00:00+03:00'. Must be in the future. On send: queues the message instead of delivering now…
NameTypeReqDescription
actionstring––
chatobject––
codeinteger––
contact_removedboolean––
contact_was_newboolean––
datestring––
draft_savedboolean––
edit_datestring––
errorstring––
error_codestring––
exceptionobject––
message_idinteger––
okboolean––
operationstring––
paramsobject––
phone_numberstring––
reply_markupobject––
reply_to_idinteger––
richboolean––
rich_formatstring––
schedule_datestring––
scheduledboolean––
senderobject––
statusstring––
textstring––
topic_idinteger––

No examples provided.

Install

How do I install the io.github.leshchenko1979/fast-mcp-telegram server?

io.github.leshchenko1979/fast-mcp-telegram is a hosted endpoint at https://tg-mcp.l1979.ru/v1/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · tg-mcp.l1979.ru

# add to Claude Code
claude mcp add --transport http leshchenko1979-fast-mcp-telegram 'https://tg-mcp.l1979.ru/v1/mcp'
Common questions

What is the io.github.leshchenko1979/fast-mcp-telegram server?

io.github.leshchenko1979/fast-mcp-telegram is listed in the public MCP registry as io.github.leshchenko1979/fast-mcp-telegram. Multi-tenant Telegram gateway for AI agents, HTTP+stdio, 8 tools, MTProto User API. This page covers its hosted endpoint (https://tg-mcp.l1979.ru/v1/mcp).

Is the io.github.leshchenko1979/fast-mcp-telegram server safe to use?

io.github.leshchenko1979/fast-mcp-telegram scores 76 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the io.github.leshchenko1979/fast-mcp-telegram server expose?

io.github.leshchenko1979/fast-mcp-telegram exposes 8 tools: search_messages_globally, get_messages, send_message, edit_message, find_chats, and 3 more. Their descriptions and schemas cost roughly 3,475 tokens of context every time the server is loaded.

Does the io.github.leshchenko1979/fast-mcp-telegram server require authentication?

No. We connected to io.github.leshchenko1979/fast-mcp-telegram without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

Is the io.github.leshchenko1979/fast-mcp-telegram server still maintained?

io.github.leshchenko1979/fast-mcp-telegram is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.