overpod/mcp-telegram

What's new

TelegramService.getClient() (#17)

New public method that returns the underlying GramJS TelegramClient instance. This enables building event-driven services on top of @overpod/mcp-telegram — for example, real-time message listeners using addEventHandler:

import { TelegramService } from "@overpod/mcp-telegram/service";
import { NewMessage } from "telegram/events";

const tg = new TelegramService(apiId, apiHash);
await tg.loadSession();
await tg.connect();

const client = tg.getClient();
client.addEventHandler(async (event) => {
  const message = event.message;
  // Handle incoming message in real time
}, new NewMessage({ chats: [chatId1, chatId2] }));

Returns: TelegramClient | null — null if not yet connected.

Why: The client field was previously private, making it impossible to attach GramJS event handlers externally. This unlocks event-driven architectures (real-time bridges, listeners, bots) while keeping all existing functionality (rate limiter, peer resolution, session management) available through TelegramService methods like sendMessage() and markAsRead().

Import path

Use the existing subpath export:

import { TelegramService } from "@overpod/mcp-telegram/service";

Full Changelog: https://github.com/overpod/mcp-telegram/compare/v1.20.0...v1.21.0