overpod/mcp-telegram

What's New

Modular Tool Architecture

The monolithic index.ts (1060 lines, 33 tools) has been split into focused modules:

src/tools/
  auth.ts      — status, login (2 tools)
  messages.ts  — send, read, search, edit, delete, forward, unread, mark-as-read (9 tools)
  chats.ts     — list, search, info, members, join (5 tools)
  media.ts     — send-file, download, profile-photo (3 tools)
  contacts.ts  — get, profile, requests, add, block, report (6 tools)
  reactions.ts — send, get (2 tools)
  extras.ts    — pin, unpin, scheduled, poll, topics (6 tools)
  shared.ts    — ok/fail helpers, sanitize, formatReactions, annotations
  index.ts     — registerTools() aggregator

The entry point src/index.ts is now 50 lines — just bootstrap and startup.

No Functional Changes

This is a pure refactoring release. All 33 tools work exactly the same as v1.12.0. The public API (TelegramService class) is unchanged.