{"_id":"agentation-mcp","_rev":"6-0adfe26499b4c9d99416d16ecb83d61c","name":"agentation-mcp","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"agentation-mcp","version":"1.0.0","license":"PolyForm-Shield-1.0.0","_id":"agentation-mcp@1.0.0","maintainers":[{"name":"benjitaylor","email":"accounts@benji.co"}],"bin":{"agentation-mcp":"dist/cli.js"},"dist":{"shasum":"3952de6c753e3b2a5837f74a220d5cdb58178b06","tarball":"https://registry.npmjs.org/agentation-mcp/-/agentation-mcp-1.0.0.tgz","fileCount":10,"integrity":"sha512-p901+6/AzS4e21H2KivG6lenpA0S7dyOVXWJSZEszV9sO3k7vGPBmJMf2Je/HIhRTNTAHS6giUUIxA6k9f8X/w==","signatures":[{"sig":"MEYCIQCE2K/+WyVE6Ght9XIyewqi8ir7mfzJKQ48jtINh9K3hwIhAJTAoDsvaXfeVRwebwou18gzaqmdkMrWAEOLDA0X+ax7","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":752538},"main":"./dist/index.js","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":{"types":"./dist/index.d.mts","default":"./dist/index.mjs"},"require":{"types":"./dist/index.d.ts","default":"./dist/index.js"}}},"gitHead":"e8e84a25bf322baee121b35237da0921fe1877de","scripts":{"dev":"pnpm build && pnpm watch","build":"tsup","start":"pnpm build && node dist/cli.js server","watch":"tsup --watch","prepublishOnly":"pnpm build"},"_npmUser":{"name":"benjitaylor","email":"accounts@benji.co"},"_npmVersion":"11.7.0","description":"MCP server for Agentation - visual feedback for AI coding agents","directories":{},"_nodeVersion":"25.3.0","dependencies":{"zod":"^3.23.0","better-sqlite3":"^12.6.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/agentation-mcp_1.0.0_1770244995146_0.24307298001952882","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"agentation-mcp","version":"1.0.1","license":"PolyForm-Shield-1.0.0","_id":"agentation-mcp@1.0.1","maintainers":[{"name":"benjitaylor","email":"accounts@benji.co"}],"bin":{"agentation-mcp":"dist/cli.js"},"dist":{"shasum":"e14ab44b136db079e49c04836fb0317c712f2ef0","tarball":"https://registry.npmjs.org/agentation-mcp/-/agentation-mcp-1.0.1.tgz","fileCount":11,"integrity":"sha512-FzvbBwqQoJiXAA62zOJEo61wNMjTmktN9FKF7/HXtLqv+EZdQX69sTRYAwZxH72cjzipRoeWHDPHOvrNAaWnFw==","signatures":[{"sig":"MEUCIEbyg8HGlNsUbaAHfWHaipiBwvpSUtYHYZxMZCWyXAqrAiEAtkVPhsKATs0kROVqwFok0mVSojDpCudob7OLBgqa5aw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":741450},"main":"./dist/index.js","_from":"file:agentation-mcp-1.0.1.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":{"types":"./dist/index.d.mts","default":"./dist/index.mjs"},"require":{"types":"./dist/index.d.ts","default":"./dist/index.js"}}},"scripts":{"dev":"pnpm build && pnpm watch","build":"tsup","start":"pnpm build && node dist/cli.js server","watch":"tsup --watch"},"_npmUser":{"name":"benjitaylor","email":"accounts@benji.co"},"_resolved":"/private/var/folders/pj/d2q07ff97kx7c6qzghb65khm0000gn/T/2aaf78a8bdafe7bf29276cb5409a5b9f/agentation-mcp-1.0.1.tgz","_integrity":"sha512-FzvbBwqQoJiXAA62zOJEo61wNMjTmktN9FKF7/HXtLqv+EZdQX69sTRYAwZxH72cjzipRoeWHDPHOvrNAaWnFw==","_npmVersion":"11.7.0","description":"MCP server for Agentation - visual feedback for AI coding agents","directories":{},"_nodeVersion":"25.3.0","dependencies":{"zod":"^3.23.0","better-sqlite3":"^12.6.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/agentation-mcp_1.0.1_1770268192410_0.34406624317916457","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"agentation-mcp","version":"1.0.2","license":"PolyForm-Shield-1.0.0","_id":"agentation-mcp@1.0.2","maintainers":[{"name":"benjitaylor","email":"accounts@benji.co"}],"bin":{"agentation-mcp":"dist/cli.js"},"dist":{"shasum":"7e9d8ac89d4e692c205a9f46bac65541bef2927d","tarball":"https://registry.npmjs.org/agentation-mcp/-/agentation-mcp-1.0.2.tgz","fileCount":11,"integrity":"sha512-QQLWnBpqUgwDvTwaqz9+VMwb46CaODuvVOQ8sahN+8cAPrbPYxEABv1ElamolhqGv45Jhf+4gjYgvPpWazcQxA==","signatures":[{"sig":"MEUCIERFFP3tdrPQn0CDDBJRCcZJNFn4CxMgVdP5KLTczfHhAiEAy1KWx42grpMTh3wrES3tnlUi4UmdO4l+tXKA5hNjPnU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":740960},"main":"./dist/index.js","_from":"file:agentation-mcp-1.0.2.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":{"types":"./dist/index.d.mts","default":"./dist/index.mjs"},"require":{"types":"./dist/index.d.ts","default":"./dist/index.js"}}},"scripts":{"dev":"pnpm build && pnpm watch","build":"tsup","start":"pnpm build && node dist/cli.js server","watch":"tsup --watch"},"_npmUser":{"name":"benjitaylor","email":"accounts@benji.co"},"_resolved":"/private/var/folders/pj/d2q07ff97kx7c6qzghb65khm0000gn/T/43d2348fd23d5938939484b941812af2/agentation-mcp-1.0.2.tgz","_integrity":"sha512-QQLWnBpqUgwDvTwaqz9+VMwb46CaODuvVOQ8sahN+8cAPrbPYxEABv1ElamolhqGv45Jhf+4gjYgvPpWazcQxA==","_npmVersion":"11.7.0","description":"MCP server for Agentation - visual feedback for AI coding agents","directories":{},"_nodeVersion":"25.3.0","dependencies":{"zod":"^3.23.0","better-sqlite3":"^12.6.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/agentation-mcp_1.0.2_1770308220352_0.9466472168449747","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"agentation-mcp","version":"1.1.0","license":"PolyForm-Shield-1.0.0","_id":"agentation-mcp@1.1.0","maintainers":[{"name":"benjitaylor","email":"accounts@benji.co"}],"bin":{"agentation-mcp":"dist/cli.js"},"dist":{"shasum":"476f574c3cfe049e699d38831ea5972b79c092e1","tarball":"https://registry.npmjs.org/agentation-mcp/-/agentation-mcp-1.1.0.tgz","fileCount":10,"integrity":"sha512-KhT2e+jJjBItgJ1+dlHxDsR8sLRLg9Deqhv3D2LQBidT3LlKmeiLGdmTxN/kxVA58m5EjhT9VSab9cvpc0sS7g==","signatures":[{"sig":"MEUCIQCpRORgufqFurJCMrRNwlL97l5a4wtJD7pIz0i1TveUNAIgZ1TKEineQrxhSppQtVZuEPP6YaXMPTDuk1kxd3HRc1E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":760215},"main":"./dist/index.js","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":{"types":"./dist/index.d.mts","default":"./dist/index.mjs"},"require":{"types":"./dist/index.d.ts","default":"./dist/index.js"}}},"scripts":{"dev":"pnpm build && pnpm watch","build":"tsup","start":"pnpm build && node dist/cli.js server","watch":"tsup --watch","prepublishOnly":"pnpm build"},"_npmUser":{"name":"benjitaylor","email":"accounts@benji.co"},"_npmVersion":"11.7.0","description":"MCP server for Agentation - visual feedback for AI coding agents","directories":{},"_nodeVersion":"25.3.0","dependencies":{"zod":"^3.23.0","better-sqlite3":"^12.6.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/agentation-mcp_1.1.0_1770346433718_0.5564739748251792","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"agentation-mcp","version":"1.1.1","license":"PolyForm-Shield-1.0.0","_id":"agentation-mcp@1.1.1","maintainers":[{"name":"benjitaylor","email":"accounts@benji.co"}],"bin":{"agentation-mcp":"dist/cli.js"},"dist":{"shasum":"8262b38565b405efc19aaba20dd32b2501ae6113","tarball":"https://registry.npmjs.org/agentation-mcp/-/agentation-mcp-1.1.1.tgz","fileCount":10,"integrity":"sha512-SyaojziqvhEwqHCfBrvl2FyN+Cj8I24fUkSgbpb7pPzyiVfKKY8LhxUGwRh2OGLTKpKwExqFTWWO1AiX3w1hsQ==","signatures":[{"sig":"MEYCIQC3/kJXcWljQ4m4SsK7F9M+1Hld2y8B7llQxDE8O6PElgIhANZHyiEoMbwDVIGww7MCgrarojlSw6a+TpIckyeMZsC6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":762258},"main":"./dist/index.js","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":{"types":"./dist/index.d.mts","default":"./dist/index.mjs"},"require":{"types":"./dist/index.d.ts","default":"./dist/index.js"}}},"scripts":{"dev":"pnpm build && pnpm watch","build":"tsup","start":"pnpm build && node dist/cli.js server","watch":"tsup --watch","prepublishOnly":"pnpm build"},"_npmUser":{"name":"benjitaylor","email":"accounts@benji.co"},"_npmVersion":"11.7.0","description":"MCP server for Agentation - visual feedback for AI coding agents","directories":{},"_nodeVersion":"25.3.0","dependencies":{"zod":"^3.23.0","better-sqlite3":"^12.6.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/agentation-mcp_1.1.1_1770662435763_0.5846095604407717","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"agentation-mcp","version":"1.2.0","description":"MCP server for Agentation - visual feedback for AI coding agents","license":"PolyForm-Shield-1.0.0","main":"./dist/index.js","module":"./dist/index.mjs","types":"./dist/index.d.ts","bin":{"agentation-mcp":"dist/cli.js"},"exports":{".":{"types":"./dist/index.d.ts","import":{"types":"./dist/index.d.mts","default":"./dist/index.mjs"},"require":{"types":"./dist/index.d.ts","default":"./dist/index.js"}}},"scripts":{"build":"tsup","watch":"tsup --watch","dev":"pnpm build && pnpm watch","start":"pnpm build && node dist/cli.js server","prepublishOnly":"pnpm build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","better-sqlite3":"^12.6.2","zod":"^3.23.0"},"devDependencies":{"@types/better-sqlite3":"^7.6.13","@types/node":"^20.0.0","tsup":"^8.0.0","typescript":"^5.0.0"},"engines":{"node":">=18.0.0"},"gitHead":"b2d967a3887649b02283e86964aab25d24d0296b","_id":"agentation-mcp@1.2.0","_nodeVersion":"25.3.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-BRHVm/YRyAHzJFM8i+ZbgpLgpnVptyKeUyauYd2pkOBX/oVFYGOjjLU+YtpNZD1Np+5/jJAp9xFbv1SE112Wwg==","shasum":"80d942f7f3047b937546e67c1d9de38cba16f84b","tarball":"https://registry.npmjs.org/agentation-mcp/-/agentation-mcp-1.2.0.tgz","fileCount":10,"unpackedSize":774045,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCP9Mjil2Unr93GnTLPEoWPasiMx6ON7KtORCSxcY32NgIgcEEOZ9GSeqLZ/mUBWc9q64/yfAOIrhztsaUFBDNvuQo="}]},"_npmUser":{"name":"benjitaylor","email":"accounts@benji.co"},"directories":{},"maintainers":[{"name":"benjitaylor","email":"accounts@benji.co"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentation-mcp_1.2.0_1771187824257_0.4635172874274074"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-04T22:43:15.145Z","modified":"2026-02-15T20:37:04.566Z","1.0.0":"2026-02-04T22:43:15.364Z","1.0.1":"2026-02-05T05:09:52.599Z","1.0.2":"2026-02-05T16:17:00.491Z","1.1.0":"2026-02-06T02:53:53.877Z","1.1.1":"2026-02-09T18:40:35.973Z","1.2.0":"2026-02-15T20:37:04.456Z"},"license":"PolyForm-Shield-1.0.0","description":"MCP server for Agentation - visual feedback for AI coding agents","maintainers":[{"name":"benjitaylor","email":"accounts@benji.co"}],"readme":"# Agentation MCP\n\nMCP (Model Context Protocol) server for Agentation - visual feedback for AI coding agents.\n\nThis package provides an MCP server that allows AI coding agents (like Claude Code) to receive and respond to web page annotations created with the Agentation toolbar.\n\n## Installation\n\n```bash\nnpm install agentation-mcp\n# or\npnpm add agentation-mcp\n```\n\n## Quick Start\n\n### 1. Set up the MCP server\n\nAdd the MCP server to Claude Code:\n\n```bash\nclaude mcp add agentation -- npx agentation-mcp server\n```\n\nOr use the interactive setup wizard: `npx agentation-mcp init`\n\n### 2. Start the server\n\n```bash\nagentation-mcp server\n```\n\nThis starts both:\n- **HTTP server** (port 4747) - receives annotations from the browser toolbar\n- **MCP server** (stdio) - exposes tools for Claude Code\n\n### 3. Verify your setup\n\n```bash\nagentation-mcp doctor\n```\n\n## CLI Commands\n\n```bash\nagentation-mcp init                    # Setup wizard (registers via claude mcp add)\nagentation-mcp server [options]        # Start the annotation server\nagentation-mcp doctor                  # Check your setup\nagentation-mcp help                    # Show help\n```\n\n### Server Options\n\n```bash\n--port <port>      # HTTP server port (default: 4747)\n--mcp-only         # Skip HTTP server, only run MCP on stdio\n--http-url <url>   # HTTP server URL for MCP to fetch from\n```\n\n## MCP Tools\n\nThe MCP server exposes these tools to AI agents:\n\n| Tool | Description |\n|------|-------------|\n| `agentation_list_sessions` | List all active annotation sessions |\n| `agentation_get_session` | Get a session with all its annotations |\n| `agentation_get_pending` | Get pending annotations for a session |\n| `agentation_get_all_pending` | Get pending annotations across all sessions |\n| `agentation_acknowledge` | Mark an annotation as acknowledged |\n| `agentation_resolve` | Mark an annotation as resolved |\n| `agentation_dismiss` | Dismiss an annotation with a reason |\n| `agentation_reply` | Add a reply to an annotation thread |\n| `agentation_watch_annotations` | Block until new annotations appear, then return batch |\n\n## HTTP API\n\nThe HTTP server provides a REST API for the browser toolbar:\n\n### Sessions\n- `POST /sessions` - Create a new session\n- `GET /sessions` - List all sessions\n- `GET /sessions/:id` - Get session with annotations\n\n### Annotations\n- `POST /sessions/:id/annotations` - Add annotation\n- `GET /annotations/:id` - Get annotation\n- `PATCH /annotations/:id` - Update annotation\n- `DELETE /annotations/:id` - Delete annotation\n- `GET /sessions/:id/pending` - Get pending annotations\n- `GET /pending` - Get all pending annotations\n\n### Events (SSE)\n- `GET /sessions/:id/events` - Session event stream\n- `GET /events` - Global event stream (optionally filter with `?domain=...`)\n\n### Health\n- `GET /health` - Health check\n- `GET /status` - Server status\n\n## Hands-Free Mode\n\nUse `agentation_watch_annotations` in a loop for automatic feedback processing -- the agent picks up new annotations as they're created:\n\n1. Agent calls `agentation_watch_annotations` (blocks until annotations appear)\n2. Annotations arrive -- agent receives batch after collection window\n3. Agent processes each annotation:\n   - `agentation_acknowledge` -- mark as seen\n   - Make code changes\n   - `agentation_resolve` -- mark as done with summary\n4. Agent calls `agentation_watch_annotations` again (loop)\n\nExample CLAUDE.md instructions:\n\n```markdown\nWhen I say \"watch mode\", call agentation_watch_annotations in a loop.\nFor each annotation: acknowledge it, make the fix, then resolve it with a summary.\nContinue watching until I say stop or timeout is reached.\n```\n\n## Webhooks\n\nConfigure webhooks to receive notifications when users request agent action:\n\n```bash\n# Single webhook\nexport AGENTATION_WEBHOOK_URL=https://your-server.com/webhook\n\n# Multiple webhooks (comma-separated)\nexport AGENTATION_WEBHOOKS=https://server1.com/hook,https://server2.com/hook\n```\n\n## Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `AGENTATION_STORE` | Storage backend (`memory` or `sqlite`) | `sqlite` |\n| `AGENTATION_WEBHOOK_URL` | Single webhook URL | - |\n| `AGENTATION_WEBHOOKS` | Comma-separated webhook URLs | - |\n| `AGENTATION_EVENT_RETENTION_DAYS` | Days to keep events | `7` |\n\n## Programmatic Usage\n\n```typescript\nimport { startHttpServer, startMcpServer } from 'agentation-mcp';\n\n// Start HTTP server on port 4747\nstartHttpServer(4747);\n\n// Start MCP server (connects via stdio)\nawait startMcpServer('http://localhost:4747');\n```\n\n## Storage\n\nBy default, data is persisted to SQLite at `~/.agentation/store.db`. To use in-memory storage:\n\n```bash\nAGENTATION_STORE=memory agentation-mcp server\n```\n\n## License\n\nPolyForm Shield 1.0.0\n","readmeFilename":"README.md"}