@overpod/mcp-telegram 1.23.0 → 1.24.1

package/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.24.1] - 2026-04-20
+
+### Changed
+- Dependencies bumped to latest: `@modelcontextprotocol/sdk` 1.28.0 → 1.29.0, `dotenv` 17.3.1 → 17.4.2, `@biomejs/biome` 2.4.9 → 2.4.12, `typescript` 6.0.2 → 6.0.3, `@types/node` 25.5.0 → 25.6.0
+- `biome.json` migrated to schema 2.4.12
+
+## [1.24.0] - 2026-04-06
+
+### Added
+- **Sticker tools** — 5 new tools (59 total): `telegram-get-sticker-set`, `telegram-search-sticker-sets`, `telegram-get-installed-stickers`, `telegram-send-sticker`, `telegram-get-recent-stickers`
+- **Pre-built binaries** — zero-dependency standalone executables for Linux (x64/ARM64), macOS (x64/ARM64), Windows (x64)
+- **Documentation site** — VitePress-based docs at overpod.github.io/mcp-telegram with i18n (English, Russian, Chinese)
+
+## [1.23.0] - 2026-04-05
+
+### Added
+- 11 new tools (22 total): `telegram-send-reaction`, `telegram-edit-message`, `telegram-delete-message`, `telegram-forward-message`, `telegram-mark-as-read`, `telegram-get-dialogs`, `telegram-get-chat-info`, `telegram-send-file`, `telegram-add-contact`, `telegram-create-poll`, `telegram-manage-topics`
+- Account management tools: `telegram-get-sessions`, `telegram-terminate-session`, `telegram-set-privacy`, `telegram-set-auto-delete`, `telegram-update-profile`
+- Better entity resolution for channels and supergroups
+
 ## [1.22.0] - 2026-04-01
 
 ### Added
@@ -257,28 +277,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Session persistence
 - GramJS/MTProto integration
 
