@overpod/mcp-telegram 1.24.0 → 1.25.0

package/dist/tools/reactions.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { fail, ok, READ_ONLY, requireConnection, WRITE } from "./shared.js";
+import { fail, ok, READ_ONLY, requireConnection, sanitize, WRITE } from "./shared.js";
 export function registerReactionTools(server, telegram) {
     server.registerTool("telegram-send-reaction", {
         description: "Send emoji reaction(s) to a message. Supports multiple reactions and adding to existing ones. Omit emoji to remove all reactions",
@@ -60,4 +60,62 @@ export function registerReactionTools(server, telegram) {
             return fail(e);
         }
     });
+    server.registerTool("telegram-set-default-reaction", {
+        description: "Set the default emoji reaction used in quick-reaction menus across Telegram",
+        inputSchema: {
+            emoji: z.string().min(1).max(8).describe("Emoji character (e.g. 👍 ❤️ 🔥)"),
+        },
+        annotations: WRITE,
+    }, async ({ emoji }) => {
+        const err = await requireConnection(telegram);
+        if (err)
+            return fail(new Error(err));
+        try {
+            await telegram.setDefaultReaction(emoji);
+            return ok(`Default reaction set to ${sanitize(emoji)}`);
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("telegram-get-top-reactions", {
+        description: "Get the list of most popular emoji reactions available on Telegram",
+        inputSchema: {
+            limit: z.number().int().min(1).max(100).default(20).describe("Max number of reactions to return"),
+        },
+        annotations: READ_ONLY,
+    }, async ({ limit }) => {
+        const err = await requireConnection(telegram);
+        if (err)
+            return fail(new Error(err));
+        try {
+            const reactions = await telegram.getTopReactions(limit);
+            if (reactions.length === 0)
+                return ok("No top reactions available");
+            return ok(sanitize(reactions.map((r) => r.emoji).join(" ")));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("telegram-get-recent-reactions", {
+        description: "Get the list of emoji reactions the current account used recently",
+        inputSchema: {
+            limit: z.number().int().min(1).max(100).default(20).describe("Max number of reactions to return"),
+        },
+        annotations: READ_ONLY,
+    }, async ({ limit }) => {
+        const err = await requireConnection(telegram);
+        if (err)
+            return fail(new Error(err));
+        try {
+            const reactions = await telegram.getRecentReactions(limit);
+            if (reactions.length === 0)
+                return ok("No recent reactions");
+            return ok(sanitize(reactions.map((r) => r.emoji).join(" ")));
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
 }

package/dist/tools/stickers.js

@@ -49,8 +49,7 @@ export function registerStickerTools(server, telegram) {
             const lines = [];
             lines.push(`Found ${sets.length} sticker set(s) for "${query}":\n`);
             for (const set of sets) {
-                const flags = "";
-                lines.push(`• ${set.title}${flags} — ${set.count} stickers`);
+                lines.push(`• ${set.title} — ${set.count} stickers`);
                 lines.push(`  Short name: ${set.shortName}`);
             }
             lines.push("");
@@ -77,8 +76,7 @@ export function registerStickerTools(server, telegram) {
             const lines = [];
             lines.push(`${sets.length} installed sticker set(s):\n`);
             for (const set of sets) {
-                const flags = "";
-                lines.push(`• ${set.title}${flags} — ${set.count} stickers`);
+                lines.push(`• ${set.title} — ${set.count} stickers`);
                 lines.push(`  Short name: ${set.shortName}`);
             }
             return ok(sanitize(lines.join("\n")));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@overpod/mcp-telegram",
-  "version": "1.24.0",
+  "version": "1.25.0",
   "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"
   }
 }