@overpod/mcp-telegram 1.24.0 → 1.24.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/CHANGELOG.md +50 -25
  2. package/README.md +36 -12
  3. package/dist/tools/stickers.js +2 -4
  4. package/package.json +13 -9
package/CHANGELOG.md CHANGED
@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [1.24.1] - 2026-04-20
11
+
12
+ ### Changed
13
+ - 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
14
+ - `biome.json` migrated to schema 2.4.12
15
+
16
+ ## [1.24.0] - 2026-04-06
17
+
18
+ ### Added
19
+ - **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`
20
+ - **Pre-built binaries** — zero-dependency standalone executables for Linux (x64/ARM64), macOS (x64/ARM64), Windows (x64)
21
+ - **Documentation site** — VitePress-based docs at overpod.github.io/mcp-telegram with i18n (English, Russian, Chinese)
22
+
23
+ ## [1.23.0] - 2026-04-05
24
+
25
+ ### Added
26
+ - 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`
27
+ - Account management tools: `telegram-get-sessions`, `telegram-terminate-session`, `telegram-set-privacy`, `telegram-set-auto-delete`, `telegram-update-profile`
28
+ - Better entity resolution for channels and supergroups
29
+
10
30
  ## [1.22.0] - 2026-04-01
11
31
 
12
32
  ### Added
@@ -257,28 +277,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
257
277
  - Session persistence
258
278
  - GramJS/MTProto integration
259
279
 
