{"_id":"agentation-mcp","_rev":"9-f0f0199ad0b1e98e14c7ce2b7b85dfc2","name":"agentation-mcp","dist-tags":{"latest":"1.3.2"},"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","license":"PolyForm-Shield-1.0.0","_id":"agentation-mcp@1.2.0","maintainers":[{"name":"benjitaylor","email":"accounts@benji.co"}],"bin":{"agentation-mcp":"dist/cli.js"},"dist":{"shasum":"80d942f7f3047b937546e67c1d9de38cba16f84b","tarball":"https://registry.npmjs.org/agentation-mcp/-/agentation-mcp-1.2.0.tgz","fileCount":10,"integrity":"sha512-BRHVm/YRyAHzJFM8i+ZbgpLgpnVptyKeUyauYd2pkOBX/oVFYGOjjLU+YtpNZD1Np+5/jJAp9xFbv1SE112Wwg==","signatures":[{"sig":"MEUCIQCP9Mjil2Unr93GnTLPEoWPasiMx6ON7KtORCSxcY32NgIgcEEOZ9GSeqLZ/mUBWc9q64/yfAOIrhztsaUFBDNvuQo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":774045},"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":"b2d967a3887649b02283e86964aab25d24d0296b","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.2.0_1771187824257_0.4635172874274074","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"agentation-mcp","version":"1.3.0","license":"PolyForm-Shield-1.0.0","_id":"agentation-mcp@1.3.0","maintainers":[{"name":"benjitaylor","email":"accounts@benji.co"}],"bin":{"agentation-mcp":"dist/cli.js"},"dist":{"shasum":"080217d7565af714a89d7ffc32a0cb05c39482d2","tarball":"https://registry.npmjs.org/agentation-mcp/-/agentation-mcp-1.3.0.tgz","fileCount":11,"integrity":"sha512-DSP39BrNcaaHXTsXz+IueDfigcWQdfFMMBhLGYQz0cY154Zr8Q/W2jrTyratGEQ3shfSSO3naYdH412r8ctsSQ==","signatures":[{"sig":"MEQCIDYbI/YpJWVivbiIzn7AVkDhCIyGhSHWQ5J5UoYN8uwKAiBiOh/neGrgoHoHy8Ud1tc/7fUyuKjUXzrUQRqEbjYFfg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIEkEv+zXt5IOx22bindaloXcvMfwWFeU0enkgjaf5+SJAiEAkkM/I4xqlZhqYoSFoSjy5gvwcfX7HgHvE68NHuQ/iAI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":872979},"main":"./dist/index.js","_from":"file:/private/tmp/agentation-release-review/approved-release-artifacts/agentation-mcp-1.3.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=20.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","test":"tsup --config test/tsup.config.ts && node --test test/*.test.cjs","build":"tsup","start":"pnpm build && node dist/cli.js server","watch":"tsup --watch","prepublishOnly":"pnpm build"},"_npmUser":{"name":"benjitaylor","email":"accounts@benji.co"},"_resolved":"/private/tmp/agentation-release-review/approved-release-artifacts/agentation-mcp-1.3.0.tgz","_integrity":"sha512-DSP39BrNcaaHXTsXz+IueDfigcWQdfFMMBhLGYQz0cY154Zr8Q/W2jrTyratGEQ3shfSSO3naYdH412r8ctsSQ==","_npmVersion":"11.7.0","description":"MCP server for Agentation - visual feedback for AI coding agents","directories":{},"_nodeVersion":"25.3.0","dependencies":{"zod":"^3.25.76","better-sqlite3":"^12.11.1","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.9.3","@types/node":"^20.19.43","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/agentation-mcp_1.3.0_1789973563884_0.6871096595877981","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"agentation-mcp","version":"1.3.1","license":"PolyForm-Shield-1.0.0","_id":"agentation-mcp@1.3.1","maintainers":[{"name":"benjitaylor","email":"accounts@benji.co"}],"bin":{"agentation-mcp":"dist/cli.js"},"dist":{"shasum":"ad91ea0ee2faf2371e28c66b31e526f92d8d65fb","tarball":"https://registry.npmjs.org/agentation-mcp/-/agentation-mcp-1.3.1.tgz","fileCount":11,"integrity":"sha512-WceirW4sEe0tfyO3/e2Tzy+meEpls57bmDhuB65eYXyVfDzMQeTIYVOM2DvCwQq/vd9nIcdjbAaqddJA/MkKVA==","signatures":[{"sig":"MEYCIQC0YaLJVmm7CBjnN6U/yKv7rBSFTDDhk2rQPQB1qs/QuQIhAM5DJFgcVQQ1anng7uzhgYPk3o7BeHoCSuS40HXOYCiE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIG+JNrEIk2EKgZo+mA7oFmKr4b7E4g6EknvVh5tjxRSKAiEArcvk8Yke2HDiigCq3vxjHdHAWomJbsYbAuaOU7V6S6o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":903597},"main":"./dist/index.js","_from":"file:agentation-mcp-1.3.1.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=20.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","test":"tsup --config test/tsup.config.ts && node --test test/*.test.cjs","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/d412cdf7f7a886336fa9ed7763669f1e/agentation-mcp-1.3.1.tgz","_integrity":"sha512-WceirW4sEe0tfyO3/e2Tzy+meEpls57bmDhuB65eYXyVfDzMQeTIYVOM2DvCwQq/vd9nIcdjbAaqddJA/MkKVA==","_npmVersion":"10.9.4","description":"MCP server for Agentation - visual feedback for AI coding agents","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.25.76","better-sqlite3":"^12.11.1","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.9.3","@types/node":"^20.19.43","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/agentation-mcp_1.3.1_1789977947926_0.16076464645162525","host":"s3://npm-registry-packages-npm-production"}},"1.3.2":{"_id":"agentation-mcp@1.3.2","bin":{"agentation-mcp":"dist/cli.js"},"dist":{"shasum":"634500e7ef5962c9e206135d46587be58c4f2508","tarball":"https://registry.npmjs.org/agentation-mcp/-/agentation-mcp-1.3.2.tgz","fileCount":11,"integrity":"sha512-1h3k6kj2ttzahwtMYGyfmrbYZMA3A5/mQwczFmQTfkNb2mgh5DyYG4uUjEbAaAz+a4LCDKahLmC050Gg8uY3tw==","signatures":[{"sig":"MEYCIQD9SiEbHgPo9JYhrbp+HM50xpEtIEQ/iLUWvGYUhNU1eQIhAKkGmDe9IJwGm0PWQv4B2ELmWvKeyRxfPGWvQ8iVBKM3","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDB0w9lE8Q/wcqfx4s1c5Rqld58kuVy3ap1/itjBQEK+AIhAOZpiERibg8OAMKw2jeNimdZ9/T+vIrwJA5HVKCbAvtP"}],"unpackedSize":906986},"main":"./dist/index.js","name":"agentation-mcp","_from":"file:agentation-mcp-1.3.2.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=20.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"}}},"license":"PolyForm-Shield-1.0.0","scripts":{"dev":"pnpm build && pnpm watch","test":"tsup --config test/tsup.config.ts && node --test test/*.test.cjs","build":"tsup","start":"pnpm build && node dist/cli.js server","watch":"tsup --watch"},"version":"1.3.2","_npmUser":{"name":"benjitaylor","email":"accounts@benji.co"},"_resolved":"/private/var/folders/pj/d2q07ff97kx7c6qzghb65khm0000gn/T/f947f0b9b635a008320cb1dfd5beca37/agentation-mcp-1.3.2.tgz","_integrity":"sha512-1h3k6kj2ttzahwtMYGyfmrbYZMA3A5/mQwczFmQTfkNb2mgh5DyYG4uUjEbAaAz+a4LCDKahLmC050Gg8uY3tw==","_npmVersion":"10.9.4","description":"MCP server for Agentation - visual feedback for AI coding agents","directories":{},"maintainers":[{"name":"benjitaylor","email":"accounts@benji.co"}],"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.25.76","better-sqlite3":"^12.11.1","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.9.3","@types/node":"^20.19.43","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentation-mcp_1.3.2_1790044942010_0.943124774847184"}}},"time":{"created":"2026-02-04T22:43:15.145Z","modified":"2026-09-22T02:42:22.245Z","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","1.3.0":"2026-09-21T06:52:43.966Z","1.3.1":"2026-09-21T08:05:48.030Z","1.3.2":"2026-09-22T02:42:22.112Z"},"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":"<picture>\n  <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/benjitaylor/agentation/main/mcp/logo-dark.svg\">\n  <img src=\"https://raw.githubusercontent.com/benjitaylor/agentation/main/mcp/logo.svg\" alt=\"Agentation MCP\" width=\"240\">\n</picture>\n\n<br>\n\n[![npm version](https://img.shields.io/npm/v/agentation-mcp)](https://www.npmjs.com/package/agentation-mcp)\n[![downloads](https://img.shields.io/npm/dm/agentation-mcp)](https://www.npmjs.com/package/agentation-mcp)\n\n**[Agentation](https://agentation.com)** is an agent-agnostic visual feedback tool. Click elements on your page, add notes, and copy structured output that helps AI coding agents find the exact code you're referring to.\n\nThe MCP (Model Context Protocol) server connects Agentation to Claude Code, Codex, Gemini CLI, Grok Build, and other compatible agents, so they can receive and respond to your annotations directly.\n\n## Runtime requirement\n\nNode.js 24 LTS is recommended; Node.js 22 LTS is also supported. The minimum is Node.js 20, which remains compatible but is no longer maintained by Node.js. The browser toolbar has no Node.js runtime requirement.\n\nThe previous MCP release advertised Node.js 18, but its SQLite dependency already required Node.js 20 or newer. This release corrects that metadata; it does not introduce a new SQLite runtime minimum.\n\n## Installation\n\n```bash\nnpm install agentation-mcp\n# or\npnpm add agentation-mcp\n```\n\n## Quick Start\n\n### 1. Add to your agent\n\nThe fastest way to configure Agentation across any supported agent:\n\n```bash\nnpx add-mcp \"npx -y agentation-mcp server\"\n```\n\nUses [add-mcp](https://github.com/neondatabase/add-mcp) to detect supported installed clients. The [setup guide](https://agentation.com/install#agent-integration) also includes direct commands for Claude Code, Codex, Gemini CLI, and Grok Build.\n\nOr for Claude Code specifically:\n\n```bash\nclaude mcp add agentation -- npx -y agentation-mcp server\n```\n\n\n### 2. Start your agent\n\nRestart the agent after registering the server. It launches Agentation as a\nlocal stdio MCP process; keep that agent session running while annotating.\nThe server provides both:\n- **HTTP server** (port 4747) - receives annotations from the browser toolbar\n- **MCP server** (stdio) - exposes tools for your connected agent\n\n### 3. Connect the browser toolbar\n\n```tsx\n<Agentation endpoint=\"http://localhost:4747\" />\n```\n\nUse the same server URL as the agent, including a custom port if configured.\nWithout `endpoint`, the toolbar saves feedback locally for manual copying.\n\n### 4. Verify browser-to-agent delivery\n\n```bash\nnpx agentation-mcp doctor\n# Custom server:\nnpx agentation-mcp doctor --http-url http://localhost:4747\n```\n\nDoctor checks services, not browser delivery. Add one test annotation in the app,\nthen ask your agent to call `agentation_get_all_pending`. Confirm its exact\ncomment and page. If it is missing, check the component endpoint and that both\nclients point to the same server.\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--host <address>   # Interface to bind (default: loopback only)\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 SQLite events | `7` |\n| `AGENTATION_CORS_ORIGINS` | Allowed browser origins; see below | dev-server origins |\n| `AGENTATION_HOST` | Interface to bind; a non-loopback address enables remote clients | loopback only |\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## Network access\n\nThe server is for the browser on the same machine. By default it only answers\nclients connecting over loopback that address a local hostname (`localhost`,\n`127.0.0.1`, `[::1]` or `*.localhost`), so other devices on the network and\nDNS-rebinding pages get HTTP 403. To serve other machines deliberately, bind a\nspecific interface with `--host` or `AGENTATION_HOST`:\n\n```sh\nagentation-mcp server --host 0.0.0.0\n```\n\nThe bundled stdio tools follow that address automatically unless `--http-url`\nis set.\n\nPages served from that machine's private address are already allowed by the\ndefault origin policy below; use `AGENTATION_CORS_ORIGINS` for public origins.\n\n### Containers, Codespaces and remote dev\n\nWhen the browser reaches the server through a port forward or a container\nbridge, the connection is not loopback and the page origin is public. Allow\nboth explicitly:\n\n```sh\nAGENTATION_CORS_ORIGINS='https://your-forwarded-app-origin' agentation-mcp server --host 0.0.0.0\n```\n\n`agentation-mcp doctor` reports the address it can reach the server on.\n\n## Browser origins\n\n`AGENTATION_CORS_ORIGINS` controls which browser origins may call the HTTP server.\nIt applies to normal responses, errors, preflight requests, event streams, MCP\ntransport and cloud proxy routes. A disallowed Origin receives HTTP 403 before\nthe request can change data or be forwarded.\n\n```sh\nAGENTATION_CORS_ORIGINS='http://localhost:3000,https://preview.example.com' agentation-mcp server\n```\n\nUse exact HTTP(S) origins, including the port when present. Paths, credentials,\nquery strings, regular expressions and a wildcard mixed with other origins are\nrejected at startup. A trailing slash is accepted and normalized.\n\nWhen unset, dev-server origins are allowed: `localhost`, `*.localhost`,\n`127.0.0.1`, `[::1]`, private-network addresses (`10.*`, `192.168.*`,\n`172.16-31.*`) and `.local`, `.test` or `.internal` hostnames, over HTTP or\nHTTPS on any port. Set the variable to add anything else, or to `*` to allow\nevery origin. An explicitly empty value rejects every browser Origin. Requests without an Origin, such as ordinary CLI\nclients, remain allowed. CORS is a browser access policy, not authentication.\n\n## Webhook delivery\n\nConfigure destinations with `AGENTATION_WEBHOOK_URL` or comma-separated\n`AGENTATION_WEBHOOKS`. Repeated destinations are sent only once per action.\nAction responses do not wait for delivery to complete.\n\nNetwork failures, request timeouts, HTTP 429 and 5xx responses are retried.\nOther unsuccessful responses stop immediately. Each retry sends the same JSON\nbody and `X-Agentation-Delivery-Id` header. Receivers should use that ID to avoid\nprocessing a delivery twice: a timeout can occur after the receiver accepted it.\n\n| Variable | Default | Meaning |\n| --- | --- | --- |\n| `AGENTATION_WEBHOOK_MAX_RETRIES` | `3` | Additional attempts after the first; 0 disables retries, maximum 10. |\n| `AGENTATION_WEBHOOK_BASE_DELAY_MS` | `1000` | Initial exponential backoff, with up to 25% positive jitter. |\n| `AGENTATION_WEBHOOK_MAX_DELAY_MS` | `30000` | Maximum time between attempts, including jitter. |\n| `AGENTATION_WEBHOOK_TIMEOUT_MS` | `10000` | Per-request timeout. |\n\nRetry-After is respected for retryable HTTP responses. If it exceeds the maximum\ndelay, delivery stops rather than retrying before the requested time. Timing\nvalues must be positive integers no larger than 2,147,483,647 milliseconds;\ninvalid values fall back to their defaults.\n\nDelivery is best effort and held in memory. It is not a durable queue and does\nnot promise exactly-once processing. Closing the server cancels requests and\npending retries; restarting does not resume them. Request timers are cleared\nafter every attempt and pending timers do not keep the process alive.\n\n## In-memory event history\n\nThese limits apply when using the memory store. They bound replay history, not\nthe current sessions or annotations. SQLite storage is unchanged by these\nsettings.\n\n| Variable | Default | Meaning |\n| --- | --- | --- |\n| `AGENTATION_MAX_EVENTS` | `10000` | Maximum retained events; oldest events are removed first. |\n| `AGENTATION_EVENT_TTL_MS` | `3600000` | Event lifetime in milliseconds, default one hour. |\n| `AGENTATION_CLEANUP_INTERVAL_MS` | `300000` | Background cleanup interval, default five minutes. |\n\nAll three values must be positive safe integers. The cleanup interval must also\nfit the timer limit above. Invalid values fall back to their defaults. Reads\nremove expired events immediately, without waiting for the next cleanup tick.\nPruning does not reset event sequence numbers. Closing the store clears its\ncleanup timer, which does not keep an otherwise idle process running.\n\n## Embedding the HTTP server\n\n`startHttpServer(port)` returns the Node HTTP server. Existing callers can ignore\nthe return value; embedded callers can use `server.close()` to stop accepting\nrequests and cancel outstanding webhook deliveries.\n\n## License\n\nPolyForm Shield 1.0.0\n","readmeFilename":"README.md"}