-[Unreleased]: https://github.com/overpod/mcp-telegram/compare/v1.19.0...HEAD
-[1.19.0]: https://github.com/overpod/mcp-telegram/compare/v1.18.0...v1.19.0
-[1.18.0]: https://github.com/overpod/mcp-telegram/compare/v1.17.0...v1.18.0
-[1.17.0]: https://github.com/overpod/mcp-telegram/compare/v1.16.0...v1.17.0
-[1.16.0]: https://github.com/overpod/mcp-telegram/compare/v1.15.0...v1.16.0
-[1.15.0]: https://github.com/overpod/mcp-telegram/compare/v1.14.0...v1.15.0
-[1.14.0]: https://github.com/overpod/mcp-telegram/compare/v1.13.0...v1.14.0
-[1.13.0]: https://github.com/overpod/mcp-telegram/compare/v1.12.0...v1.13.0
-[1.12.0]: https://github.com/overpod/mcp-telegram/compare/v1.11.1...v1.12.0
-[1.11.1]: https://github.com/overpod/mcp-telegram/compare/v1.11.0...v1.11.1
-[1.11.0]: https://github.com/overpod/mcp-telegram/compare/v1.10.1...v1.11.0
-[1.10.1]: https://github.com/overpod/mcp-telegram/compare/v1.10.0...v1.10.1
-[1.10.0]: https://github.com/overpod/mcp-telegram/compare/v1.9.0...v1.10.0
-[1.9.0]: https://github.com/overpod/mcp-telegram/compare/v1.8.1...v1.9.0
-[1.8.1]: https://github.com/overpod/mcp-telegram/compare/v1.8.0...v1.8.1
-[1.8.0]: https://github.com/overpod/mcp-telegram/compare/v1.7.0...v1.8.0
-[1.7.0]: https://github.com/overpod/mcp-telegram/compare/v1.6.0...v1.7.0
-[1.6.0]: https://github.com/overpod/mcp-telegram/compare/v1.5.0...v1.6.0
-[1.5.0]: https://github.com/overpod/mcp-telegram/compare/v1.4.0...v1.5.0
-[1.4.0]: https://github.com/overpod/mcp-telegram/compare/v1.3.1...v1.4.0
-[1.3.1]: https://github.com/overpod/mcp-telegram/compare/v1.3.0...v1.3.1
-[1.3.0]: https://github.com/overpod/mcp-telegram/compare/v1.2.0...v1.3.0
-[1.2.0]: https://github.com/overpod/mcp-telegram/compare/v1.1.0...v1.2.0
-[1.1.0]: https://github.com/overpod/mcp-telegram/compare/v1.0.0...v1.1.0
-[1.0.0]: https://github.com/overpod/mcp-telegram/releases/tag/v1.0.0
+[Unreleased]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.24.0...HEAD
+[1.24.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.23.0...v1.24.0
+[1.23.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.22.0...v1.23.0
+[1.22.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.21.0...v1.22.0
+[1.21.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.20.0...v1.21.0
+[1.20.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.19.0...v1.20.0
+[1.19.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.18.0...v1.19.0
+[1.18.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.17.0...v1.18.0
+[1.17.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.16.0...v1.17.0
+[1.16.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.15.0...v1.16.0
+[1.15.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.14.0...v1.15.0
+[1.14.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.13.0...v1.14.0
+[1.13.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.12.0...v1.13.0
+[1.12.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.11.1...v1.12.0
+[1.11.1]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.11.0...v1.11.1
+[1.11.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.10.1...v1.11.0
+[1.10.1]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.10.0...v1.10.1
+[1.10.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.9.0...v1.10.0
+[1.9.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.8.1...v1.9.0
+[1.8.1]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.8.0...v1.8.1
+[1.8.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.7.0...v1.8.0
+[1.7.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.6.0...v1.7.0
+[1.6.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.5.0...v1.6.0
+[1.5.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.4.0...v1.5.0
+[1.4.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.3.1...v1.4.0
+[1.3.1]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.3.0...v1.3.1
+[1.3.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.2.0...v1.3.0
+[1.2.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.1.0...v1.2.0
+[1.1.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/mcp-telegram/mcp-telegram/releases/tag/v1.0.0

package/README.md

@@ -8,7 +8,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![mcp-telegram MCP server](https://glama.ai/mcp/servers/overpod/mcp-telegram/badges/score.svg)](https://glama.ai/mcp/servers/overpod/mcp-telegram)
 
-> **Hosted version available!** Don't want to self-host? Use [mcp-telegram.com](https://mcp-telegram.com) -- connect Telegram to Claude.ai or ChatGPT in 30 seconds with QR code. No API keys needed.
+> **[📖 Documentation](https://mcp-telegram.github.io/mcp-telegram/)** · **[☁️ Cloud version](https://mcp-telegram.com)** — connect Telegram to Claude.ai or ChatGPT in 30 seconds with QR code, no API keys needed.
 
 <p align="center">
   <img src="assets/demo.gif" alt="MCP Telegram demo — connect and summarize chats in Claude" width="700">
@@ -18,10 +18,14 @@ An MCP (Model Context Protocol) server that connects AI assistants like Claude t
 
 ## Features
 
+- **59 tools** -- the most comprehensive Telegram MCP server available
 - **MTProto protocol** -- direct Telegram API access, not the limited Bot API
 - **Userbot** -- operates as your personal account, not a bot
-- **Full-featured** -- messaging, reactions, polls, scheduled messages, media, contacts, and more
+- **Full-featured** -- messaging, reactions, polls, scheduled messages, stickers, media, contacts, and more
 - **Forum Topics** -- list topics, read per-topic messages, send to specific topics, per-topic unread counts
+- **Stickers** -- search sticker sets, browse installed/recent stickers, send stickers to any chat
+- **Account management** -- update profile, manage privacy settings, sessions, auto-delete timers
+- **Global search** -- search messages across all chats at once
 - **QR code login** -- authenticate by scanning a QR code in the Telegram app
 - **Session persistence** -- login once, stay connected across restarts
 - **Human-readable output** -- sender names are resolved, not just numeric IDs
@@ -130,10 +134,35 @@ mcp-telegram          # run server
 mcp-telegram login    # QR login
 ```
 
+### Pre-built binary (no runtime needed)
+
+Download from [Releases](https://github.com/mcp-telegram/mcp-telegram/releases) — standalone single-file binaries, zero dependencies:
+
+| Platform | Server | Login CLI |
+|----------|--------|-----------|
+| Linux x64 | `mcp-telegram-linux-x64` | `mcp-telegram-login-linux-x64` |
+| Linux ARM64 | `mcp-telegram-linux-arm64` | `mcp-telegram-login-linux-arm64` |
+| macOS x64 | `mcp-telegram-darwin-x64` | `mcp-telegram-login-darwin-x64` |
+| macOS ARM64 | `mcp-telegram-darwin-arm64` | `mcp-telegram-login-darwin-arm64` |
+| Windows x64 | `mcp-telegram-windows-x64.exe` | `mcp-telegram-login-windows-x64.exe` |
+
+```bash
+# Download (example for Linux x64)
+curl -L -o mcp-telegram https://github.com/mcp-telegram/mcp-telegram/releases/latest/download/mcp-telegram-linux-x64
+curl -L -o mcp-telegram-login https://github.com/mcp-telegram/mcp-telegram/releases/latest/download/mcp-telegram-login-linux-x64
+chmod +x mcp-telegram mcp-telegram-login
+
+# Login
+TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH ./mcp-telegram-login
+
+# Run
+./mcp-telegram
+```
+
 ### From source
 
 ```bash
-git clone https://github.com/overpod/mcp-telegram.git
+git clone https://github.com/mcp-telegram/mcp-telegram.git
 cd mcp-telegram
 npm install && npm run build
 ```
@@ -141,7 +170,7 @@ npm install && npm run build
 ### Docker
 
 ```bash
-docker build -t mcp-telegram https://github.com/overpod/mcp-telegram.git
+docker build -t mcp-telegram https://github.com/mcp-telegram/mcp-telegram.git
 ```
 
 Login (interactive terminal required):
@@ -208,6 +237,24 @@ claude mcp add telegram -s user \
 
 > **Note**: No terminal required! Login works entirely through Claude Desktop.
 
+### Claude Desktop (Binary)
+
+Same setup, but using the pre-built binary instead of npx:
+
+```json
+{
+  "mcpServers": {
+    "telegram": {
+      "command": "/path/to/mcp-telegram",
+      "env": {
+        "TELEGRAM_API_ID": "YOUR_ID",
+        "TELEGRAM_API_HASH": "YOUR_HASH"
+      }
+    }
+  }
+}
+```
+
 ### Claude Desktop (Docker)
 
 1. Login via terminal first (see [Docker](#docker) section above).
@@ -257,13 +304,31 @@ const telegramMcp = new MCPClient({
 });
 ```
 
-## Tools
+## Tools (59)
 
 All tools are auto-discoverable via MCP — your AI client will see the full list with parameters and descriptions when connected.
 
-**Categories:** authentication, messaging (send, edit, delete, forward, schedule, polls), reading (chats, messages, search, unread), forum topics, group management (create, edit, invite, kick, ban, admin, leave), contacts & moderation, user profiles, reactions, media.
-
-> **Tip**: Ask your AI assistant *"What Telegram tools are available?"* to get the current list with parameters.
+| Category | Tools |
+|----------|-------|
+| **Auth** | `telegram-status`, `telegram-login` |
+| **Messaging** | `telegram-send-message`, `telegram-edit-message`, `telegram-delete-message`, `telegram-forward-message`, `telegram-send-scheduled` |
+| **Reading** | `telegram-list-chats`, `telegram-read-messages`, `telegram-search-messages`, `telegram-search-global`, `telegram-search-chats`, `telegram-get-unread`, `telegram-mark-as-read` |
+| **Forum Topics** | `telegram-list-topics`, `telegram-read-topic-messages` |
+| **Polls** | `telegram-create-poll` |
+| **Reactions** | `telegram-send-reaction`, `telegram-get-reactions` |
+| **Stickers** | `telegram-send-sticker`, `telegram-get-installed-stickers`, `telegram-get-recent-stickers`, `telegram-get-sticker-set`, `telegram-search-sticker-sets` |
+| **Media** | `telegram-send-file`, `telegram-download-media`, `telegram-get-profile-photo` |
+| **Groups** | `telegram-create-group`, `telegram-edit-group`, `telegram-invite-to-group`, `telegram-join-chat`, `telegram-leave-group`, `telegram-kick-user`, `telegram-ban-user`, `telegram-unban-user`, `telegram-set-admin`, `telegram-remove-admin`, `telegram-get-my-role` |
+| **Chat Info** | `telegram-get-chat-info`, `telegram-get-chat-members`, `telegram-get-chat-folders` |
+| **Invite Links** | `telegram-create-invite-link`, `telegram-get-invite-links`, `telegram-revoke-invite-link` |
+| **Contacts** | `telegram-get-contacts`, `telegram-add-contact`, `telegram-get-contact-requests` |
+| **Moderation** | `telegram-block-user`, `telegram-unblock-user`, `telegram-report-spam` |
+| **Profiles** | `telegram-get-profile`, `telegram-update-profile` |
+| **Account** | `telegram-get-sessions`, `telegram-terminate-session`, `telegram-set-privacy`, `telegram-set-auto-delete` |
+| **Pinning** | `telegram-pin-message`, `telegram-unpin-message` |
+| **Chat Settings** | `telegram-mute-chat` |
+
+> **Tip**: Ask your AI assistant *"What Telegram tools are available?"* to get the full list with parameters and descriptions.
 
 ## Development
 
@@ -289,9 +354,11 @@ src/
     messages.ts       -- Send, read, search, edit, delete, forward
     chats.ts          -- Chat listing, group management, admin
     contacts.ts       -- Contacts, profiles, moderation
-    media.ts          -- Files, photos
+    media.ts          -- Files, photos, downloads
     reactions.ts      -- Reactions
     extras.ts         -- Pin, schedule, polls, topics
+    stickers.ts       -- Sticker sets, send, search, browse
+    account.ts        -- Sessions, privacy, auto-delete, profile, chat mute/folders, invite links
     shared.ts         -- Shared utilities
 ```
 

package/dist/telegram-client.d.ts

@@ -370,4 +370,30 @@ export declare class TelegramService {
         bio?: string;
     }): Promise<void>;
     updateUsername(username: string): Promise<void>;
+    getStickerSet(shortName: string): Promise<{
+        title: string;
+        shortName: string;
+        count: number;
+        stickers: Array<{
+            id: string;
+            accessHash: string;
+            emoji: string;
+        }>;
+    }>;
+    searchStickerSets(query: string): Promise<Array<{
+        title: string;
+        shortName: string;
+        count: number;
+    }>>;
+    getInstalledStickerSets(): Promise<Array<{
+        title: string;
+        shortName: string;
+        count: number;
+    }>>;
+    sendSticker(chatId: string, stickerSetShortName: string, stickerIndex: number, replyTo?: number): Promise<Api.Message | Api.UpdateShortSentMessage | undefined>;
+    getRecentStickers(): Promise<Array<{
+        id: string;
+        accessHash: string;
+        emoji: string;
+    }>>;
 }

package/dist/telegram-client.js

@@ -1832,4 +1832,116 @@ export class TelegramService {
             throw new Error(NOT_CONNECTED_ERROR);
         await this.client.invoke(new Api.account.UpdateUsername({ username }));
     }
+    // ─── Stickers ──────────────────────────────────────────────
+    async getStickerSet(shortName) {
+        if (!this.client || !this.connected)
+            throw new Error(NOT_CONNECTED_ERROR);
+        const result = await this.client.invoke(new Api.messages.GetStickerSet({
+            stickerset: new Api.InputStickerSetShortName({ shortName }),
+            hash: 0,
+        }));
+        if (result instanceof Api.messages.StickerSetNotModified) {
+            throw new Error("Sticker set was not modified");
+        }
+        const set = result.set;
+        const packs = result.packs;
+        // Build emoji map: document id -> emoji
+        const emojiMap = new Map();
+        for (const pack of packs) {
+            for (const docId of pack.documents) {
+                emojiMap.set(docId.toString(), pack.emoticon);
+            }
+        }
+        return {
+            title: set.title,
+            shortName: set.shortName,
+            count: set.count,
+            stickers: result.documents.map((doc) => ({
+                id: doc.id.toString(),
+                accessHash: doc.accessHash.toString(),
+                emoji: emojiMap.get(doc.id.toString()) || "",
+            })),
+        };
+    }
+    async searchStickerSets(query) {
+        if (!this.client || !this.connected)
+            throw new Error(NOT_CONNECTED_ERROR);
+        const result = await this.client.invoke(new Api.messages.SearchStickerSets({
+            q: query,
+            hash: bigInt(0),
+        }));
+        if (result instanceof Api.messages.FoundStickerSetsNotModified) {
+            return [];
+        }
+        return result.sets.map((covered) => {
+            const set = covered.set;
+            return {
+                title: set.title,
+                shortName: set.shortName,
+                count: set.count,
+            };
+        });
+    }
+    async getInstalledStickerSets() {
+        if (!this.client || !this.connected)
+            throw new Error(NOT_CONNECTED_ERROR);
+        const result = await this.client.invoke(new Api.messages.GetAllStickers({ hash: bigInt(0) }));
+        if (result instanceof Api.messages.AllStickersNotModified) {
+            return [];
+        }
+        return result.sets.map((set) => ({
+            title: set.title,
+            shortName: set.shortName,
+            count: set.count,
+        }));
+    }
+    async sendSticker(chatId, stickerSetShortName, stickerIndex, replyTo) {
+        if (!this.client || !this.connected)
+            throw new Error(NOT_CONNECTED_ERROR);
+        return await this.rateLimiter.execute(async () => {
+            if (!Number.isInteger(stickerIndex)) {
+                throw new Error(`Sticker index must be an integer, got ${stickerIndex}`);
+            }
+            // Fetch raw sticker set to get the actual Api.Document with valid fileReference
+            const rawResult = await this.client?.invoke(new Api.messages.GetStickerSet({
+                stickerset: new Api.InputStickerSetShortName({ shortName: stickerSetShortName }),
+                hash: 0,
+            }));
+            if (!rawResult || rawResult instanceof Api.messages.StickerSetNotModified) {
+                throw new Error("Sticker set not found");
+            }
+            const stickerSet = rawResult;
+            if (stickerIndex < 0 || stickerIndex >= stickerSet.documents.length) {
+                throw new Error(`Sticker index ${stickerIndex} out of range (0-${stickerSet.documents.length - 1})`);
+            }
+            const sticker = stickerSet.documents[stickerIndex];
+            if (!(sticker instanceof Api.Document)) {
+                throw new Error("Selected sticker is not a valid document");
+            }
+            const resolved = await this.resolvePeer(chatId);
+            return await this.client?.sendFile(resolved, {
+                file: sticker,
+                ...(replyTo ? { replyTo } : {}),
+            });
+        }, `sendSticker to ${chatId}`);
+    }
+    async getRecentStickers() {
+        if (!this.client || !this.connected)
+            throw new Error(NOT_CONNECTED_ERROR);
+        const result = await this.client.invoke(new Api.messages.GetRecentStickers({ hash: bigInt(0) }));
+        if (result instanceof Api.messages.RecentStickersNotModified) {
+            return [];
+        }
+        const emojiMap = new Map();
+        for (const pack of result.packs) {
+            for (const docId of pack.documents) {
+                emojiMap.set(docId.toString(), pack.emoticon);
+            }
+        }
+        return result.stickers.map((doc) => ({
+            id: doc.id.toString(),
+            accessHash: doc.accessHash.toString(),
+            emoji: emojiMap.get(doc.id.toString()) || "",
+        }));
+    }
 }

package/dist/tools/index.js

@@ -6,6 +6,7 @@ import { registerExtraTools } from "./extras.js";
 import { registerMediaTools } from "./media.js";
 import { registerMessageTools } from "./messages.js";
 import { registerReactionTools } from "./reactions.js";
+import { registerStickerTools } from "./stickers.js";
 export function registerTools(server, telegram) {
     registerAuthTools(server, telegram);
     registerMessageTools(server, telegram);
@@ -15,4 +16,5 @@ export function registerTools(server, telegram) {
     registerReactionTools(server, telegram);
     registerExtraTools(server, telegram);
     registerAccountTools(server, telegram);
+    registerStickerTools(server, telegram);
 }

package/dist/tools/stickers.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { TelegramService } from "../telegram-client.js";
+export declare function registerStickerTools(server: McpServer, telegram: TelegramService): void;

package/dist/tools/stickers.js

@@ -0,0 +1,137 @@
+import { z } from "zod";
+import { fail, ok, READ_ONLY, requireConnection, sanitize, WRITE } from "./shared.js";
+export function registerStickerTools(server, telegram) {
+    server.registerTool("telegram-get-sticker-set", {
+        description: "Get all stickers from a sticker set by its short name. Returns each sticker with index and emoji. Use the index with telegram-send-sticker to send a specific sticker",
+        inputSchema: {
+            shortName: z
+                .string()
+                .describe("Short name of the sticker set (e.g. 'AnimatedEmojis', 'HotCherry'). Find names via telegram-search-sticker-sets or from t.me/addstickers/<shortName> links"),
+        },
+        annotations: READ_ONLY,
+    }, async ({ shortName }) => {
+        const err = await requireConnection(telegram);
+        if (err)
+            return fail(new Error(err));
+        try {
+            const set = await telegram.getStickerSet(shortName);
+            const lines = [];
+            lines.push(`📦 ${set.title} (${set.shortName})`);
+            lines.push(`${set.count} stickers`);
+            lines.push("");
+            for (let i = 0; i < set.stickers.length; i++) {
+                const s = set.stickers[i];
+                lines.push(`[${i}] ${s.emoji}`);
+            }
+            lines.push("");
+            lines.push(`Send a sticker: telegram-send-sticker(chatId, stickerSet="${set.shortName}", index=N)`);
+            return ok(sanitize(lines.join("\n")));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("telegram-search-sticker-sets", {
+        description: "Search for sticker sets by name or keyword. Returns matching sticker pack names that can be used with telegram-get-sticker-set",
+        inputSchema: {
+            query: z.string().describe("Search query (e.g. 'cat', 'love', 'pepe', 'anime')"),
+        },
+        annotations: READ_ONLY,
+    }, async ({ query }) => {
+        const err = await requireConnection(telegram);
+        if (err)
+            return fail(new Error(err));
+        try {
+            const sets = await telegram.searchStickerSets(query);
+            if (sets.length === 0) {
+                return ok(`No sticker sets found for "${query}". Try different keywords.`);
+            }
+            const lines = [];
+            lines.push(`Found ${sets.length} sticker set(s) for "${query}":\n`);
+            for (const set of sets) {
+                lines.push(`• ${set.title} — ${set.count} stickers`);
+                lines.push(`  Short name: ${set.shortName}`);
+            }
+            lines.push("");
+            lines.push("Use telegram-get-sticker-set(shortName) to see individual stickers.");
+            return ok(sanitize(lines.join("\n")));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("telegram-get-installed-stickers", {
+        description: "List all sticker sets installed by the user. Returns pack names and short names for use with other sticker tools",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        const err = await requireConnection(telegram);
+        if (err)
+            return fail(new Error(err));
+        try {
+            const sets = await telegram.getInstalledStickerSets();
+            if (sets.length === 0) {
+                return ok("No sticker sets installed.");
+            }
+            const lines = [];
+            lines.push(`${sets.length} installed sticker set(s):\n`);
+            for (const set of sets) {
+                lines.push(`• ${set.title} — ${set.count} stickers`);
+                lines.push(`  Short name: ${set.shortName}`);
+            }
+            return ok(sanitize(lines.join("\n")));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("telegram-send-sticker", {
+        description: "Send a sticker from a sticker set to a chat. First use telegram-get-sticker-set to browse available stickers and find the index",
+        inputSchema: {
+            chatId: z.string().describe("Chat ID or username"),
+            stickerSet: z.string().describe("Short name of the sticker set (e.g. 'HotCherry')"),
+            index: z
+                .number()
+                .int()
+                .nonnegative()
+                .describe("Index of the sticker in the set (0-based, get from telegram-get-sticker-set)"),
+            replyTo: z.number().int().optional().describe("Message ID to reply to"),
+        },
+        annotations: WRITE,
+    }, async ({ chatId, stickerSet, index, replyTo }) => {
+        const err = await requireConnection(telegram);
+        if (err)
+            return fail(new Error(err));
+        try {
+            await telegram.sendSticker(chatId, stickerSet, index, replyTo);
+            return ok(`Sticker sent from "${stickerSet}" [${index}] to ${chatId}`);
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("telegram-get-recent-stickers", {
+        description: "Get recently used stickers. Returns each sticker with its list index and associated emoji",
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        const err = await requireConnection(telegram);
+        if (err)
+            return fail(new Error(err));
+        try {
+            const stickers = await telegram.getRecentStickers();
+            if (stickers.length === 0) {
+                return ok("No recent stickers.");
+            }
+            const lines = [];
+            lines.push(`${stickers.length} recent sticker(s):\n`);
+            for (let i = 0; i < stickers.length; i++) {
+                lines.push(`[${i}] ${stickers[i].emoji}`);
+            }
+            return ok(sanitize(lines.join("\n")));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@overpod/mcp-telegram",
-  "version": "1.23.0",
+  "version": "1.24.1",
   "description": "MCP server for Telegram userbot — messages, media, reactions, polls & more. Built on GramJS/MTProto.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,10 @@
     "lint:fix": "biome check --fix src/",
     "format": "biome format --write src/",
     "test": "tsx --test src/**/*.test.ts",
-    "test:watch": "tsx --test --watch src/**/*.test.ts"
+    "test:watch": "tsx --test --watch src/**/*.test.ts",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
   },
   "keywords": [
     "mcp",
@@ -45,24 +48,25 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/overpod/mcp-telegram.git"
+    "url": "https://github.com/mcp-telegram/mcp-telegram.git"
   },
-  "homepage": "https://github.com/overpod/mcp-telegram#readme",
+  "homepage": "https://github.com/mcp-telegram/mcp-telegram#readme",
   "bugs": {
-    "url": "https://github.com/overpod/mcp-telegram/issues"
+    "url": "https://github.com/mcp-telegram/mcp-telegram/issues"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "dotenv": "^17.3.1",
+    "dotenv": "^17.4.2",
     "qrcode": "^1.5.4",
     "telegram": "^2.26.22",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.10",
-    "@types/node": "^25.5.0",
+    "@biomejs/biome": "^2.4.12",
+    "@types/node": "^25.6.0",
     "@types/qrcode": "^1.5.6",
     "tsx": "^4.21.0",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.3",
+    "vitepress": "^1.6.4"
   }
 }