{"_id":"@node2flow/telegram-bot-mcp","_rev":"5-3ea79510229ec9d9df85aa6915ac28a9","name":"@node2flow/telegram-bot-mcp","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.0":{"name":"@node2flow/telegram-bot-mcp","version":"1.0.0","keywords":["telegram","bot","mcp","model-context-protocol","ai","claude","cursor","chatbot","messaging"],"author":{"name":"Node2Flow","email":"node2flow@gmail.com"},"license":"MIT","_id":"@node2flow/telegram-bot-mcp@1.0.0","maintainers":[{"name":"node2flow","email":"node2flow@gmail.com"}],"homepage":"https://github.com/node2flow-th/telegram-bot-mcp-community","bugs":{"url":"https://github.com/node2flow-th/telegram-bot-mcp-community/issues"},"bin":{"telegram-bot-mcp":"dist/index.js"},"dist":{"shasum":"960c85baed5d0518d6f2d2471d8cf501f363a5d2","tarball":"https://registry.npmjs.org/@node2flow/telegram-bot-mcp/-/telegram-bot-mcp-1.0.0.tgz","fileCount":27,"integrity":"sha512-kD2UWMZb6LgdfQAzJ440NF0UaT4iIp+cJ6xdd4btmRoCMeIZ9rE7poG1p3vIxsKHEZefjtopVqBx0Y79eC8JsQ==","signatures":[{"sig":"MEQCICi1+DnX9CO7ef5O0ozBuQcRwpSD4jUxoOqFNep5ieKEAiBBmHzWCM5W6cbmmw4W9lr8P1Je27U26PE/V5NhAo6Gog==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92413},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"8b05d718afa17414230a018b526d305d6a8b581b","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","deploy":"wrangler deploy","prepublishOnly":"npm run build"},"_npmUser":{"name":"node2flow","email":"node2flow@gmail.com"},"repository":{"url":"git+https://github.com/node2flow-th/telegram-bot-mcp-community.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Telegram Bot API — send messages, manage chats, webhooks, files, and more through 27 tools","directories":{},"_nodeVersion":"22.20.0","dependencies":{"@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","wrangler":"^4.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/telegram-bot-mcp_1.0.0_1770797484668_0.9797706654042879","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@node2flow/telegram-bot-mcp","version":"1.0.1","keywords":["telegram","bot","mcp","model-context-protocol","ai","claude","cursor","chatbot","messaging"],"author":{"name":"Node2Flow","email":"node2flow@gmail.com"},"license":"MIT","_id":"@node2flow/telegram-bot-mcp@1.0.1","maintainers":[{"name":"node2flow","email":"node2flow@gmail.com"}],"homepage":"https://github.com/node2flow-th/telegram-bot-mcp-community","bugs":{"url":"https://github.com/node2flow-th/telegram-bot-mcp-community/issues"},"bin":{"telegram-bot-mcp":"dist/index.js"},"dist":{"shasum":"11ce974f6dcdffca7e56724aaba5b6b8f9b63e90","tarball":"https://registry.npmjs.org/@node2flow/telegram-bot-mcp/-/telegram-bot-mcp-1.0.1.tgz","fileCount":27,"integrity":"sha512-0heQslFR/vpXR4/BnKbuRcnIcsMWjOUZLfnhyQFOdjAoQnrgu6hFIPCWWr5q1TYn/tVjuAwtHY4jr5pGANFdxA==","signatures":[{"sig":"MEUCIQCX0L9xLNriOD5QirHkae2x6H6LtEeXPpD9TpagN3BJegIgdyHQ361lismMoK/PJZqmsZAA38WB1Bluv9xz82yoXig=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92535},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"5859e3572211515c397c8d816e7dc43f878a63de","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","deploy":"wrangler deploy","prepublishOnly":"npm run build"},"_npmUser":{"name":"node2flow","email":"node2flow@gmail.com"},"repository":{"url":"git+https://github.com/node2flow-th/telegram-bot-mcp-community.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Telegram Bot API — send messages, manage chats, webhooks, files, and more through 27 tools","directories":{},"_nodeVersion":"22.20.0","dependencies":{"@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","wrangler":"^4.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/telegram-bot-mcp_1.0.1_1770814695342_0.591169650946179","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@node2flow/telegram-bot-mcp","version":"1.0.2","keywords":["telegram","bot","mcp","model-context-protocol","ai","claude","cursor","chatbot","messaging"],"author":{"name":"Node2Flow","email":"node2flow@gmail.com"},"license":"MIT","_id":"@node2flow/telegram-bot-mcp@1.0.2","maintainers":[{"name":"node2flow","email":"node2flow@gmail.com"}],"homepage":"https://github.com/node2flow-th/telegram-bot-mcp-community","bugs":{"url":"https://github.com/node2flow-th/telegram-bot-mcp-community/issues"},"bin":{"telegram-bot-mcp":"dist/index.js"},"dist":{"shasum":"b05cc2a4c166006b580621028a7cb7cf7c2573e8","tarball":"https://registry.npmjs.org/@node2flow/telegram-bot-mcp/-/telegram-bot-mcp-1.0.2.tgz","fileCount":27,"integrity":"sha512-XYe4q4AxX05VvbzJFJr8mwmZioYB0MPeG0FXwU/WHYnDYQJqpVs81VfgA0IoN9zZ7xGPn2H2lUTNsM5LJZ59tQ==","signatures":[{"sig":"MEUCIEartLQm3ETBh1/A8bAM25UrNeiTqLkT7R4rcdrZ0jUfAiEA4hSO5GkXLXIoPGQBMQz3AREA2yUqOzFsjTur/LrcD8w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":106255},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"6b75a85af0e957aa2097a1e572d757633ac05983","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","deploy":"wrangler deploy","prepublishOnly":"npm run build"},"_npmUser":{"name":"node2flow","email":"node2flow@gmail.com"},"repository":{"url":"git+https://github.com/node2flow-th/telegram-bot-mcp-community.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Telegram Bot API — send messages, manage chats, webhooks, files, and more through 27 tools","directories":{},"_nodeVersion":"22.20.0","dependencies":{"@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","wrangler":"^4.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/telegram-bot-mcp_1.0.2_1770831423787_0.31405847580263657","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@node2flow/telegram-bot-mcp","version":"1.0.3","keywords":["telegram","bot","mcp","model-context-protocol","ai","claude","cursor","chatbot","messaging"],"author":{"name":"Node2Flow","email":"node2flow@gmail.com"},"license":"MIT","_id":"@node2flow/telegram-bot-mcp@1.0.3","maintainers":[{"name":"node2flow","email":"node2flow@gmail.com"}],"homepage":"https://github.com/node2flow-th/telegram-bot-mcp-community","bugs":{"url":"https://github.com/node2flow-th/telegram-bot-mcp-community/issues"},"bin":{"telegram-bot-mcp":"dist/index.js"},"dist":{"shasum":"11f36c4512dc305589f4cbfe09679fe04cf27ac0","tarball":"https://registry.npmjs.org/@node2flow/telegram-bot-mcp/-/telegram-bot-mcp-1.0.3.tgz","fileCount":27,"integrity":"sha512-WhoFS8Nr1Jr7ltb8g+RdWijfT+nvrJtrDzvorgxsrWr6VaGx877n5d1fariPWaEEIj02hB70hyNKpKrc3dWGzg==","signatures":[{"sig":"MEQCICUf1Dk4neOCWXEmabYY4bPrC6As3BwzflsxvQ0r8uDfAiBw4XXZV6TMAlrpcbo/C+mFtmtwuZFhZkxliUp0QjbCyw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":107160},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"d4fff4e27456824a57b500fb2e07e7d80929a848","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","deploy":"wrangler deploy","prepublishOnly":"npm run build"},"_npmUser":{"name":"node2flow","email":"node2flow@gmail.com"},"repository":{"url":"git+https://github.com/node2flow-th/telegram-bot-mcp-community.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Telegram Bot API — send messages, manage chats, webhooks, files, and more through 27 tools","directories":{},"_nodeVersion":"22.20.0","dependencies":{"@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","wrangler":"^4.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/telegram-bot-mcp_1.0.3_1770871857078_0.452035453604827","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@node2flow/telegram-bot-mcp","version":"1.0.4","description":"MCP server for Telegram Bot API — send messages, manage chats, webhooks, files, and more through 27 tools","keywords":["telegram","bot","mcp","model-context-protocol","ai","claude","cursor","chatbot","messaging"],"author":{"name":"Node2Flow","email":"node2flow@gmail.com"},"license":"MIT","homepage":"https://github.com/node2flow-th/telegram-bot-mcp-community","repository":{"type":"git","url":"git+https://github.com/node2flow-th/telegram-bot-mcp-community.git"},"type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"telegram-bot-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts","deploy":"wrangler deploy","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.26.0"},"devDependencies":{"@types/node":"^22.0.0","tsx":"^4.19.0","typescript":"^5.7.0","wrangler":"^4.0.0"},"engines":{"node":">=18"},"gitHead":"56ef09d8eae793bc72b8ceb23933ffe685f241c1","_id":"@node2flow/telegram-bot-mcp@1.0.4","bugs":{"url":"https://github.com/node2flow-th/telegram-bot-mcp-community/issues"},"_nodeVersion":"22.20.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-V2t2vIXLxhoRbKWywrQvoHnGmOb334jg7JsZiNCHZvvioBRaMz+/ZEowhduhJ8DFwYQXNxfzYjoRAPqsYOV3zA==","shasum":"0604b1d6d9396656fa3cd699ded0ae5d0b5e815e","tarball":"https://registry.npmjs.org/@node2flow/telegram-bot-mcp/-/telegram-bot-mcp-1.0.4.tgz","fileCount":27,"unpackedSize":107618,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCd5T71MVcxzHaCxOl+3HTlXYj9OiV3099DyaWQAv6FAgIhAL7Ar6s+aUBbJELcIqk9cjv0vDHbiJHVDjakz3oZR6g5"}]},"_npmUser":{"name":"node2flow","email":"node2flow@gmail.com"},"directories":{},"maintainers":[{"name":"node2flow","email":"node2flow@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/telegram-bot-mcp_1.0.4_1770874125188_0.7456525257171251"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-11T08:11:24.465Z","modified":"2026-02-12T05:28:45.447Z","1.0.0":"2026-02-11T08:11:24.814Z","1.0.1":"2026-02-11T12:58:15.629Z","1.0.2":"2026-02-11T17:37:03.926Z","1.0.3":"2026-02-12T04:50:57.240Z","1.0.4":"2026-02-12T05:28:45.340Z"},"bugs":{"url":"https://github.com/node2flow-th/telegram-bot-mcp-community/issues"},"author":{"name":"Node2Flow","email":"node2flow@gmail.com"},"license":"MIT","homepage":"https://github.com/node2flow-th/telegram-bot-mcp-community","keywords":["telegram","bot","mcp","model-context-protocol","ai","claude","cursor","chatbot","messaging"],"repository":{"type":"git","url":"git+https://github.com/node2flow-th/telegram-bot-mcp-community.git"},"description":"MCP server for Telegram Bot API — send messages, manage chats, webhooks, files, and more through 27 tools","maintainers":[{"name":"node2flow","email":"node2flow@gmail.com"}],"readme":"# Telegram Bot MCP Server\r\n\r\n[![smithery badge](https://smithery.ai/badge/node2flow/telegram-bot)](https://smithery.ai/server/node2flow/telegram-bot)\r\n[![npm version](https://img.shields.io/npm/v/@node2flow/telegram-bot-mcp.svg)](https://www.npmjs.com/package/@node2flow/telegram-bot-mcp)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\r\n\r\nMCP (Model Context Protocol) server for Telegram Bot API. Send messages, manage chats, handle webhooks, and more through 27 tools.\r\n\r\nWorks with Claude Desktop, Cursor, VS Code, and any MCP client.\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\n### Claude Desktop\r\n\r\nAdd to `claude_desktop_config.json`:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"telegram\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@node2flow/telegram-bot-mcp\"],\r\n      \"env\": {\r\n        \"TELEGRAM_BOT_TOKEN\": \"your-bot-token\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Cursor / VS Code\r\n\r\nAdd to MCP settings:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"telegram\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@node2flow/telegram-bot-mcp\"],\r\n      \"env\": {\r\n        \"TELEGRAM_BOT_TOKEN\": \"your-bot-token\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### HTTP Mode (Streamable HTTP)\r\n\r\nFor remote deployment or shared access:\r\n\r\n```bash\r\nTELEGRAM_BOT_TOKEN=your_token npx @node2flow/telegram-bot-mcp --http\r\n```\r\n\r\nServer starts on port 3000 (configurable via `PORT` env var). MCP endpoint: `http://localhost:3000/mcp`\r\n\r\n---\r\n\r\n## Configuration\r\n\r\n| Environment Variable | Required | Description |\r\n|---|---|---|\r\n| `TELEGRAM_BOT_TOKEN` | Yes | Telegram Bot token from [@BotFather](https://t.me/BotFather) |\r\n| `PORT` | No | Port for HTTP server (default: `3000`, only used with `--http`) |\r\n\r\n---\r\n\r\n## All Tools (27 tools)\r\n\r\n### Bot Info (2 tools)\r\n\r\n| Tool | Description |\r\n|---|---|\r\n| `tg_get_me` | Get bot information |\r\n| `tg_set_my_commands` | Set bot command menu |\r\n\r\n### Send Messages (8 tools)\r\n\r\n| Tool | Description |\r\n|---|---|\r\n| `tg_send_message` | Send text with Markdown/HTML formatting |\r\n| `tg_send_photo` | Send photo (URL or file_id) |\r\n| `tg_send_document` | Send document/file (max 50MB) |\r\n| `tg_send_video` | Send video (MPEG4, max 50MB) |\r\n| `tg_send_audio` | Send audio (MP3/M4A, max 50MB) |\r\n| `tg_send_location` | Send geographic location |\r\n| `tg_send_poll` | Send poll (regular or quiz) |\r\n| `tg_send_contact` | Send phone contact card |\r\n\r\n### Edit/Delete (3 tools)\r\n\r\n| Tool | Description |\r\n|---|---|\r\n| `tg_edit_message_text` | Edit message text |\r\n| `tg_edit_message_caption` | Edit media caption |\r\n| `tg_delete_message` | Delete a message (48hr limit) |\r\n\r\n### Chat Management (5 tools)\r\n\r\n| Tool | Description |\r\n|---|---|\r\n| `tg_get_chat` | Get chat details |\r\n| `tg_get_chat_member_count` | Get member count |\r\n| `tg_get_chat_member` | Get member info |\r\n| `tg_ban_chat_member` | Ban user from chat |\r\n| `tg_unban_chat_member` | Unban user |\r\n\r\n### Webhooks (3 tools)\r\n\r\n| Tool | Description |\r\n|---|---|\r\n| `tg_set_webhook` | Set webhook URL |\r\n| `tg_delete_webhook` | Remove webhook |\r\n| `tg_get_webhook_info` | Get webhook status |\r\n\r\n### Callbacks & Files (3 tools)\r\n\r\n| Tool | Description |\r\n|---|---|\r\n| `tg_answer_callback_query` | Answer inline button press |\r\n| `tg_get_file` | Get file download URL |\r\n| `tg_get_user_profile_photos` | Get user profile photos |\r\n\r\n### Pins & Invite Links (3 tools)\r\n\r\n| Tool | Description |\r\n|---|---|\r\n| `tg_pin_chat_message` | Pin a message |\r\n| `tg_unpin_chat_message` | Unpin a message |\r\n| `tg_create_chat_invite_link` | Create invite link |\r\n\r\n---\r\n\r\n## Requirements\r\n\r\n- **Node.js** 18+\r\n- **Telegram Bot token**\r\n\r\n### How to Create a Telegram Bot\r\n\r\n1. Open [@BotFather](https://t.me/BotFather) on Telegram\r\n2. Send `/newbot` and follow the prompts\r\n3. Copy the token and use it as `TELEGRAM_BOT_TOKEN`\r\n\r\n---\r\n\r\n## For Developers\r\n\r\n```bash\r\ngit clone https://github.com/node2flow-th/telegram-bot-mcp-community.git\r\ncd telegram-bot-mcp-community\r\nnpm install\r\nnpm run build\r\n\r\n# Run in stdio mode\r\nTELEGRAM_BOT_TOKEN=your_token npm start\r\n\r\n# Run in dev mode (hot reload)\r\nTELEGRAM_BOT_TOKEN=your_token npm run dev\r\n\r\n# Run in HTTP mode\r\nTELEGRAM_BOT_TOKEN=your_token npm start -- --http\r\n```\r\n\r\n---\r\n\r\n## License\r\n\r\nMIT License - see [LICENSE](LICENSE)\r\n\r\nCopyright (c) 2026 [Node2Flow](https://node2flow.net)\r\n\r\n## Links\r\n\r\n- [npm Package](https://www.npmjs.com/package/@node2flow/telegram-bot-mcp)\r\n- [Telegram Bot API](https://core.telegram.org/bots/api)\r\n- [MCP Protocol](https://modelcontextprotocol.io/)\r\n- [Node2Flow](https://node2flow.net)\r\n","readmeFilename":"README.md"}