better-telegram-mcp

Overview

A production-grade MCP server for Telegram, supporting dual-mode Bot API and MTProto with a mega-tool pattern.

Capabilities

• • resource handlers
• • prompt templates
• • authentication support
• • browser automation integration
• • github integration
• • mcp client integration

Best For

Production-grade MCP server for Telegram with dual-mode Bot API and MTProto support.

Decision Snapshot

• • GitHub stars: 5
• • Forks: 3
• • Source provenance count: 1
• • Last seen: 3/25/2026
• • Published: 3/16/2026

Usage

TELEGRAM_BOT_TOKEN

Features

• • **6 mega-tools** with action dispatch: messages, chats, media, contacts, config, help
• • **Dual mode**: Bot API (httpx) for bots, MTProto (Telethon) for user accounts
• • **3-tier token optimization**: Only 6 tools registered instead of 30+ individual endpoints
• • **Tool annotations**: Each tool declares readOnlyHint, destructiveHint, idempotentHint, openWorldHint
• • **MCP Resources**: Documentation available as telegram://docs/* resources
• • **Auto-detect mode**: Set bot token for bot mode, or API credentials for user mode
• • resource handlers
• • prompt templates

Use Cases

• • Capability coverage: resource handlers; prompt templates.

Supported Clients / Integrations

• • resource handlers
• • prompt templates
• • authentication support
• • browser automation integration
• • github integration
• • mcp client integration
• • workflow automation support

Compatibility Signals

• • Claude Desktop: mentions (Mentioned in approved metadata/docs evidence.)
• • Cursor: mentions (Mentioned in approved metadata/docs evidence.)
• • GitHub: supports (Detected in parser config/capability hints.)

Prompt Examples

Notes / Requirements

• • Primary language: Python
• • License: MIT
• • Parser coverage score: 0.95
• • Source feeds: PyPI RSS + JSON API
• • Topic cluster: coding

Official Links

• Website
• Repository

Source Information

Related MCP Tools