{"_id":"mcp-communicator-telegram","_rev":"10-f3d5dda2e88f153ab5e3e8785cce8518","name":"mcp-communicator-telegram","dist-tags":{"latest":"0.2.1"},"versions":{"0.1.0":{"name":"mcp-communicator-telegram","version":"0.1.0","keywords":["mcp","model-context-protocol","telegram","bot","communication","chat","messaging","ai","claude"],"author":{"name":"qpd-v"},"license":"ISC","_id":"mcp-communicator-telegram@0.1.0","maintainers":[{"name":"qpd-v","email":"kwhelan711@gmail.com"}],"homepage":"https://github.com/qpd-v/mcp-communicator-telegram#readme","bugs":{"url":"https://github.com/qpd-v/mcp-communicator-telegram/issues"},"bin":{"mcptelegram":"build/index.js","mcptelegram-chatid":"build/get-chat-id.js"},"dist":{"shasum":"b0a5afb4c50610f334553ae87ccfe51ce9cfbc5e","tarball":"https://registry.npmjs.org/mcp-communicator-telegram/-/mcp-communicator-telegram-0.1.0.tgz","fileCount":5,"integrity":"sha512-7R7lrqm/uWlXa9Uk0AK4T7msYR5fh4CFqB5RS5sUytuzHK/Kns6Oij1varLaKVeRf1+58qthbIsIaCfbUYangQ==","signatures":[{"sig":"MEYCIQCWDLn3wuNto1xuXVbUDFfQRA9htGBQOguxYQem1GUgMwIhAMfPSWmRRVEEsB31VZ1hroXjrUkQliJfihVjp7xEWJ+F","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":17834},"main":"build/index.js","type":"commonjs","gitHead":"98200848a8e0883a09003060e63a8ce48be9e3d6","scripts":{"dev":"tsc && node build/index.js","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","clean":"rimraf build","start":"node build/index.js","watch":"tsc -w"},"_npmUser":{"name":"qpd-v","email":"kwhelan711@gmail.com"},"repository":{"url":"git+https://github.com/qpd-v/mcp-communicator-telegram.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for communicating with users through Telegram bots","directories":{},"_nodeVersion":"20.18.1","dependencies":{"dotenv":"^16.3.1","node-telegram-bot-api":"^0.64.0"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","typescript":"^5.3.3","@types/node":"^20.10.5","@types/node-telegram-bot-api":"^0.64.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-communicator-telegram_0.1.0_1734480101986_0.637247335937364","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"mcp-communicator-telegram","version":"0.1.2","keywords":["mcp","model-context-protocol","telegram","bot","communication","chat","messaging","ai","claude"],"author":{"name":"qpd-v"},"license":"ISC","_id":"mcp-communicator-telegram@0.1.2","maintainers":[{"name":"qpd-v","email":"kwhelan711@gmail.com"}],"homepage":"https://github.com/qpd-v/mcp-communicator-telegram#readme","bugs":{"url":"https://github.com/qpd-v/mcp-communicator-telegram/issues"},"bin":{"mcptelegram":"build/index.js","mcptelegram-chatid":"build/get-chat-id.js"},"dist":{"shasum":"fbe55d9757e9d92fb47333c7e7139052f4a48c89","tarball":"https://registry.npmjs.org/mcp-communicator-telegram/-/mcp-communicator-telegram-0.1.2.tgz","fileCount":5,"integrity":"sha512-DfyL+kfxSqZjbA6huosSf86HjaYC5xsqzVd0FfTCv39PKIacoogWF8TRNdzwMFM2NgQXwsI2wNHwHCJGfpeSEA==","signatures":[{"sig":"MEQCIGp23TDveO0bAhEyKs8U5+0NSlY8VIQPFu28Jjybr8lLAiA3fpXnqYev6s88AXr7zRlcNuTeg1Rc7SOQMuC3lfIV4Q==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":17868},"main":"build/index.js","type":"commonjs","gitHead":"9653b11938035660d2c5652468ac2f68230ea6c0","scripts":{"dev":"tsc && node build/index.js","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","clean":"rimraf build","start":"node build/index.js","watch":"tsc -w"},"_npmUser":{"name":"qpd-v","email":"kwhelan711@gmail.com"},"repository":{"url":"git+https://github.com/qpd-v/mcp-communicator-telegram.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for communicating with users through Telegram bots","directories":{},"_nodeVersion":"20.18.1","dependencies":{"dotenv":"^16.3.1","node-telegram-bot-api":"^0.64.0"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","typescript":"^5.3.3","@types/node":"^20.10.5","@types/node-telegram-bot-api":"^0.64.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-communicator-telegram_0.1.2_1734488293306_0.5473717722941287","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"mcp-communicator-telegram","version":"0.1.3","keywords":["mcp","model-context-protocol","telegram","bot","communication","chat","messaging","ai","claude"],"author":{"name":"qpd-v"},"license":"ISC","_id":"mcp-communicator-telegram@0.1.3","maintainers":[{"name":"qpd-v","email":"kwhelan711@gmail.com"}],"homepage":"https://github.com/qpd-v/mcp-communicator-telegram#readme","bugs":{"url":"https://github.com/qpd-v/mcp-communicator-telegram/issues"},"bin":{"mcptelegram":"build/index.js","mcptelegram-chatid":"build/get-chat-id.js"},"dist":{"shasum":"e9325b3019b3d90a411075b0cac68a66fc07257b","tarball":"https://registry.npmjs.org/mcp-communicator-telegram/-/mcp-communicator-telegram-0.1.3.tgz","fileCount":5,"integrity":"sha512-NQm109wavGW38zYwZQlm6cCOpXGFsuRlGKxRnW1G9JgmmkK8gkMZvbGh16HYo26GcSIAaPfgAUxHzzFVN5AbMw==","signatures":[{"sig":"MEUCIQDUUPL1i0PZa4A+9UrsgYUYFWbUM++8b523CLMRiedB9AIgax6t5o1e+xMqF1kC+vlVlUXkZd74au+ZRjvfTGULeA0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21964},"main":"build/index.js","type":"commonjs","gitHead":"f50e0e33f61c3ff0be7fa87e867d9142832cad4f","scripts":{"dev":"tsc && node build/index.js","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","clean":"rimraf build","start":"node build/index.js","watch":"tsc -w"},"_npmUser":{"name":"qpd-v","email":"kwhelan711@gmail.com"},"repository":{"url":"git+https://github.com/qpd-v/mcp-communicator-telegram.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for communicating with users through Telegram bots","directories":{},"_nodeVersion":"20.18.1","dependencies":{"dotenv":"^16.3.1","node-telegram-bot-api":"^0.64.0"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","typescript":"^5.3.3","@types/node":"^20.10.5","@types/node-telegram-bot-api":"^0.64.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-communicator-telegram_0.1.3_1737675518225_0.03566664830723987","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"mcp-communicator-telegram","version":"0.1.4","keywords":["mcp","model-context-protocol","telegram","bot","communication","chat","messaging","ai","claude"],"author":{"name":"qpd-v"},"license":"ISC","_id":"mcp-communicator-telegram@0.1.4","maintainers":[{"name":"qpd-v","email":"kwhelan711@gmail.com"}],"homepage":"https://github.com/qpd-v/mcp-communicator-telegram#readme","bugs":{"url":"https://github.com/qpd-v/mcp-communicator-telegram/issues"},"bin":{"mcptelegram":"build/index.js","mcptelegram-chatid":"build/get-chat-id.js"},"dist":{"shasum":"79402926e3d526d0c95736f46f719e29461a4c77","tarball":"https://registry.npmjs.org/mcp-communicator-telegram/-/mcp-communicator-telegram-0.1.4.tgz","fileCount":5,"integrity":"sha512-a1AjkO8xfdkId8N7R/jVgpTyOSeNy2YZBx6pYFlM+RBQCMEF/i14LKAGz8A3Q8ObnAmA5Bom3YByv1+poy1ejQ==","signatures":[{"sig":"MEQCIB6Ujpi5a/ZK5ref11f9zXLmb03HoLO96f2jm4seilIEAiBEfUO39AWrxwBw53oWnKXbH0vZbrTJTitdyUsjeS6KRQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27334},"main":"build/index.js","type":"commonjs","gitHead":"f9735d08742b38cb297103c8ad46091731ac2d21","scripts":{"dev":"tsc && node build/index.js","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","clean":"rimraf build","start":"node build/index.js","watch":"tsc -w"},"_npmUser":{"name":"qpd-v","email":"kwhelan711@gmail.com"},"repository":{"url":"git+https://github.com/qpd-v/mcp-communicator-telegram.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for communicating with users through Telegram bots","directories":{},"_nodeVersion":"20.18.1","dependencies":{"dotenv":"^16.3.1","ignore":"^7.0.3","archiver":"^7.0.1","node-telegram-bot-api":"^0.64.0"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","typescript":"^5.3.3","@types/node":"^20.10.5","@types/archiver":"^6.0.3","@types/node-telegram-bot-api":"^0.64.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-communicator-telegram_0.1.4_1737679866676_0.320847059354878","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"mcp-communicator-telegram","version":"0.1.5","keywords":["mcp","model-context-protocol","telegram","bot","communication","chat","messaging","ai","claude"],"author":{"name":"qpd-v"},"license":"ISC","_id":"mcp-communicator-telegram@0.1.5","maintainers":[{"name":"qpd-v","email":"kwhelan711@gmail.com"}],"homepage":"https://github.com/qpd-v/mcp-communicator-telegram#readme","bugs":{"url":"https://github.com/qpd-v/mcp-communicator-telegram/issues"},"bin":{"mcptelegram":"build/index.js","mcptelegram-chatid":"build/get-chat-id.js"},"dist":{"shasum":"ef0223a58951cd40ec9e7a16c1e00ee93f302924","tarball":"https://registry.npmjs.org/mcp-communicator-telegram/-/mcp-communicator-telegram-0.1.5.tgz","fileCount":5,"integrity":"sha512-WtS5Tnb6pVUpaWYWQ7WsyxNr08vB13k93z9i2ZHwHdrSMBowSE2Rlxz5F4OMONaT0a2rU5JgeGUUh2K8N/7YFg==","signatures":[{"sig":"MEUCID78m7+rOr/JTdoFrP9FyQaZiH3zpOzOtgbSgDYDmPskAiEA12+u0seiv56APrHeW3FN4BXatFRZTcccmESMGkhkvFI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27410},"main":"build/index.js","type":"commonjs","gitHead":"5dcf573c5c39923d9627f660825b53aa657372de","scripts":{"dev":"tsc && node build/index.js","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","clean":"rimraf build","start":"node build/index.js","watch":"tsc -w"},"_npmUser":{"name":"qpd-v","email":"kwhelan711@gmail.com"},"repository":{"url":"git+https://github.com/qpd-v/mcp-communicator-telegram.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for communicating with users through Telegram bots","directories":{},"_nodeVersion":"20.18.1","dependencies":{"dotenv":"^16.3.1","ignore":"^7.0.3","archiver":"^7.0.1","node-telegram-bot-api":"^0.64.0"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","typescript":"^5.3.3","@types/node":"^20.10.5","@types/archiver":"^6.0.3","@types/node-telegram-bot-api":"^0.64.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-communicator-telegram_0.1.5_1737680478048_0.9032507482865766","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"mcp-communicator-telegram","version":"0.2.0","keywords":["mcp","model-context-protocol","telegram","bot","communication","chat","messaging","ai","claude"],"author":{"name":"qpd-v"},"license":"ISC","_id":"mcp-communicator-telegram@0.2.0","maintainers":[{"name":"qpd-v","email":"kwhelan711@gmail.com"}],"homepage":"https://github.com/qpd-v/mcp-communicator-telegram#readme","bugs":{"url":"https://github.com/qpd-v/mcp-communicator-telegram/issues"},"bin":{"mcptelegram":"build/index.js","mcptelegram-chatid":"build/get-chat-id.js"},"dist":{"shasum":"c904e6cd28538985b7e2c8a528228da3c1afe6af","tarball":"https://registry.npmjs.org/mcp-communicator-telegram/-/mcp-communicator-telegram-0.2.0.tgz","fileCount":5,"integrity":"sha512-qwZljXJu32LIdIFzIl8r7pfMu4KBfVgTVBGYVgRICvxiHj0rpPsn9sOZzxoSVVdXgxtEJYhvJqYDJADLWVy5vA==","signatures":[{"sig":"MEUCIQCpDRR8ZuiqH/FyQhWpJiQFXAxPB++2vrK7awyBGL54DwIgWENJMP/xeEF5GPeGGQrevkJqtCSubzuPrnKwrT07J40=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29326},"main":"build/index.js","type":"commonjs","gitHead":"4e369186bdbd75b41eaa9d33a307b2d866e646b9","scripts":{"dev":"tsc && node build/index.js","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","clean":"rimraf build","start":"node build/index.js","watch":"tsc -w"},"_npmUser":{"name":"qpd-v","email":"kwhelan711@gmail.com"},"repository":{"url":"git+https://github.com/qpd-v/mcp-communicator-telegram.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for communicating with users through Telegram bots","directories":{},"_nodeVersion":"20.18.1","dependencies":{"dotenv":"^16.3.1","ignore":"^7.0.3","archiver":"^7.0.1","node-telegram-bot-api":"^0.64.0"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","typescript":"^5.3.3","@types/node":"^20.10.5","@types/archiver":"^6.0.3","@types/node-telegram-bot-api":"^0.64.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-communicator-telegram_0.2.0_1737681186012_0.5027382442298542","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"mcp-communicator-telegram","version":"0.2.1","keywords":["mcp","model-context-protocol","telegram","bot","communication","chat","messaging","ai","claude"],"author":{"name":"qpd-v"},"license":"ISC","_id":"mcp-communicator-telegram@0.2.1","maintainers":[{"name":"qpd-v","email":"kwhelan711@gmail.com"}],"homepage":"https://github.com/qpd-v/mcp-communicator-telegram#readme","bugs":{"url":"https://github.com/qpd-v/mcp-communicator-telegram/issues"},"bin":{"mcptelegram":"build/index.js","mcptelegram-chatid":"build/get-chat-id.js"},"dist":{"shasum":"798151caa95f5be4fef1bc635653b4012e38fe1d","tarball":"https://registry.npmjs.org/mcp-communicator-telegram/-/mcp-communicator-telegram-0.2.1.tgz","fileCount":5,"integrity":"sha512-T484XytX6IOW9p1hwq1y2jTlRcLT4xwJBiUizytdOQPIfwXM1xLMOz6sIWeqRX5ZId2BJxySAQ8amZutd2gWUA==","signatures":[{"sig":"MEUCIF5zaG/bUy1KiL14fHMUaTesqQ/4ZnLAuiY3p4YRJibXAiEAx86243/Dj/RFxwjjhRn81l6uOiZKIoYBOfubpid2kyA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30577},"main":"build/index.js","type":"commonjs","gitHead":"0c90dc657ed20fc314bf1d538fae6599da2192b0","scripts":{"dev":"tsc && node build/index.js","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","clean":"rimraf build","start":"node build/index.js","watch":"tsc -w"},"_npmUser":{"name":"qpd-v","email":"kwhelan711@gmail.com"},"repository":{"url":"git+https://github.com/qpd-v/mcp-communicator-telegram.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for communicating with users through Telegram bots","directories":{},"_nodeVersion":"20.18.1","dependencies":{"dotenv":"^16.3.1","ignore":"^7.0.3","archiver":"^7.0.1","node-telegram-bot-api":"^0.64.0"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","typescript":"^5.3.3","@types/node":"^20.10.5","@types/archiver":"^6.0.3","@types/node-telegram-bot-api":"^0.64.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-communicator-telegram_0.2.1_1737682440163_0.2645750379189358","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2024-12-18T00:01:41.985Z","modified":"2026-03-18T23:15:30.734Z","0.1.0":"2024-12-18T00:01:42.194Z","0.1.1":"2024-12-18T00:07:36.572Z","0.1.2":"2024-12-18T02:18:13.479Z","0.1.3":"2025-01-23T23:38:38.427Z","0.1.4":"2025-01-24T00:51:06.863Z","0.1.5":"2025-01-24T01:01:18.272Z","0.2.0":"2025-01-24T01:13:06.201Z","0.2.1":"2025-01-24T01:34:00.358Z"},"bugs":{"url":"https://github.com/qpd-v/mcp-communicator-telegram/issues"},"author":{"name":"qpd-v"},"license":"ISC","homepage":"https://github.com/qpd-v/mcp-communicator-telegram#readme","keywords":["mcp","model-context-protocol","telegram","bot","communication","chat","messaging","ai","claude"],"repository":{"url":"git+https://github.com/qpd-v/mcp-communicator-telegram.git","type":"git"},"description":"MCP server for communicating with users through Telegram bots","maintainers":[{"email":"kwhelan711@gmail.com","name":"qpdv"}],"readme":"# MCP Communicator (Telegram)\r\n\r\nAn MCP server that enables communication with users through Telegram. This server provides tools to interact with users via a Telegram bot, including asking questions, sending notifications, sharing files, and creating project archives.\r\n\r\n## Installation\r\n\r\n### Via npm (global)\r\n\r\n```bash\r\nnpm install -g mcp-communicator-telegram\r\n```\r\n\r\n### Via npx (on-demand)\r\n\r\n```bash\r\nnpx mcptelegram\r\n```\r\n\r\nTo get your Telegram chat ID:\r\n```bash\r\nnpx mcptelegram-chatid\r\n```\r\n\r\n## Features\r\n\r\n- Ask questions to users through Telegram\r\n- Send notifications to users (no response required)\r\n- Send files to users via Telegram\r\n- Create and send project zip files (respecting .gitignore)\r\n- Receive responses asynchronously (waits indefinitely for response)\r\n- Support for reply-based message tracking\r\n- Secure chat ID validation\r\n- Error handling and logging\r\n\r\n## Prerequisites\r\n\r\n- Node.js (v14 or higher)\r\n- A Telegram bot token (obtained from [@BotFather](https://t.me/botfather))\r\n- Your Telegram chat ID (can be obtained using the included utility)\r\n\r\n## Installation\r\n\r\n1. Clone the repository:\r\n```bash\r\ngit clone https://github.com/qpd-v/mcp-communicator-telegram.git\r\ncd mcp-communicator-telegram\r\n```\r\n\r\n2. Install dependencies:\r\n```bash\r\nnpm install\r\n```\r\n\r\n3. Create a Telegram bot:\r\n   - Open Telegram and search for [@BotFather](https://t.me/botfather)\r\n   - Send `/newbot` and follow the instructions\r\n   - Save the bot token you receive\r\n\r\n4. Get your chat ID:\r\n   - Copy `.env.example` to `.env`\r\n   - Add your bot token to the `.env` file:\r\n     ```\r\n     TELEGRAM_TOKEN=your_bot_token_here\r\n     ```\r\n   - Run the chat ID utility:\r\n     ```bash\r\n     npm run build\r\n     node build/get-chat-id.js\r\n     ```\r\n   - Send any message to your bot\r\n   - Copy the chat ID that appears in the console\r\n   - Add the chat ID to your `.env` file:\r\n     ```\r\n     TELEGRAM_TOKEN=your_bot_token_here\r\n     CHAT_ID=your_chat_id_here\r\n     ```\r\n\r\n## Configuration\r\n\r\nAdd the server to your MCP settings file (usually located at `%APPDATA%\\Code\\User\\globalStorage\\rooveterinaryinc.roo-cline\\settings\\cline_mcp_settings.json` on Windows):\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"mcp-communicator-telegram\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"path/to/mcp-communicator-telegram/build/index.js\"],\r\n      \"env\": {\r\n        \"TELEGRAM_TOKEN\": \"your_bot_token_here\",\r\n        \"CHAT_ID\": \"your_chat_id_here\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## Available Tools\r\n\r\n### ask_user\r\n\r\nAsks a question to the user via Telegram and waits for their response.\r\n\r\nInput Schema:\r\n```json\r\n{\r\n  \"type\": \"object\",\r\n  \"properties\": {\r\n    \"question\": {\r\n      \"type\": \"string\",\r\n      \"description\": \"The question to ask the user\"\r\n    }\r\n  },\r\n  \"required\": [\"question\"]\r\n}\r\n```\r\n\r\nExample usage:\r\n```typescript\r\nconst response = await use_mcp_tool({\r\n  server_name: \"mcp-communicator-telegram\",\r\n  tool_name: \"ask_user\",\r\n  arguments: {\r\n    question: \"What is your favorite color?\"\r\n  }\r\n});\r\n```\r\n\r\n### notify_user\r\n\r\nSends a notification message to the user via Telegram (no response required).\r\n\r\nInput Schema:\r\n```json\r\n{\r\n  \"type\": \"object\",\r\n  \"properties\": {\r\n    \"message\": {\r\n      \"type\": \"string\",\r\n      \"description\": \"The message to send to the user\"\r\n    }\r\n  },\r\n  \"required\": [\"message\"]\r\n}\r\n```\r\n\r\nExample usage:\r\n```typescript\r\nawait use_mcp_tool({\r\n  server_name: \"mcp-communicator-telegram\",\r\n  tool_name: \"notify_user\",\r\n  arguments: {\r\n    message: \"Task completed successfully!\"\r\n  }\r\n});\r\n```\r\n\r\n### send_file\r\n\r\nSends a file to the user via Telegram.\r\n\r\nInput Schema:\r\n```json\r\n{\r\n  \"type\": \"object\",\r\n  \"properties\": {\r\n    \"filePath\": {\r\n      \"type\": \"string\",\r\n      \"description\": \"The path to the file to send\"\r\n    }\r\n  },\r\n  \"required\": [\"filePath\"]\r\n}\r\n```\r\n\r\nExample usage:\r\n```typescript\r\nawait use_mcp_tool({\r\n  server_name: \"mcp-communicator-telegram\",\r\n  tool_name: \"send_file\",\r\n  arguments: {\r\n    filePath: \"path/to/file.txt\"\r\n  }\r\n});\r\n```\r\n\r\n### zip_project\r\n\r\nCreates a zip file of a project directory (respecting .gitignore patterns) and sends it to the user via Telegram.\r\n\r\nInput Schema:\r\n```json\r\n{\r\n  \"type\": \"object\",\r\n  \"properties\": {\r\n    \"directory\": {\r\n      \"type\": \"string\",\r\n      \"description\": \"Directory to zip (defaults to current working directory)\"\r\n    }\r\n  },\r\n  \"required\": []\r\n}\r\n```\r\n\r\nExample usage with default directory (current working directory):\r\n```typescript\r\nawait use_mcp_tool({\r\n  server_name: \"mcp-communicator-telegram\",\r\n  tool_name: \"zip_project\",\r\n  arguments: {}\r\n});\r\n```\r\n\r\nExample usage with specific directory:\r\n```typescript\r\nawait use_mcp_tool({\r\n  server_name: \"mcp-communicator-telegram\",\r\n  tool_name: \"zip_project\",\r\n  arguments: {\r\n    directory: \"/path/to/your/project\"\r\n  }\r\n});\r\n```\r\n\r\nFeatures:\r\n- Creates a zip file named `[project-name]-project.zip` based on the directory name\r\n- Can zip any specified directory or the current working directory\r\n- Respects .gitignore patterns\r\n- Maintains correct file paths in the archive\r\n- Automatically cleans up the zip file after sending\r\n- Handles files up to 2GB in size\r\n\r\n## Development\r\n\r\nBuild the project:\r\n```bash\r\nnpm run build\r\n```\r\n\r\nRun in development mode:\r\n```bash\r\nnpm run dev\r\n```\r\n\r\nWatch for changes:\r\n```bash\r\nnpm run watch\r\n```\r\n\r\nClean build directory:\r\n```bash\r\nnpm run clean\r\n```\r\n\r\n## Security\r\n\r\n- The server only responds to messages from the configured chat ID\r\n- Environment variables are used for sensitive configuration\r\n- Message IDs are used to track question/answer pairs\r\n- The bot ignores messages without proper context\r\n\r\n## License\r\n\r\nISC\r\n\r\n## Author\r\n\r\nqpd-v\r\n\r\n## Version\r\n\r\n0.2.1  # Major version bump for new features: notify_user, send_file, and zip_project tools","readmeFilename":"README.md"}