Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Las reseñas y las cuentas llegarán en una etapa posterior.
PopNx MCPServidores MCP para quienes usan IA · explicados con palabras sencillas

Fast MCP Telegram

de leshchenko1979versión 0.46.1i★ –iComputadora o nube
Nombre en el registroio.github.leshchenko1979/fast-mcp-telegram

Instalar

Resumen

Descripción del creador (original en inglés)

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

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

  • Conexión: Computadora o nube
  • Transporte: stdio, Streamable HTTP
  • Categoría: Chat y correo
  • Debes completar: API_ID, API_HASH

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

¿Qué app usas?

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Funciona en Claude para web, escritorio y móvil:

  1. Abre Settings → Connectors
  2. Presiona Add custom connector
  3. Pega la dirección de abajo y presiona Add
  4. Si te pide iniciar sesión, inicia sesión en el servicio del creador
SettingsConnectors1+ Add2https://…3
https://tg-mcp.l1979.ru/v1/mcp

O ejecútalo en tu computadora

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "fast-telegram": {
      "command": "uvx",
      "args": [
        "fast-mcp-telegram"
      ],
      "env": {
        "API_ID": "your-value",
        "API_HASH": "your-value",
        "SERVER_MODE": "your-value",
        "SESSION_DIR": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

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

O ejecútalo en tu computadora

claude mcp add fast-telegram --env API_ID=your-value --env API_HASH=your-value --env SERVER_MODE=your-value --env SESSION_DIR=your-value -- uvx fast-mcp-telegram

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

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

O ejecútalo en tu computadora

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "fast-telegram": {
      "command": "uvx",
      "args": [
        "fast-mcp-telegram"
      ],
      "env": {
        "API_ID": "your-value",
        "API_HASH": "your-value",
        "SERVER_MODE": "your-value",
        "SESSION_DIR": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "fast-telegram": {
      "type": "http",
      "url": "https://tg-mcp.l1979.ru/v1/mcp"
    }
  }
}

O ejecútalo en tu computadora

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "fast-telegram": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "fast-mcp-telegram"
      ],
      "env": {
        "API_ID": "your-value",
        "API_HASH": "your-value",
        "SERVER_MODE": "your-value",
        "SESSION_DIR": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

ChatGPT solo se conecta a servidores en internet:

  1. Abre ChatGPT en la web → Settings → Connectors (Apps)
  2. Presiona Create o Add (en algunos planes primero hay que activar Developer mode en Advanced)
  3. Pega la dirección de abajo, ponle un nombre y guarda
  4. Si te pide iniciar sesión, inicia sesión en el servicio del creador
SettingsConnectors1+ Create2https://…3
https://tg-mcp.l1979.ru/v1/mcp

Los nombres de los menús pueden variar un poco según el plan y con el tiempo.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

  • API_ID obligatorio env
    Telegram API ID from my.telegram.org
  • API_HASH secreto obligatorio env
    Telegram API Hash from my.telegram.org
  • SERVER_MODE env
    Server mode: stdio (local), http-no-auth (dev), http-auth (prod)
  • SESSION_DIR env
    Custom session directory (defaults to ~/.config/fast-mcp-telegram/)

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 7 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • 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. Globa

  • 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

  • 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

  • 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). schedule_date (IS

  • 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; incl

  • 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

  • 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. schedule_date (ISO 8601, future) queues the message inste

  • 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; pas

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 8 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub leshchenko1979, dueña del repo

  • … Aún sin revisar

    Sigue en mantenimiento

    Todavía no hemos leído este repo en GitHub

  • … Aún sin revisar

    Tiene licencia

    Todavía no hemos leído este repo en GitHub

  • ✓ Superada

    El endpoint responde

    Respondió en 1089 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 8 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Comparado con otros en Chat y correoi

  • Más estrellas que el 0% de los otros 1835 servidores de esta categoría
  • Publicado en el registro más recientemente que el 63% de los otros 1835 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 100% de los otros 1835 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Fast MCP Telegram?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: API_ID, API_HASH

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.46.1) llegó al registro hace 18 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también funcionan las apps que aceptan servidores MCP remotos, como ChatGPT en modo desarrollador.

¿Qué puedo usar en su lugar?

En la misma categoría: Vexa, emailmd, MCP WhatsApp Cloud

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Vexa

de Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

Se ejecuta en la nube★ 2949Apache-2.0Actualizado hace 2 meses
Instalar

emailmd

de anypost

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

Computadora o nube★ 1385MITActualizado hace 32 días
Instalar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

Se ejecuta en tu computadora★ 277MITActualizado hace 5 meses
Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Telegram MCP Server — Model Context Protocol (MCP) gateway for Telegram. 8 context-efficient tools, multi-tenant, MTProto bridge.

Try the Demo

  1. Open https://tg-mcp.l1979.ru/setup
  2. Scan the QR code from Telegram mobile (Settings → Devices → Scan QR) — no phone typing, no OTP, no 2FA. Or enter your phone number as fallback.
  3. Copy your Bearer token from the success page

Then choose your path:

MCP Client (AI assistants)

  • From the setup page, download the mcp.json file
  • Add the server to your AI client and ask: "send hello to my saved messages in telegram"

Direct API (curl)

  • Run the command below (replace TOKEN with yours):
curl -X POST "https://tg-mcp.l1979.ru/mtproto-api/messages.SendMessage" \

-H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ -d '{"params": {"peer": "me", "message": "Hello!"}}'

How It Works

This server sits between your AI agent and Telegram's API:

Your agent → MCP/HTTP → this server → MTProto → Telegram

What it does: Authenticates you with Telegram (QR or phone/bot token), exposes 8 AI-friendly tools instead of 80+ micro-APIs, and bridges raw MTProto for power users. Multi-tenant — one server, many users, isolated sessions.

Features

FeatureDescription
:building_construction: [Dual Transport](docs/Installation.md#overview)Stdio for local MCP clients, HTTP for remote deploys (http-auth production, optional http-no-auth for dev)
:closed_lock_with_key: [Multi-User Authentication](docs/Installation.md#remote-setup-http-auth)Shared http-auth server: one Bearer token per user, one Telegram account per MCP connection. QR login for instant auth — no phone/OTP/2FA.
:dart: [AI-Optimized](docs/Tools-Reference.md#overview)8 consolidated tools vs 80+ micro-tools — context-efficient design, LLM-friendly API, MCP ToolAnnotations
:globe_with_meridians: [HTTP-MTProto Bridge](docs/MTProto-Bridge.md#key-benefits)Direct curl access to any Telegram API method with entity resolution and safety guardrails
:shield: [Session ACL](docs/Installation.md#session-acl-http-auth)Opt-in per-principal limits on http-auth (ACL_ENABLED) — chat lanes, read_only, blocked_peers, allow_mtproto, ACL_DENY_UNLISTED_PRINCIPALS; see SECURITY.md
:tv: [QR & Web Setup](docs/Installation.md#web-setup-interface)Scan QR from Telegram mobile for instant auth (no phone/OTP/2FA) or use phone/code/2FA fallback — live at /setup
:label: [One Agent, Multiple Accounts](docs/Installation.md#multi-account-mcp-tool-prefix)Optional PREFIX_MCP_TOOLS_WITH_ACCOUNT — when one agent uses several MCP connections (same server, different tokens), prefixes tool names so they do not collide; not needed for standard multi-user hosting
:rocket: [MTProto Proxy Support](docs/Installation.md#mtproto-proxy)Connect via MTProto proxy with automatic Fake TLS (EE prefix) and standard proxy detection
:card_file_box: [Unified Session Management](docs/Installation.md#configuration-reference)Single configuration system for setup and server; per-token session files on shared multi-user hosts
:cloud: [S3 Session Storage](docs/Installation.md#s3-session-storage-optional)Store sessions in S3-compatible object storage for ephemeral hosted deployments (Smithery, Fly.io, Railway)
:mag_right: [Intelligent Search](docs/Search-Guidelines.md#what-works)Global & per-chat message search with multi-query support and intelligent deduplication
:mag: [Unified Message API](docs/Tools-Reference.md#2-read)Single get_messages tool for search, browse, read by IDs, and replies - 5 modes in one
:speech_balloon: [Universal Replies](docs/Tools-Reference.md#2-read)Get replies from channel posts, forum topics, or any message with one parameter
:busts_in_silhouette: [Smart Contact Discovery](docs/Tools-Reference.md#1-discovery)Search users, groups, channels with uniform entity schemas, forum detection, profile enrichment
:file_folder: [Folder Filtering](docs/Tools-Reference.md#1-discovery)Filter chats by dialog folder (archived, custom folders) with integer ID or name matching
:envelope: [Advanced Messaging](docs/Tools-Reference.md#3-write)Send, edit, reply, post to forum topics, formatting, file attachments, and phone number messaging
:paperclip: [Secure File Handling](docs/Tools-Reference.md#3-write)Rich media sharing with SSRF protection, size limits, album support, optional HTTP attachment streaming
:outbox_tray: [Inline File Uploads](docs/Tools-Reference.md#3-write)Data: URI (base64) file uploads in files param — work in all transport modes, filenames preserved, images sent as photos
:microphone: [Voice Transcription](docs/Tools-Reference.md#get_messages)Automatic speech-to-text for Premium accounts with parallel processing and polling
:zap: High PerformanceAsync operations, parallel queries, and memory-conscious batching
:shield: Production ReliabilityAuto-reconnect, configurable logging, comprehensive error handling

Quick Start

1. Install and authenticate

Quickest path (remote server): Open /setup → scan QR → copy token (see Try the Demo).

CLI path (local stdio): Run fast-mcp-telegram-setup once to create a Telegram session — then fast-mcp-telegram serves it:

uvx --from fast-mcp-telegram fast-mcp-telegram-setup \

--api-id="your_api_id" \ --api-hash="your_api_hash" \ --phone-number="+123456789"

Bot token alternative (no phone, no OTP): Set BOT_API_TOKEN instead of --phone-number. See Installation Guide.

2. Configure MCP Client

stdio mode (local): Add to your MCP client config (e.g. claude_desktop_config.json) — stdio (standard input/output) is the default transport for local MCP clients:

{

"mcpServers": { "telegram": { "command": "uvx", "args": ["fast-mcp-telegram"], "env": { "API_ID": "your_api_id", "API_HASH": "your_api_hash" } } } }

http-auth mode (remote): Add to your MCP client config (e.g. claude_desktop_config.json):

{

"mcpServers": { "telegram": { "url": "https://tg-mcp.l1979.ru/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

Get your token by scanning the QR code on the setup page or see Installation Guide for deploying your own server.

3. Start Using
{"tool": "search_messages_globally", "params": {"query": "hello", "limit": 5}}

{"tool": "get_messages", "params": {"chat_id": "me", "limit": 10}} {"tool": "send_message", "params": {"chat_id": "me", "message": "Hello!"}}

Deploy to Remote Server

Deploy your own MCP server on a VDS — see Installation Guide for step-by-step instructions.

Available Tools

ToolPurposeKey Features
search_messages_globallySearch across all chatsMulti-term queries, date filtering, chat type filtering
get_messagesUnified message retrievalSearch/browse, read by IDs, get replies (posts/topics/messages), date filtering in all modes
send_messageSend new messageFile attachments (URLs/local/data URIs), classic formatting (markdown/html), parse_mode=rich Rich Messages, reply to forum topics
edit_messageEdit existing messageClassic or parse_mode=rich formatting
find_chatsFind users/groups/channelsMulti-term search, contact discovery, folder filtering, username/phone lookup
get_chat_infoGet detailed profile infoMember counts, bio/about, online status, forum topics, common groups, enriched data
send_message_to_phoneMessage phone numbersAuto-contact management, optional cleanup, file support (URLs/data URIs), parse_mode=rich
invoke_mtprotoDirect Telegram API (power user)Raw MTProto methods, entity resolution, PII/credential fields dropped by default (include_sensitive=true for raw) — see MTProto Bridge

See Tools Reference for detailed documentation with examples.

Documentation

  • Installation Guide - Local setup and remote server deployment
  • Tools Reference - Complete tools documentation
  • MTProto Bridge - Direct API access via curl
  • Contributing - Guidelines for contributors
  • Security - Security features and best practices

Telemetry

Anonymous tool telemetry since v0.30.1 — heartbeat every 6h, no credentials or message content collected. Opt out with DO_NOT_TRACK=1. See ADR 0005.

Auth flow telemetry since v0.38.0 — atomic events during setup (phone, QR, bot token, reauthorize). Buffered flush on flow completion. See ADR 0008.

License

MIT License - see LICENSE

mcp-name: io.github.leshchenko1979/fast-mcp-telegram

Pregunta a PopNx