{"_id":"@agentbell/mcp-server","_rev":"4-25f1ce2f79973d6a58964185681f150d","name":"@agentbell/mcp-server","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@agentbell/mcp-server","version":"1.0.0","keywords":["mcp","agentbell","model-context-protocol","cursor","ai-coding"],"license":"MIT","_id":"@agentbell/mcp-server@1.0.0","maintainers":[{"name":"jiaobaba","email":"hljwwyy123@gmail.com"}],"homepage":"https://github.com/AidenWong/agentbell#readme","bugs":{"url":"https://github.com/AidenWong/agentbell/issues"},"bin":{"agentbell-mcp-server":"index.js"},"dist":{"shasum":"e79a064ab11b782bbc0a3a9b056c6feff8f27287","tarball":"https://registry.npmjs.org/@agentbell/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":2,"integrity":"sha512-UXennoocUWq/pzbnedpcKtzTJfoeB+1AEkkT8K3jaWiBfuI+ivsl9k0Lx+V/jKU8t8KtfkD+hpMrLU6Bj0+y2g==","signatures":[{"sig":"MEUCIHNzqxIVHg6u2Aypd7ObmMJhSKiZCRdGoCak3MGj8dt1AiEA40uaKdmO4+/rWWp3rNveTHaCANlm5qDmrzkzRy3i1Lw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6906},"main":"index.js","type":"module","gitHead":"8e399cd557ce9ea8255691c179a0d98d6e1cd347","scripts":{"build":"esbuild index.js --bundle --platform=node --format=esm --outfile=dist/mcp-server.mjs","start":"node index.js"},"_npmUser":{"name":"jiaobaba","email":"hljwwyy123@gmail.com"},"repository":{"url":"git+https://github.com/AidenWong/agentbell.git","type":"git"},"_npmVersion":"8.1.0","description":"AgentBell MCP Server — notifies AgentBell.app of AI agent state changes","directories":{},"_nodeVersion":"22.12.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1773063910574_0.5637447777393672","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@agentbell/mcp-server","version":"1.0.1","keywords":["mcp","agentbell","model-context-protocol","cursor","ai-coding"],"license":"MIT","_id":"@agentbell/mcp-server@1.0.1","maintainers":[{"name":"jiaobaba","email":"hljwwyy123@gmail.com"}],"homepage":"https://github.com/AidenWong/agentbell#readme","bugs":{"url":"https://github.com/AidenWong/agentbell/issues"},"bin":{"agentbell-mcp-server":"index.js"},"dist":{"shasum":"7e2fe9ab475b7f1a81d60029065a87b7c608a58d","tarball":"https://registry.npmjs.org/@agentbell/mcp-server/-/mcp-server-1.0.1.tgz","fileCount":3,"integrity":"sha512-psfoJSWTb6OHfwmT3OyV+7vOjEvDQMZwu07Xa7I5h9V/N/FgVyz9nwlIMiqALp1nqn5gRaIK09RuOBNTUyXi7w==","signatures":[{"sig":"MEUCIQCjPTcpGLw4H10FE3xjWHjSCZm4znsID/0w3TP4lqE5fQIgHDQCH7CsXlLtF/yVw8oyPv2cZTp2eldBdn2BIOL5niY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8986},"main":"index.js","type":"module","gitHead":"8e399cd557ce9ea8255691c179a0d98d6e1cd347","scripts":{"build":"esbuild index.js --bundle --platform=node --format=esm --outfile=dist/mcp-server.mjs","start":"node index.js"},"_npmUser":{"name":"jiaobaba","email":"hljwwyy123@gmail.com"},"repository":{"url":"git+https://github.com/AidenWong/agentbell.git","type":"git"},"_npmVersion":"8.1.0","description":"AgentBell MCP Server — notifies AgentBell.app of AI agent state changes","directories":{},"_nodeVersion":"22.12.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.1_1773065455375_0.0257248515616626","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@agentbell/mcp-server","version":"1.0.2","keywords":["mcp","agentbell","model-context-protocol","cursor","ai-coding"],"license":"MIT","_id":"@agentbell/mcp-server@1.0.2","maintainers":[{"name":"jiaobaba","email":"hljwwyy123@gmail.com"}],"homepage":"https://github.com/AidenWong/agentbell#readme","bugs":{"url":"https://github.com/AidenWong/agentbell/issues"},"bin":{"agentbell-mcp-server":"index.js"},"dist":{"shasum":"d44ce4d17519f2c5a31e5b351acd04d17dd26c1d","tarball":"https://registry.npmjs.org/@agentbell/mcp-server/-/mcp-server-1.0.2.tgz","fileCount":3,"integrity":"sha512-gK6cWEI1TB8z+5gv086rQ3JtboxMNHodgEFQxAzD1eRrqgcca07LBxo6G00H8iFCVAmLWiiHpzGZdCTHPA69yg==","signatures":[{"sig":"MEQCIB5ygwW3Nm7VpxNKYXLHt2SU4zwGTrQ6haKyjMrD1vfAAiAnOSJEiPHgxX29HY5Wm9Lbvidl/bucshzXoy7/pA+8Zg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10370},"main":"index.js","type":"module","gitHead":"e78ba659b7e081a74f1acaf294d8405e8630234c","scripts":{"build":"esbuild index.js --bundle --platform=node --format=esm --outfile=dist/mcp-server.mjs","start":"node index.js"},"_npmUser":{"name":"jiaobaba","email":"hljwwyy123@gmail.com"},"repository":{"url":"git+https://github.com/AidenWong/agentbell.git","type":"git"},"_npmVersion":"11.11.0","description":"AgentBell MCP Server — notifies AgentBell.app of AI agent state changes","directories":{},"_nodeVersion":"25.8.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.25.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.2_1776616017779_0.08074125483770578","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@agentbell/mcp-server","version":"1.0.3","description":"AgentBell MCP Server — notifies AgentBell.app of AI agent state changes","main":"index.js","type":"module","bin":{"agentbell-mcp-server":"index.js"},"scripts":{"start":"node index.js","build":"esbuild index.js --bundle --platform=node --format=esm --outfile=dist/mcp-server.mjs"},"keywords":["mcp","agentbell","model-context-protocol","cursor","ai-coding"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/AidenWong/agentbell.git"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0"},"devDependencies":{"esbuild":"^0.25.3"},"gitHead":"e78ba659b7e081a74f1acaf294d8405e8630234c","_id":"@agentbell/mcp-server@1.0.3","bugs":{"url":"https://github.com/AidenWong/agentbell/issues"},"homepage":"https://github.com/AidenWong/agentbell#readme","_nodeVersion":"25.8.0","_npmVersion":"11.11.0","dist":{"integrity":"sha512-Z27Ht3flW9R2CsgnSoAyx0s0VircTHk4AzI07Rh+JJJbJU8CPAc7aLa18NCKFF8DFapx8t+ws9KJdf9Y+LrGDQ==","shasum":"a7ce98bee14296d14f7ee92836bda6381375ca64","tarball":"https://registry.npmjs.org/@agentbell/mcp-server/-/mcp-server-1.0.3.tgz","fileCount":3,"unpackedSize":9220,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCIV+kuX9S31SEzzy8V26usjDwn+07uvJZHkSeZf8XTrwIhAINgPjWJw6P89oreg1JgKDpyGexTq70NAq+wI0FGhAFT"}]},"_npmUser":{"name":"jiaobaba","email":"hljwwyy123@gmail.com"},"directories":{},"maintainers":[{"name":"jiaobaba","email":"hljwwyy123@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.3_1776616105015_0.0478466506952131"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-09T13:45:10.427Z","modified":"2026-04-19T16:28:25.269Z","1.0.0":"2026-03-09T13:45:10.706Z","1.0.1":"2026-03-09T14:10:55.521Z","1.0.2":"2026-04-19T16:26:57.906Z","1.0.3":"2026-04-19T16:28:25.163Z"},"bugs":{"url":"https://github.com/AidenWong/agentbell/issues"},"license":"MIT","homepage":"https://github.com/AidenWong/agentbell#readme","keywords":["mcp","agentbell","model-context-protocol","cursor","ai-coding"],"repository":{"type":"git","url":"git+https://github.com/AidenWong/agentbell.git"},"description":"AgentBell MCP Server — notifies AgentBell.app of AI agent state changes","maintainers":[{"name":"jiaobaba","email":"hljwwyy123@gmail.com"}],"readme":"# @agentbell/mcp-server\n\nMCP (Model Context Protocol) server for [AgentBell](https://agentbell.dev) — a macOS menubar companion that watches your AI coding sessions and responds with emotional feedback (bubble text + voice).\n\nThis server acts as the bridge between your IDE's AI agent and the AgentBell desktop app. When the AI starts or finishes a task, this server notifies AgentBell so it can react in real time.\n\n## Quick Setup\n\nAdd to your IDE's MCP configuration:\n\n**Cursor** (`~/.cursor/mcp.json`):\n```json\n{\n  \"mcpServers\": {\n    \"agentbell\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentbell/mcp-server@latest\"]\n    }\n  }\n}\n```\n\n**VSCode** (`~/.vscode/mcp.json`):\n```json\n{\n  \"servers\": {\n    \"agentbell\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentbell/mcp-server@latest\"]\n    }\n  }\n}\n```\n\nOr run directly:\n```bash\nnpx @agentbell/mcp-server\n```\n\n## Tools\n\n### `agentbell_notify`\n\nNotify AgentBell of an AI agent state change.\n\n| Parameter | Required | Values | Description |\n|-----------|----------|--------|-------------|\n| `state` | Yes | `running`, `waiting`, `done`, `error` | Current task state |\n| `project` | No | any string | Project name for context |\n\n### `agentbell_status`\n\nQuery the current AgentBell app status. No parameters needed.\n\n## How It Works\n\n```\nIDE AI Agent → MCP tool call → agentbell_notify(state=\"done\")\n                                      ↓\n                              writes to agentbell-events.jsonl\n                                      ↓\n                              AgentBell.app picks up event\n                                      ↓\n                              Live2D bubble + voice feedback 🎉\n```\n\nThe server communicates with AgentBell.app by appending events to a local JSONL file (`~/Library/Caches/agentbell-events.jsonl`), which the app monitors in real time. No network requests, no external services.\n\n## Requirements\n\n- [AgentBell.app](https://agentbell.dev) running on macOS\n- Node.js >= 18\n\n\n\n## License\n\nMIT\n","readmeFilename":"README.md"}