overpod/mcp-telegram

What's new

Two new methods on TelegramService for building real-time Telegram listeners and bridges (#17).

setTyping(chatId, action?)

Send typing indicators to any chat. Supports 10 action types:

await tg.setTyping(chatId);                  // default: typing
await tg.setTyping(chatId, "upload_photo");   // uploading photo
await tg.setTyping(chatId, "record_audio");   // recording voice
await tg.setTyping(chatId, "cancel");         // stop typing

All actions: typing, cancel, record_video, upload_video, record_audio, upload_audio, upload_photo, upload_document, choose_sticker, game_play

Uses messages.SetTyping MTProto API with resolvePeer for flexible chat identification (ID, username, or display name).

getMessageById(chatId, messageId)

Fetch a single message by its exact ID:

const msg = await tg.getMessageById(chatId, 42);
// Returns { id, text, sender, date, media?, reactions? } or null

Uses GramJS ids filter for precise lookup — no offset guessing. Returns the same format as getMessages() for consistency.

Use case: Reply context — when someone replies to a message, fetch the original to pass context to an LLM.

Dependencies

• MCP SDK bumped to ^1.29.0
• Biome bumped to ^2.4.10

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