{"_id":"@harnyk/telegram-notifier-mcp","_rev":"4-a8dc43b15ee9b0fdd467faa86b9ca9a3","name":"@harnyk/telegram-notifier-mcp","dist-tags":{"latest":"0.1.6"},"versions":{"0.1.3":{"name":"@harnyk/telegram-notifier-mcp","version":"0.1.3","_id":"@harnyk/telegram-notifier-mcp@0.1.3","maintainers":[{"name":"harnyk","email":"markharnyk@gmail.com"}],"bin":{"telegram-notifier":"dist/server.js"},"dist":{"shasum":"2ff51f78e9f947b04c7ca5466a70253dd5530946","tarball":"https://registry.npmjs.org/@harnyk/telegram-notifier-mcp/-/telegram-notifier-mcp-0.1.3.tgz","fileCount":9,"integrity":"sha512-1DgMHGtqrrl0ESFvqrEEBS81kVk2DYodlmxP4n73QOGr/sCgrL9uTH8lKmPH2WrBpqpVsw0oJYCXBsOUZR114A==","signatures":[{"sig":"MEUCIQCT+xiIMyqLJNf8N5l9lsEAR27yxgcA/PylYnzdCiyBwAIgcHonvDOhcGZ7Y6JKeShqD1gi35LpKtM3/gNhLLkqAY0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13301},"main":"dist/server.js","type":"module","title":"Telegram Notifier Server","gitHead":"35c9906f78603bf8f5cf9e1236638571faa0d4b8","scripts":{"dev":"tsx src/server.ts","lint":"eslint src/**/*.ts","build":"tsc","start":"node dist/server.js","watch":"tsc -w","prepare":"npm run build","lint:fix":"eslint src/**/*.ts --fix","typecheck":"tsc --noEmit"},"_npmUser":{"name":"harnyk","email":"markharnyk@gmail.com"},"_npmVersion":"10.9.3","description":"MCP server for sending Telegram messages as a bot","directories":{},"_nodeVersion":"22.18.0","dependencies":{"zod":"3.25.76","axios":"^1.10.0","@modelcontextprotocol/sdk":"^1.17.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.3","eslint":"^9.34.0","@eslint/js":"^9.34.0","typescript":"^5.9.2","@types/node":"^22.7.4","eslint-plugin-n":"^17.21.3","@typescript-eslint/parser":"^8.41.0","@typescript-eslint/eslint-plugin":"^8.41.0"},"_npmOperationalInternal":{"tmp":"tmp/telegram-notifier-mcp_0.1.3_1756581149239_0.9016350891559792","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@harnyk/telegram-notifier-mcp","version":"0.1.4","_id":"@harnyk/telegram-notifier-mcp@0.1.4","maintainers":[{"name":"harnyk","email":"markharnyk@gmail.com"}],"bin":{"telegram-notifier":"dist/server.js"},"dist":{"shasum":"da62fdab434843cb63c186191b185c4a39c252c5","tarball":"https://registry.npmjs.org/@harnyk/telegram-notifier-mcp/-/telegram-notifier-mcp-0.1.4.tgz","fileCount":9,"integrity":"sha512-C9qX4MKdgd/Dnft8zT2T18ob6WpE7DdXwyKKd41hQwUHVaNDI5OAkM0Y6J8qPOSIIwb2uRV6yIsEbAy2JW9KFg==","signatures":[{"sig":"MEQCICSvtNWt2Z3nOLdKMcblreKqAfv9DS/NewakSdmMlQ+qAiADuCd6irS7nOCv7Sw45aQA4rgYV2FLEXlsvUETPvttTQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13915},"main":"dist/server.js","type":"module","title":"Telegram Notifier Server","gitHead":"90f65fa0e71a04e11431fcd517c56d5d002fe457","scripts":{"dev":"tsx src/server.ts","lint":"eslint src/**/*.ts","build":"tsc","start":"node dist/server.js","watch":"tsc -w","prepare":"npm run build","lint:fix":"eslint src/**/*.ts --fix","typecheck":"tsc --noEmit"},"_npmUser":{"name":"harnyk","email":"markharnyk@gmail.com"},"_npmVersion":"10.9.3","description":"MCP server for sending Telegram messages as a bot","directories":{},"_nodeVersion":"22.18.0","dependencies":{"zod":"3.25.76","axios":"^1.10.0","@modelcontextprotocol/sdk":"^1.17.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.3","eslint":"^9.34.0","@eslint/js":"^9.34.0","typescript":"^5.9.2","@types/node":"^22.7.4","eslint-plugin-n":"^17.21.3","@typescript-eslint/parser":"^8.41.0","@typescript-eslint/eslint-plugin":"^8.41.0"},"_npmOperationalInternal":{"tmp":"tmp/telegram-notifier-mcp_0.1.4_1756581751922_0.8487363375033417","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@harnyk/telegram-notifier-mcp","version":"0.1.5","_id":"@harnyk/telegram-notifier-mcp@0.1.5","maintainers":[{"name":"harnyk","email":"markharnyk@gmail.com"}],"bin":{"telegram-notifier":"dist/server.js"},"dist":{"shasum":"9232014f82fa519a359798c4dc860abc217f9a96","tarball":"https://registry.npmjs.org/@harnyk/telegram-notifier-mcp/-/telegram-notifier-mcp-0.1.5.tgz","fileCount":9,"integrity":"sha512-fLhvxulHn8U3VXMmyQCDzG3U9OLxIkbtJ3OqmqMxOmtqC5oAsGbwdRGNQ4mZ9P4cE2ix7Aq6g2n67HQnB+nfKQ==","signatures":[{"sig":"MEQCIDfvA2oj87vDUbiA/iwPI0kn2/1fnJxH5M2RqchA56xiAiAsDEFWBD/YS4D695b4G3HHq9trCvNK4CtCKVQoltt2jw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27324},"main":"dist/server.js","type":"module","title":"Telegram Notifier Server","gitHead":"0381720aa3b9acf04ca1c81642940277bcb6cb0d","scripts":{"dev":"tsx src/server.ts","lint":"eslint src/**/*.ts","build":"tsc","start":"node dist/server.js","watch":"tsc -w","prepare":"npm run build","lint:fix":"eslint src/**/*.ts --fix","typecheck":"tsc --noEmit"},"_npmUser":{"name":"harnyk","email":"markharnyk@gmail.com"},"_npmVersion":"10.9.3","description":"MCP server for sending Telegram messages as a bot","directories":{},"_nodeVersion":"22.18.0","dependencies":{"zod":"3.25.76","axios":"^1.10.0","form-data":"^4.0.4","@modelcontextprotocol/sdk":"^1.17.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.3","eslint":"^9.34.0","@eslint/js":"^9.34.0","typescript":"^5.9.2","@types/node":"^22.7.4","eslint-plugin-n":"^17.21.3","@typescript-eslint/parser":"^8.41.0","@typescript-eslint/eslint-plugin":"^8.41.0"},"_npmOperationalInternal":{"tmp":"tmp/telegram-notifier-mcp_0.1.5_1756582553846_0.7093386513326561","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@harnyk/telegram-notifier-mcp","version":"0.1.6","description":"A Model Context Protocol (MCP) server that enables AI agents to send messages, photos, documents, and videos via Telegram bot","title":"Telegram Notifier MCP Server","type":"module","main":"dist/server.js","bin":{"telegram-notifier":"dist/server.js"},"keywords":["mcp","model-context-protocol","telegram","bot","notifications","ai","claude","llm"],"author":{"name":"Mark Harnyk","email":"markharnyk@gmail.com"},"repository":{"type":"git","url":"git+https://github.com/harnyk/mcp-telegram-notifier.git"},"bugs":{"url":"https://github.com/harnyk/mcp-telegram-notifier/issues"},"homepage":"https://github.com/harnyk/mcp-telegram-notifier#readme","license":"WTFPL","scripts":{"build":"tsc","watch":"tsc -w","dev":"tsx src/server.ts","start":"node dist/server.js","typecheck":"tsc --noEmit","lint":"eslint src/**/*.ts","lint:fix":"eslint src/**/*.ts --fix","prepare":"npm run build"},"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.17.1","axios":"^1.10.0","form-data":"^4.0.4","zod":"3.25.76"},"devDependencies":{"@eslint/js":"^9.34.0","@types/node":"^22.7.4","@typescript-eslint/eslint-plugin":"^8.41.0","@typescript-eslint/parser":"^8.41.0","eslint":"^9.34.0","eslint-plugin-n":"^17.21.3","tsx":"^4.20.3","typescript":"^5.9.2"},"_id":"@harnyk/telegram-notifier-mcp@0.1.6","gitHead":"f7803a37773652167329498481a9d7699f55e2dd","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-Jvf+5h3dIZUIljlqSWIFoA5wLB+hO1v9t0m52lhY91Si7hpWkAGQTY7ljO1be+ExpIolyjP5IJGlOnhGFX82rw==","shasum":"eefbe920fc776e6c8b56be49178761748b452d18","tarball":"https://registry.npmjs.org/@harnyk/telegram-notifier-mcp/-/telegram-notifier-mcp-0.1.6.tgz","fileCount":12,"unpackedSize":41224,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD6GU45CbTJ3tObYNsLISQIycq1qRCYAcCQMPCWdsZNVwIhAK4/KEqTlYtsEoKgNl7poFFukwJFsmAdvKTrmvX8zk6g"}]},"_npmUser":{"name":"harnyk","email":"markharnyk@gmail.com"},"directories":{},"maintainers":[{"name":"harnyk","email":"markharnyk@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/telegram-notifier-mcp_0.1.6_1756584469902_0.07596201050800233"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-30T19:12:29.150Z","modified":"2025-08-30T20:07:50.263Z","0.1.3":"2025-08-30T19:12:29.420Z","0.1.4":"2025-08-30T19:22:32.105Z","0.1.5":"2025-08-30T19:35:54.021Z","0.1.6":"2025-08-30T20:07:50.072Z"},"description":"A Model Context Protocol (MCP) server that enables AI agents to send messages, photos, documents, and videos via Telegram bot","maintainers":[{"name":"harnyk","email":"markharnyk@gmail.com"}],"readme":"# Telegram Notifier MCP Server\n\nA Model Context Protocol (MCP) server that enables AI agents to send messages via Telegram bot. Perfect for notifications, alerts, and real-time communication from your AI applications.\n\n## Features\n\n- 📱 Send messages to Telegram channels/chats via bot\n- 🎨 Support for multiple formatting modes (Markdown, MarkdownV2, HTML)\n- 📷 Send photos/images (local files, HTTP URLs)\n- 📁 Send documents/files with custom filenames\n- 🎬 Send videos with caption support\n- 🏷️ Caption support for all media with full formatting\n- 🛡️ Robust error handling with detailed Telegram API responses\n- 🏗️ Clean service architecture for maintainable code\n\n## Quick Start\n\n### 1. Create a Telegram Bot\n\n1. Message [@BotFather](https://t.me/BotFather) on Telegram\n2. Use `/newbot` command and follow instructions\n3. Save the bot token (looks like `123456789:ABCdefGHIjklMNOpqrsTUVwxyz`)\n\n### 2. Get Chat ID\n\n**For personal messages:**\n1. Message your bot first\n2. Visit: `https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates`\n3. Find the `chat.id` value\n\n**For channels:**\n1. Add your bot to the channel as admin\n2. Send a message to the channel\n3. Visit the same URL and find the `chat.id` (negative number for channels)\n\n### 3. Install and Configure\n\n```bash\n# Install the package\nnpm install -g @harnyk/telegram-notifier-mcp\n\n# Or clone and build locally\ngit clone <repository-url>\ncd mcp-telegram-notifier\npnpm install\npnpm build\npnpm link\n```\n\n### 4. Add to Your MCP Client\n\nAdd to your MCP client configuration (e.g., Claude Desktop):\n\n```json\n{\n  \"mcpServers\": {\n    \"telegram-notifier\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mcp-telegram-notifier/dist/server.js\"],\n      \"env\": {\n        \"TELEGRAM_BOT_TOKEN\": \"your_bot_token_here\",\n        \"TELEGRAM_CHAT_ID\": \"your_chat_id_here\"\n      }\n    }\n  }\n}\n```\n\n**Or using npx:**\n\n```json\n{\n  \"mcpServers\": {\n    \"telegram-notifier\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@harnyk/telegram-notifier-mcp\"],\n      \"env\": {\n        \"TELEGRAM_BOT_TOKEN\": \"your_bot_token_here\", \n        \"TELEGRAM_CHAT_ID\": \"your_chat_id_here\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\nOnce configured, your AI agent will have access to these MCP tools:\n\n### 📝 `send_markdown_message_as_telegram_bot`\nSend formatted text messages to Telegram\n- **messageText**: Text content with Markdown/HTML formatting\n- **parseMode**: `Markdown`, `MarkdownV2`, or `HTML` (default: MarkdownV2)\n\n### 📷 `send_telegram_photo` \nSend photos/images to Telegram\n- **photo**: Local file path or HTTP URL to image\n- **caption**: Optional image caption with formatting\n- **parseMode**: Caption formatting mode\n\n### 📁 `send_telegram_document`\nSend documents/files to Telegram  \n- **document**: Local file path or HTTP URL to document\n- **caption**: Optional document caption with formatting\n- **filename**: Custom filename override\n- **parseMode**: Caption formatting mode\n\n### 🎬 `send_telegram_video`\nSend videos to Telegram\n- **video**: Local file path or HTTP URL to video\n- **caption**: Optional video caption with formatting\n- **filename**: Custom filename override\n- **parseMode**: Caption formatting mode\n\n### Use Cases\n\n- 📊 **Monitoring**: Get alerts when system metrics exceed thresholds\n- 🚀 **Deployments**: Notifications when CI/CD pipelines complete\n- 📈 **Analytics**: Daily/weekly reports with charts and data files\n- 🔍 **Error Tracking**: Instant notifications with error screenshots  \n- 📅 **Scheduling**: Reminders with attached documents\n- 💬 **Customer Support**: Forward important messages with media\n\n## Development\n\n```bash\n# Install dependencies\npnpm install\n\n# Run in development mode\npnpm dev\n\n# Build for production\npnpm build\n\n# Run linting\npnpm lint\n\n# Run type checking  \npnpm typecheck\n```\n\n## Configuration Examples\n\n### Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"telegram-notifier\": {\n      \"command\": \"node\",\n      \"args\": [\"path/to/dist/server.js\"],\n      \"env\": {\n        \"TELEGRAM_BOT_TOKEN\": \"123456789:ABCdefGHIjklMNOpqrsTUVwxyz\",\n        \"TELEGRAM_CHAT_ID\": \"-1001234567890\"\n      }\n    }\n  }\n}\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if needed\n5. Run `pnpm lint` and `pnpm typecheck`\n6. Submit a pull request\n\n## License\n\nWTFPL - Do What the Fuck You Want to Public License\n","readmeFilename":"README.md","homepage":"https://github.com/harnyk/mcp-telegram-notifier#readme","keywords":["mcp","model-context-protocol","telegram","bot","notifications","ai","claude","llm"],"repository":{"type":"git","url":"git+https://github.com/harnyk/mcp-telegram-notifier.git"},"author":{"name":"Mark Harnyk","email":"markharnyk@gmail.com"},"bugs":{"url":"https://github.com/harnyk/mcp-telegram-notifier/issues"},"license":"WTFPL"}