All servers · Email & messaging

io.github.leshchenko1979/fast-mcp-telegram

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

Measured by MCP Station

Description written by the publisher, not verified

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

Connect

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

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

Tools as reported by the server

• 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 write/delete
  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 write/delete
  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
• 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-Referenc
• send_message_to_phone write/delete
  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
• invoke_mtproto write/delete
  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=

Tool changes

• 2026-10-21: search_messages_globally, get_messages, send_message, edit_message, find_chats, get_chat_info, send_message_to_phone, invoke_mtproto
• 2026-10-20: search_messages_globally, get_messages, send_message, edit_message, find_chats, get_chat_info, send_message_to_phone, invoke_mtproto
• 2026-10-16: search_messages_globally, get_messages, send_message, edit_message, find_chats, get_chat_info, send_message_to_phone, invoke_mtproto

Repository · Website · JSON · Text for agents · Registry updated 2026-10-20