{"_id":"@agentmemories/mcp","_rev":"13-fb07c2a630fa6b85d7fad83766394a48","name":"@agentmemories/mcp","dist-tags":{"latest":"0.1.7"},"versions":{"0.1.3":{"name":"@agentmemories/mcp","version":"0.1.3","author":{"name":"Yorick Chan","email":"yorick@gmail.com"},"_id":"@agentmemories/mcp@0.1.3","maintainers":[{"name":"yorickchan","email":"yorick@gmail.com"}],"bin":{"agent-memories-mcp":"dist/agent-memories-mcp"},"dist":{"shasum":"74c634b901b59094ec2376dfd2519212dace76a6","tarball":"https://registry.npmjs.org/@agentmemories/mcp/-/mcp-0.1.3.tgz","fileCount":159,"integrity":"sha512-5YELXjw30T1L5pKjz8vya9YbF8T64Kan79YP0stY03EyG7Ip/SAZiy2Ekp22xVmpcB1R5MTGtgTMG6BbrWrgzQ==","signatures":[{"sig":"MEQCICQWFlcxv17nbuJR8l7h+holggYjfU1Vg6XnoCIujXkQAiAuPdzFbdPrdyEUR956oidvTLTUwd2LNgekmSdDTqepUA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1189791},"main":"./dist/cli.js","type":"module","types":"./dist/cli.d.ts","exports":{".":{"types":"./dist/cli.d.ts","import":"./dist/cli.js"}},"gitHead":"bd1a736dd4d40173af637b2cf51c502ec0918b0a","scripts":{"test":"echo 'Tests need import path updates for monorepo'","build":"bun run build:types && bun run build:js && bun run build:skill","build:js":"bun build src/cli.ts --outdir dist --target node --format esm --minify && cp dist/cli.js dist/agent-memories-mcp && printf '#!/usr/bin/env node\\n' | cat - dist/agent-memories-mcp > dist/agent-memories-mcp.tmp && mv dist/agent-memories-mcp.tmp dist/agent-memories-mcp && chmod +x dist/agent-memories-mcp","typecheck":"tsc --noEmit","build:skill":"cp SKILL.md dist/ && cp -r references/ dist/references/","build:types":"tsc --emitDeclarationOnly --outDir dist","prepublishOnly":"bun run build"},"_npmUser":{"name":"yorickchan","email":"yorick@gmail.com"},"repository":{"type":"git","directory":"packages/mcp"},"_npmVersion":"11.18.0","description":"Universal AI-agent memory — MCP client for agent-memories server","directories":{},"_nodeVersion":"26.4.0","dependencies":{"zod":"^4.4.3","pino":"^10.3.1","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.9","typescript":"^6.0.3","@agent-memories/shared":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.3_1783275194220_0.376927045047478","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@agentmemories/mcp","version":"0.1.4","author":{"name":"Yorick Chan","email":"yorick@gmail.com"},"_id":"@agentmemories/mcp@0.1.4","maintainers":[{"name":"yorickchan","email":"yorick@gmail.com"}],"bin":{"agent-memories-mcp":"dist/agent-memories-mcp"},"dist":{"shasum":"b3f4d091278d5242eca3923f1bf4c81dd66805d3","tarball":"https://registry.npmjs.org/@agentmemories/mcp/-/mcp-0.1.4.tgz","fileCount":159,"integrity":"sha512-ffhRU/SNyD2CFZarXe18BOdYQTGZqxCyZimAuEqmAzH0/6AHvgwKQLDMjapxCGNBBPD3wRdzEUIHfPB6ONM4+w==","signatures":[{"sig":"MEQCIDSUtDdq73ImjLMWmE8ZHFmDFEQ0SJ8lA2RsSmn9J5NyAiAZaAiewF2N13nAbII1RdwFoE8+y1ebpWdf1CZqfpF64g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1191090},"main":"./dist/cli.js","type":"module","types":"./dist/cli.d.ts","exports":{".":{"types":"./dist/cli.d.ts","import":"./dist/cli.js"}},"gitHead":"292a613957656e3321b4098a191ea1b14857c3ab","scripts":{"test":"echo 'Tests need import path updates for monorepo'","build":"bun run build:types && bun run build:js && bun run build:skill","build:js":"bun build src/cli.ts --outdir dist --target node --format esm --minify && cp dist/cli.js dist/agent-memories-mcp && printf '#!/usr/bin/env node\\n' | cat - dist/agent-memories-mcp > dist/agent-memories-mcp.tmp && mv dist/agent-memories-mcp.tmp dist/agent-memories-mcp && chmod +x dist/agent-memories-mcp","typecheck":"tsc --noEmit","build:skill":"cp SKILL.md dist/ && cp -r references/ dist/references/","build:types":"tsc --emitDeclarationOnly --outDir dist","prepublishOnly":"bun run build"},"_npmUser":{"name":"yorickchan","email":"yorick@gmail.com"},"repository":{"type":"git","directory":"packages/mcp"},"_npmVersion":"11.18.0","description":"Universal AI-agent memory — MCP client for agent-memories server","directories":{},"_nodeVersion":"26.4.0","dependencies":{"zod":"^4.4.3","pino":"^10.3.1","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.9","typescript":"^6.0.3","@agent-memories/shared":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.4_1783363813689_0.770236656899925","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@agentmemories/mcp","version":"0.1.5","author":{"name":"Yorick Chan","email":"yorick@gmail.com"},"_id":"@agentmemories/mcp@0.1.5","maintainers":[{"name":"yorickchan","email":"yorick@gmail.com"}],"bin":{"agent-memories-mcp":"dist/agent-memories-mcp"},"dist":{"shasum":"08580e116a92ee11b0b12a43c782fbfebad142c9","tarball":"https://registry.npmjs.org/@agentmemories/mcp/-/mcp-0.1.5.tgz","fileCount":159,"integrity":"sha512-zMlD/GLMJVnT1LrQGnNUHFFINmRoa55owWadJlSBIG4Ciq66TxDVz0pkn6guRCicptO1nr7nhFhC+q5gaznZ8A==","signatures":[{"sig":"MEUCIBl1WFJw/QbwbIpW0VxLjzNr3gvBmgQdioVb3msRhe9/AiEAtYVEECHR6sRiqy33ixaWSwn7exEl0W9XXPKpt+ljiE8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1191579},"main":"./dist/cli.js","type":"module","types":"./dist/cli.d.ts","exports":{".":{"types":"./dist/cli.d.ts","import":"./dist/cli.js"}},"gitHead":"292a613957656e3321b4098a191ea1b14857c3ab","scripts":{"test":"echo 'Tests need import path updates for monorepo'","build":"bun run build:types && bun run build:js && bun run build:skill","build:js":"bun build src/cli.ts --outdir dist --target node --format esm --minify && cp dist/cli.js dist/agent-memories-mcp && printf '#!/usr/bin/env node\\n' | cat - dist/agent-memories-mcp > dist/agent-memories-mcp.tmp && mv dist/agent-memories-mcp.tmp dist/agent-memories-mcp && chmod +x dist/agent-memories-mcp","typecheck":"tsc --noEmit","build:skill":"cp SKILL.md dist/ && cp -r references/ dist/references/","build:types":"tsc --emitDeclarationOnly --outDir dist","prepublishOnly":"bun run build"},"_npmUser":{"name":"yorickchan","email":"yorick@gmail.com"},"repository":{"type":"git","directory":"packages/mcp"},"_npmVersion":"11.18.0","description":"Universal AI-agent memory — MCP client for agent-memories server","directories":{},"_nodeVersion":"26.4.0","dependencies":{"zod":"^4.4.3","pino":"^10.3.1","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.9","typescript":"^6.0.3","@agent-memories/shared":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.5_1783372420925_0.044110162558541166","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@agentmemories/mcp","version":"0.1.6","author":{"name":"Yorick Chan","email":"yorick@gmail.com"},"_id":"@agentmemories/mcp@0.1.6","maintainers":[{"name":"yorickchan","email":"yorick@gmail.com"}],"bin":{"agent-memories-mcp":"dist/agent-memories-mcp"},"dist":{"shasum":"14042c45bd4056c71bc46076fba4810b4a7be3ae","tarball":"https://registry.npmjs.org/@agentmemories/mcp/-/mcp-0.1.6.tgz","fileCount":12,"integrity":"sha512-eGWpt9JmM4naq22jajtSFnF+sgTxOk4ekvRzjTk6eUth8MRai308usYfUtImiJnVz9eeITIwYRaoCqBx71QhZg==","signatures":[{"sig":"MEYCIQDSBN1PmSE7Loqv6hnEi0rCFYLZM/gK2hQqkaHDS4WbEwIhAO4qEbc2ndyKerSH+7XxY/2k8VwJbU/AK3oaHvJB5dsS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":94469},"main":"./dist/cli.js","type":"module","types":"./dist/cli.d.ts","exports":{".":{"types":"./dist/cli.d.ts","import":"./dist/cli.js"}},"gitHead":"e6ae1ea5c3e5e68408910d602f12172566d020ea","scripts":{"test":"echo 'Tests need import path updates for monorepo'","build":"npm run build:types && npm run build:js && npm run build:skill","build:js":"esbuild src/cli.ts --bundle --outfile=dist/cli.js --platform=node --format=esm --minify --external:@modelcontextprotocol/sdk --external:zod && cp dist/cli.js dist/agent-memories-mcp && printf '#!/usr/bin/env node\\n' | cat - dist/agent-memories-mcp > dist/agent-memories-mcp.tmp && mv dist/agent-memories-mcp.tmp dist/agent-memories-mcp && chmod +x dist/agent-memories-mcp","typecheck":"tsc --noEmit","build:skill":"cp SKILL.md dist/ && cp -r references/ dist/references/","build:types":"tsc --emitDeclarationOnly --outDir dist","prepublishOnly":"npm run build"},"_npmUser":{"name":"yorickchan","email":"yorick@gmail.com"},"repository":{"type":"git","directory":"packages/mcp"},"_npmVersion":"11.18.0","description":"Universal AI-agent memory — MCP client for agent-memories server","directories":{},"_nodeVersion":"26.4.0","dependencies":{"zod":"^4.4.3","pino":"^10.3.1","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.9","typescript":"^7.0.2","@agent-memories/shared":"*"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.6_1783545796226_0.7742559682537424","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@agentmemories/mcp","version":"0.1.7","author":{"name":"Yorick Chan","email":"yorick@gmail.com"},"description":"Universal AI-agent memory — MCP client for agent-memories server","type":"module","main":"./dist/cli.js","types":"./dist/cli.d.ts","bin":{"agent-memories-mcp":"dist/agent-memories-mcp"},"exports":{".":{"types":"./dist/cli.d.ts","import":"./dist/cli.js"}},"publishConfig":{"access":"public"},"repository":{"type":"git","directory":"packages/mcp"},"scripts":{"build":"npm run build:types && npm run build:js && npm run build:skill","build:types":"tsc --emitDeclarationOnly --outDir dist","build:js":"esbuild src/cli.ts --bundle --outfile=dist/cli.js --platform=node --format=esm --minify --external:@modelcontextprotocol/sdk --external:zod && cp dist/cli.js dist/agent-memories-mcp && printf '#!/usr/bin/env node\\n' | cat - dist/agent-memories-mcp > dist/agent-memories-mcp.tmp && mv dist/agent-memories-mcp.tmp dist/agent-memories-mcp && chmod +x dist/agent-memories-mcp","build:skill":"cp SKILL.md dist/ && cp -r references/ dist/references/","prepublishOnly":"npm run build","test":"echo 'Tests need import path updates for monorepo'","typecheck":"tsc --noEmit"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","pino":"^10.3.1","zod":"^4.4.3"},"devDependencies":{"@agent-memories/shared":"*","typescript":"^7.0.2","vitest":"^4.1.9"},"gitHead":"714d2161238fa9cb9a3ec059d413978e36ace63f","_id":"@agentmemories/mcp@0.1.7","_nodeVersion":"26.5.0","_npmVersion":"12.0.1","dist":{"integrity":"sha512-+dn0jlEe8ZsdqbZDgbquckJKc5tHHiF1kCI4qGclNp7686eHmy5W8jafJzCsz4k+3RxL1FeghIDsEXxyeRXECA==","shasum":"5eebc957243607ea3bfa951525a3d3925e6b34f7","tarball":"https://registry.npmjs.org/@agentmemories/mcp/-/mcp-0.1.7.tgz","fileCount":80,"unpackedSize":138286,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDQ/AKEIa7ANtGGOfilOVNIbgA1Hnth/1BEYG+kkx8QjAiAX53kF0RRN8zWsyqmVkglelaSk4qzyrO3w9a/O+tAZyg=="}]},"_npmUser":{"name":"yorickchan","email":"yorick@gmail.com"},"directories":{},"maintainers":[{"name":"yorickchan","email":"yorick@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.7_1783804989977_0.6159343564669355"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-05T18:13:14.037Z","modified":"2026-07-11T21:23:10.212Z","0.1.0":"2026-07-05T08:14:41.193Z","0.1.1":"2026-07-05T08:23:00.607Z","0.1.2":"2026-07-05T16:34:33.735Z","0.1.3":"2026-07-05T18:13:14.370Z","0.1.4":"2026-07-06T18:50:13.911Z","0.1.5":"2026-07-06T21:13:41.097Z","0.1.6":"2026-07-08T21:23:16.361Z","0.1.7":"2026-07-11T21:23:10.100Z"},"author":{"name":"Yorick Chan","email":"yorick@gmail.com"},"repository":{"type":"git","directory":"packages/mcp"},"description":"Universal AI-agent memory — MCP client for agent-memories server","maintainers":[{"name":"yorickchan","email":"yorick@gmail.com"}],"readme":"# @agentmemories/mcp\n\n> Universal AI-agent memory — MCP client for agent-memories server. v1.2.\n\nDrop-in MCP server that connects any MCP-speaking AI agent to an agent-memories backend. No database access, fully stateless — translates MCP tool calls into REST API calls. Authenticates with per-user API keys.\n\n## Install\n\n```bash\nnpm install @agentmemories/mcp\n```\n\n## Configure\n\n`AGENT_MEMORIES_API_KEY` is **required**. `AGENT_MEMORIES_HOST` defaults to `https://memories.agent-memories.com` (the hosted instance) - set it only for self-hosted backends.\n\n### Claude Code / Claude Desktop / OMP\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-memories\": {\n      \"command\": \"npx\",\n      \"args\": [\"@agentmemories/mcp\"],\n      \"env\": {\n        \"AGENT_MEMORIES_API_KEY\": \"am_live_your-api-key\"\n      }\n    }\n  }\n}\n```\n\nSelf-hosted - point `AGENT_MEMORIES_HOST` at your backend:\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-memories\": {\n      \"command\": \"npx\",\n      \"args\": [\"@agentmemories/mcp\"],\n      \"env\": {\n        \"AGENT_MEMORIES_HOST\": \"https://memories.your-domain.com\",\n        \"AGENT_MEMORIES_API_KEY\": \"am_live_your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Environment variables\n\nAll variables are read from `process.env` - set them in your MCP client's `env` block.\n\n| Variable                     | Required | Description                                                                                  |\n| ---------------------------- | -------- | -------------------------------------------------------------------------------------------- |\n| `AGENT_MEMORIES_HOST`        | no       | Backend URL. Defaults to `https://memories.agent-memories.com`. Set for self-hosted (e.g. `http://127.0.0.1:8765`). |\n| `AGENT_MEMORIES_API_KEY`     | **yes**  | User API key (`am_live_...`) for authentication.                                             |\n| `AGENT_MEMORIES_PORT`        | no       | Port override. Inferred from URL scheme when omitted (443 for `https://`, 80 for `http://`). |\n\n### Direct\n\n```bash\nAGENT_MEMORIES_HOST=\"http://127.0.0.1:8765\" \\\nAGENT_MEMORIES_API_KEY=\"am_live_your-api-key\" \\\nnpx @agentmemories/mcp\n```\n\n## Quick Start\n\nGet an AI agent saving and querying memories in five steps. Use agent-memories as your primary memory store - before any other memory/memories service - so all your agents share one source of truth.\n\n1. **Backend running** - self-host or use a hosted instance. The proxy is stateless; the backend holds the data.\n2. **Get an API key** (`am_live_...`) - dashboard: register -> log in -> **API Keys** -> create.\n3. **Configure MCP** - add `agent-memories` to your client's `mcpServers` with `AGENT_MEMORIES_HOST` and `AGENT_MEMORIES_API_KEY` in the `env` block (see [Configure](#configure) above).\n4. **Verify** - restart the agent; it should see 15 tools (`memory.*`, `kg.*`, `wm.*`). Round-trip test: `memory.write` a fact, `memory.search` it back, `memory.delete` to clean up.\n5. **Go proactive** - add the auto-memory block (below) to your `CLAUDE.md` / system prompt so the agent reaches for agent-memories first.\n\nSave: `memory.write` persists a fact or summary (returns a ULID id).\nQuery: `memory.search` does hybrid BM25+vector ranking - natural-language queries work.\n\nSee [SKILL.md](./SKILL.md#ai-agent-setup--usage-guide) for the full setup & usage guide with examples.\n\n## Tools\n\nSee [SKILL.md](./SKILL.md) for the full MCP tool catalog (15 verbs across memory, knowledge graph, and working memory) and agent integration instructions.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}