Overview
Features
Paginated Chat Reading
Provides get_chats(page, page_size) for a paginated list of chats and get_messages(chat_id, page, page_size) for paginated messages.
Chat & Group Management Toolkit
Supports creating groups/channels, editing titles, managing participants, invite links, and joining via invites.
Messaging & History Operations
Enables sending, replying, editing, deleting, forwarding, pinning/unpinning messages, marking as read, and accessing message context/history.
Polls, Inline Buttons & Interactions
Allows creating polls, inspecting inline buttons, and triggering callbacks by label or index.
Contacts & Profile Management
Manages contacts (list/search/add/delete), plus block/unblock and import/export of contacts.
Public Channels & Invite Linking
Subscribes to public channels, retrieves invite links, and joins via invite links with idempotent behavior.
Search & Discovery
Provides search for public chats/channels/bots, message search, and username-to-ID resolution.
Robust Input Validation & Error Handling
Validates chat_id and user_id formats and logs errors to mcp_errors.log with user-friendly messages.
Who Is This For?
- Developers:Create MCP-compatible Telegram tools and integrate Telethon-powered actions into Claude/Cursor workflows.
- AI Agents:Leverage MCP to interact with Telegram via Claude or Cursor for automated decision making and data retrieval.
- Telegram Users:Automate messaging, group management, and data retrieval through MCP-enabled tooling.




