Connect-MCP

io.github.leshchenko1979/fast-mcp-telegram

io.github.leshchenko1979/fast-mcp-telegram · v0.36.0

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

MCPremotelocal · pypino credentialsMessagingDocuments & PDFFiles & storage

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 8 tools, protocol 2025-06-18 · checked 2026-10-17

Test & rating

A 100/100

What it does: 8 tools · 4 read, 4 write (incl. delete/pay) · Messaging, Developer tools, Knowledge & docs

Test call find_chats: worked (1,023 ms)

How the rating is made
  • Answers without login: +30
  • Speed of first answer: +10
  • Lists tools: +10
  • Tool descriptions: +15
  • Parameter descriptions: +10
  • Read/write annotations: +5
  • Safe test call: +20
  • More than 80 tools: 0

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

Remote URL
https://tg-mcp.l1979.ru/v1/mcp
Package
registry:   pypi
identifier: fast-mcp-telegram
version:    0.35.0
transport:  stdio

Tools

8 tools listed at last check
  • 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. Results are ordered by ascending date-time (oldest first); limit selects the newest N. Success: message list and metadata dict. Global search ignores inc
  • 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_
  • 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 attachme
  • 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,
  • 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 us
  • 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/leshchenko1979/fast-mcp-telegram/blob/main/docs/Tools-Referen
  • 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.
  • 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. PII and credential-shaped fields (phone, access_hash) are dropped from a successful result by default; pass include_sensitive=

Badge

Connect-MCP badge for io.github.leshchenko1979/fast-mcp-telegram

Markdown for your README
[![Connect-MCP](https://clawy.uk/mcp/badge/io.github.leshchenko1979/fast-mcp-telegram.svg)](https://clawy.uk/mcp/s/io.github.leshchenko1979/fast-mcp-telegram)

Repository · Website