Better Telegram MCP Server

<details> <summary><strong>Sister projects from n24q02m</strong> (click to expand)</summary>

Remote serverstreamable-httpPython

What is the Better Telegram MCP Server?

Sister projects from n24q02m (click to expand)

The short version

  • Dual mode — -- Bot API (httpx) for bots, MTProto (Telethon) for user accounts
  • 7 tools — with action dispatch: message, chat, media, contact, config, help, config__open_relay
  • Auto-detect mode — -- Set bot token for bot mode, or API credentials for user mode
  • Web-based OTP auth — -- HTTP-mode browser relay form handles phone, OTP, and 2FA for user accounts (no session strings, no CLI sign-in)
  • Tool annotations — -- Each tool declares readOnlyHint, destructiveHint, idempotentHint, openWorldHint
  • MCP Resources — -- Documentation available as telegram://docs/* resources

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
messagesend, edit, delete, forward, pin, react, search, history
chatlist, info, create, join, leave, members, admin, settings, topics
mediasend_photo, send_file, send_voice, send_video, download
contactlist, search, add, block
configstatus, set, cache_clear, setup_status, setup_start, setup_reset, setup_complete
help--
config__open_relay--

Configuration

VariableDescriptionRequired
TELEGRAM_BOT_TOKENCredential the server authenticates with.Yes
PUBLIC_URLEndpoint or connection string the server talks to.Yes
MCP_DCR_SERVER_SECRETCredential the server authenticates with.Yes
DCR_SERVER_SECRETCredential the server authenticates with.Yes
TELEGRAM_API_IDConfiguration value read at startup.Optional
ACCOUNT_IDConfiguration value read at startup.Optional

Example prompts to try

  • “Use Better Telegram MCP to message.”
  • “Use Better Telegram MCP to chat.”
  • “Use Better Telegram MCP to media.”

Frequently asked questions

<details> <summary><strong>Sister projects from n24q02m</strong> (click to expand)</summary> Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.