260
- [Unreleased]: https://github.com/overpod/mcp-telegram/compare/v1.19.0...HEAD
261
- [1.19.0]: https://github.com/overpod/mcp-telegram/compare/v1.18.0...v1.19.0
262
- [1.18.0]: https://github.com/overpod/mcp-telegram/compare/v1.17.0...v1.18.0
263
- [1.17.0]: https://github.com/overpod/mcp-telegram/compare/v1.16.0...v1.17.0
264
- [1.16.0]: https://github.com/overpod/mcp-telegram/compare/v1.15.0...v1.16.0
265
- [1.15.0]: https://github.com/overpod/mcp-telegram/compare/v1.14.0...v1.15.0
266
- [1.14.0]: https://github.com/overpod/mcp-telegram/compare/v1.13.0...v1.14.0
267
- [1.13.0]: https://github.com/overpod/mcp-telegram/compare/v1.12.0...v1.13.0
268
- [1.12.0]: https://github.com/overpod/mcp-telegram/compare/v1.11.1...v1.12.0
269
- [1.11.1]: https://github.com/overpod/mcp-telegram/compare/v1.11.0...v1.11.1
270
- [1.11.0]: https://github.com/overpod/mcp-telegram/compare/v1.10.1...v1.11.0
271
- [1.10.1]: https://github.com/overpod/mcp-telegram/compare/v1.10.0...v1.10.1
272
- [1.10.0]: https://github.com/overpod/mcp-telegram/compare/v1.9.0...v1.10.0
273
- [1.9.0]: https://github.com/overpod/mcp-telegram/compare/v1.8.1...v1.9.0
274
- [1.8.1]: https://github.com/overpod/mcp-telegram/compare/v1.8.0...v1.8.1
275
- [1.8.0]: https://github.com/overpod/mcp-telegram/compare/v1.7.0...v1.8.0
276
- [1.7.0]: https://github.com/overpod/mcp-telegram/compare/v1.6.0...v1.7.0
277
- [1.6.0]: https://github.com/overpod/mcp-telegram/compare/v1.5.0...v1.6.0
278
- [1.5.0]: https://github.com/overpod/mcp-telegram/compare/v1.4.0...v1.5.0
279
- [1.4.0]: https://github.com/overpod/mcp-telegram/compare/v1.3.1...v1.4.0
280
- [1.3.1]: https://github.com/overpod/mcp-telegram/compare/v1.3.0...v1.3.1
281
- [1.3.0]: https://github.com/overpod/mcp-telegram/compare/v1.2.0...v1.3.0
282
- [1.2.0]: https://github.com/overpod/mcp-telegram/compare/v1.1.0...v1.2.0
283
- [1.1.0]: https://github.com/overpod/mcp-telegram/compare/v1.0.0...v1.1.0
284
- [1.0.0]: https://github.com/overpod/mcp-telegram/releases/tag/v1.0.0
280
+ [Unreleased]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.24.0...HEAD
281
+ [1.24.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.23.0...v1.24.0
282
+ [1.23.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.22.0...v1.23.0
283
+ [1.22.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.21.0...v1.22.0
284
+ [1.21.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.20.0...v1.21.0
285
+ [1.20.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.19.0...v1.20.0
286
+ [1.19.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.18.0...v1.19.0
287
+ [1.18.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.17.0...v1.18.0
288
+ [1.17.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.16.0...v1.17.0
289
+ [1.16.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.15.0...v1.16.0
290
+ [1.15.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.14.0...v1.15.0
291
+ [1.14.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.13.0...v1.14.0
292
+ [1.13.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.12.0...v1.13.0
293
+ [1.12.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.11.1...v1.12.0
294
+ [1.11.1]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.11.0...v1.11.1
295
+ [1.11.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.10.1...v1.11.0
296
+ [1.10.1]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.10.0...v1.10.1
297
+ [1.10.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.9.0...v1.10.0
298
+ [1.9.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.8.1...v1.9.0
299
+ [1.8.1]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.8.0...v1.8.1
300
+ [1.8.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.7.0...v1.8.0
301
+ [1.7.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.6.0...v1.7.0
302
+ [1.6.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.5.0...v1.6.0
303
+ [1.5.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.4.0...v1.5.0
304
+ [1.4.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.3.1...v1.4.0
305
+ [1.3.1]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.3.0...v1.3.1
306
+ [1.3.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.2.0...v1.3.0
307
+ [1.2.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.1.0...v1.2.0
308
+ [1.1.0]: https://github.com/mcp-telegram/mcp-telegram/compare/v1.0.0...v1.1.0
309
+ [1.0.0]: https://github.com/mcp-telegram/mcp-telegram/releases/tag/v1.0.0
package/README.md CHANGED
@@ -8,7 +8,7 @@
8
8
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
9
9
  [![mcp-telegram MCP server](https://glama.ai/mcp/servers/overpod/mcp-telegram/badges/score.svg)](https://glama.ai/mcp/servers/overpod/mcp-telegram)
10
10
 
11
- > **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.
11
+ > **[📖 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.
12
12
 
13
13
  <p align="center">
14
14
  <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
18
18
 
19
19
  ## Features
20
20
 
21
+ - **59 tools** -- the most comprehensive Telegram MCP server available
21
22
  - **MTProto protocol** -- direct Telegram API access, not the limited Bot API
22
23
  - **Userbot** -- operates as your personal account, not a bot
23
- - **Full-featured** -- messaging, reactions, polls, scheduled messages, media, contacts, and more
24
+ - **Full-featured** -- messaging, reactions, polls, scheduled messages, stickers, media, contacts, and more
24
25
  - **Forum Topics** -- list topics, read per-topic messages, send to specific topics, per-topic unread counts
26
+ - **Stickers** -- search sticker sets, browse installed/recent stickers, send stickers to any chat
27
+ - **Account management** -- update profile, manage privacy settings, sessions, auto-delete timers
28
+ - **Global search** -- search messages across all chats at once
25
29
  - **QR code login** -- authenticate by scanning a QR code in the Telegram app
26
30
  - **Session persistence** -- login once, stay connected across restarts
27
31
  - **Human-readable output** -- sender names are resolved, not just numeric IDs
@@ -132,7 +136,7 @@ mcp-telegram login # QR login
132
136
 
133
137
  ### Pre-built binary (no runtime needed)
134
138
 
135
- Download from [Releases](https://github.com/overpod/mcp-telegram/releases) — standalone single-file binaries, zero dependencies:
139
+ Download from [Releases](https://github.com/mcp-telegram/mcp-telegram/releases) — standalone single-file binaries, zero dependencies:
136
140
 
137
141
  | Platform | Server | Login CLI |
138
142
  |----------|--------|-----------|
@@ -144,8 +148,8 @@ Download from [Releases](https://github.com/overpod/mcp-telegram/releases) — s
144
148
 
145
149
  ```bash
146
150
  # Download (example for Linux x64)
147
- curl -L -o mcp-telegram https://github.com/overpod/mcp-telegram/releases/latest/download/mcp-telegram-linux-x64
148
- curl -L -o mcp-telegram-login https://github.com/overpod/mcp-telegram/releases/latest/download/mcp-telegram-login-linux-x64
151
+ curl -L -o mcp-telegram https://github.com/mcp-telegram/mcp-telegram/releases/latest/download/mcp-telegram-linux-x64
152
+ curl -L -o mcp-telegram-login https://github.com/mcp-telegram/mcp-telegram/releases/latest/download/mcp-telegram-login-linux-x64
149
153
  chmod +x mcp-telegram mcp-telegram-login
150
154
 
151
155
  # Login
@@ -158,7 +162,7 @@ TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH ./mcp-telegram-login
158
162
  ### From source
159
163
 
160
164
  ```bash
161
- git clone https://github.com/overpod/mcp-telegram.git
165
+ git clone https://github.com/mcp-telegram/mcp-telegram.git
162
166
  cd mcp-telegram
163
167
  npm install && npm run build
164
168
  ```
@@ -166,7 +170,7 @@ npm install && npm run build
166
170
  ### Docker
167
171
 
168
172
  ```bash
169
- docker build -t mcp-telegram https://github.com/overpod/mcp-telegram.git
173
+ docker build -t mcp-telegram https://github.com/mcp-telegram/mcp-telegram.git
170
174
  ```
171
175
 
172
176
  Login (interactive terminal required):
@@ -300,13 +304,31 @@ const telegramMcp = new MCPClient({
300
304
  });
301
305
  ```
302
306
 
303
- ## Tools
307
+ ## Tools (59)
304
308
 
305
309
  All tools are auto-discoverable via MCP — your AI client will see the full list with parameters and descriptions when connected.
306
310
 
307
- **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.
308
-
309
- > **Tip**: Ask your AI assistant *"What Telegram tools are available?"* to get the current list with parameters.
311
+ | Category | Tools |
312
+ |----------|-------|
313
+ | **Auth** | `telegram-status`, `telegram-login` |
314
+ | **Messaging** | `telegram-send-message`, `telegram-edit-message`, `telegram-delete-message`, `telegram-forward-message`, `telegram-send-scheduled` |
315
+ | **Reading** | `telegram-list-chats`, `telegram-read-messages`, `telegram-search-messages`, `telegram-search-global`, `telegram-search-chats`, `telegram-get-unread`, `telegram-mark-as-read` |
316
+ | **Forum Topics** | `telegram-list-topics`, `telegram-read-topic-messages` |
317
+ | **Polls** | `telegram-create-poll` |
318
+ | **Reactions** | `telegram-send-reaction`, `telegram-get-reactions` |
319
+ | **Stickers** | `telegram-send-sticker`, `telegram-get-installed-stickers`, `telegram-get-recent-stickers`, `telegram-get-sticker-set`, `telegram-search-sticker-sets` |
320
+ | **Media** | `telegram-send-file`, `telegram-download-media`, `telegram-get-profile-photo` |
321
+ | **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` |
322
+ | **Chat Info** | `telegram-get-chat-info`, `telegram-get-chat-members`, `telegram-get-chat-folders` |
323
+ | **Invite Links** | `telegram-create-invite-link`, `telegram-get-invite-links`, `telegram-revoke-invite-link` |
324
+ | **Contacts** | `telegram-get-contacts`, `telegram-add-contact`, `telegram-get-contact-requests` |
325
+ | **Moderation** | `telegram-block-user`, `telegram-unblock-user`, `telegram-report-spam` |
326
+ | **Profiles** | `telegram-get-profile`, `telegram-update-profile` |
327
+ | **Account** | `telegram-get-sessions`, `telegram-terminate-session`, `telegram-set-privacy`, `telegram-set-auto-delete` |
328
+ | **Pinning** | `telegram-pin-message`, `telegram-unpin-message` |
329
+ | **Chat Settings** | `telegram-mute-chat` |
330
+
331
+ > **Tip**: Ask your AI assistant *"What Telegram tools are available?"* to get the full list with parameters and descriptions.
310
332
 
311
333
  ## Development
312
334
 
@@ -332,9 +354,11 @@ src/
332
354
  messages.ts -- Send, read, search, edit, delete, forward
333
355
  chats.ts -- Chat listing, group management, admin
334
356
  contacts.ts -- Contacts, profiles, moderation
335
- media.ts -- Files, photos
357
+ media.ts -- Files, photos, downloads
336
358
  reactions.ts -- Reactions
337
359
  extras.ts -- Pin, schedule, polls, topics
360
+ stickers.ts -- Sticker sets, send, search, browse
361
+ account.ts -- Sessions, privacy, auto-delete, profile, chat mute/folders, invite links
338
362
  shared.ts -- Shared utilities
339
363
  ```
340
364
 
package/dist/tools/stickers.js CHANGED
@@ -49,8 +49,7 @@ export function registerStickerTools(server, telegram) {
49
49
  const lines = [];
50
50
  lines.push(`Found ${sets.length} sticker set(s) for "${query}":\n`);
51
51
  for (const set of sets) {
52
- const flags = "";
53
- lines.push(`• ${set.title}${flags} — ${set.count} stickers`);
52
+ lines.push(`• ${set.title} — ${set.count} stickers`);
54
53
  lines.push(` Short name: ${set.shortName}`);
55
54
  }
56
55
  lines.push("");
@@ -77,8 +76,7 @@ export function registerStickerTools(server, telegram) {
77
76
  const lines = [];
78
77
  lines.push(`${sets.length} installed sticker set(s):\n`);
79
78
  for (const set of sets) {
80
- const flags = "";
81
- lines.push(`• ${set.title}${flags} — ${set.count} stickers`);
79
+ lines.push(`• ${set.title} — ${set.count} stickers`);
82
80
  lines.push(` Short name: ${set.shortName}`);
83
81
  }
84
82
  return ok(sanitize(lines.join("\n")));
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@overpod/mcp-telegram",
3
- "version": "1.24.0",
3
+ "version": "1.24.1",
4
4
  "description": "MCP server for Telegram userbot — messages, media, reactions, polls & more. Built on GramJS/MTProto.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -28,7 +28,10 @@
28
28
  "lint:fix": "biome check --fix src/",
29
29
  "format": "biome format --write src/",
30
30
  "test": "tsx --test src/**/*.test.ts",
31
- "test:watch": "tsx --test --watch src/**/*.test.ts"
31
+ "test:watch": "tsx --test --watch src/**/*.test.ts",
32
+ "docs:dev": "vitepress dev docs",
33
+ "docs:build": "vitepress build docs",
34
+ "docs:preview": "vitepress preview docs"
32
35
  },
33
36
  "keywords": [
34
37
  "mcp",
@@ -45,24 +48,25 @@
45
48
  "license": "MIT",
46
49
  "repository": {
47
50
  "type": "git",
48
- "url": "https://github.com/overpod/mcp-telegram.git"
51
+ "url": "https://github.com/mcp-telegram/mcp-telegram.git"
49
52
  },
50
- "homepage": "https://github.com/overpod/mcp-telegram#readme",
53
+ "homepage": "https://github.com/mcp-telegram/mcp-telegram#readme",
51
54
  "bugs": {
52
- "url": "https://github.com/overpod/mcp-telegram/issues"
55
+ "url": "https://github.com/mcp-telegram/mcp-telegram/issues"
53
56
  },
54
57
  "dependencies": {
55
58
  "@modelcontextprotocol/sdk": "^1.29.0",
56
- "dotenv": "^17.3.1",
59
+ "dotenv": "^17.4.2",
57
60
  "qrcode": "^1.5.4",
58
61
  "telegram": "^2.26.22",
59
62
  "zod": "^4.3.6"
60
63
  },
61
64
  "devDependencies": {
62
- "@biomejs/biome": "^2.4.10",
63
- "@types/node": "^25.5.0",
65
+ "@biomejs/biome": "^2.4.12",
66
+ "@types/node": "^25.6.0",
64
67
  "@types/qrcode": "^1.5.6",
65
68
  "tsx": "^4.21.0",
66
- "typescript": "^6.0.2"
69
+ "typescript": "^6.0.3",
70
+ "vitepress": "^1.6.4"
67
71
  }
68
72
  }