{"_id":"@0xmemorylayer/mcp","name":"@0xmemorylayer/mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@0xmemorylayer/mcp","version":"1.0.0","description":"MCP server that gives any AI tool persistent memory and automation access via the Memory Layer API","type":"module","main":"dist/index.js","bin":{"memorylayer-mcp":"dist/index.js"},"scripts":{"start":"node dist/index.js","dev":"tsx watch src/index.ts","build":"tsc","clean":"rm -rf dist"},"engines":{"node":">=18"},"keywords":["mcp","memory","persistent-memory","ai-tools","model-context-protocol","memorylayer","automations"],"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.6.1","axios":"^1.7.9","zod":"^3.23.8"},"devDependencies":{"@types/node":"^22.10.0","tsx":"^4.19.2","typescript":"^5.7.2"},"_id":"@0xmemorylayer/mcp@1.0.0","types":"./dist/index.d.ts","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-ryKq2GEln3fv1GZyYctaNBdcxdKYJufX1yTozj/srL3C1m8j3LMdCF4Ofhk1wiXjY2Wu2dZ2sZCWjsAVbFM4Hg==","shasum":"6ab8eb70376e2c4c2e1f0ccc25cde41e139346a4","tarball":"https://registry.npmjs.org/@0xmemorylayer/mcp/-/mcp-1.0.0.tgz","fileCount":13,"unpackedSize":73748,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDo5+SRQvgvXlaXkJV036CXADJtLXXFxKaHeraN/60CpgIhANFU5o2yoNWMTrNXqyHwYiXu1N0tX0qU2rhGKmNhfQTz"}]},"_npmUser":{"name":"0xjpr","email":"juanriveraperez00@gmail.com"},"directories":{},"maintainers":[{"name":"0xjpr","email":"juanriveraperez00@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.0.0_1775655481394_0.5305351275274099"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-08T13:38:01.281Z","1.0.0":"2026-04-08T13:38:01.574Z","modified":"2026-04-08T13:38:01.838Z"},"maintainers":[{"name":"0xjpr","email":"juanriveraperez00@gmail.com"}],"description":"MCP server that gives any AI tool persistent memory and automation access via the Memory Layer API","keywords":["mcp","memory","persistent-memory","ai-tools","model-context-protocol","memorylayer","automations"],"license":"MIT","readme":"# @memorylayer/mcp\n\nAn MCP (Model Context Protocol) server that gives any AI tool persistent memory and automation access via the Memory Layer API.\n\nWhen an AI tool connects this MCP server, it gets session lifecycle management, persistent memory storage, corrections, handoffs, cross-session continuity, and full automation control — without needing any additional plugin.\n\n## Quick Start\n\nAdd this to your Claude Desktop MCP config (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"memorylayer\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@memorylayer/mcp\"],\n      \"env\": {\n        \"MEMORYLAYER_API_KEY\": \"ml_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `MEMORYLAYER_API_KEY` | Yes | Your Memory Layer API key (`ml_...`) |\n| `MEMORYLAYER_API_BASE` | No | Custom API base URL (advanced) |\n\n## Tools\n\n### Session Lifecycle\n\n**`start_session`** — Start a persistent memory session. Loads project context, last handoff, corrections, and memory entries. Call at the beginning of every conversation.\n\n**`end_session`** — End the active session with a handoff note. The handoff is what the next session sees.\n\n### Memory Operations\n\n**`remember`** — Save information to persistent memory mid-session.\n\n**`recall`** — Retrieve memories from cached session data, optionally filtered by scope and type.\n\n### Context Access\n\n**`get_handoff`** — Get the handoff note from the previous session (\"what should I do next?\").\n\n**`get_corrections`** — Get active corrections that override conflicting context.\n\n**`get_project_info`** — Get project name, tier, and session count.\n\n### Status\n\n**`memory_status`** — Check current session state: active session, session ID, memory count, active scopes.\n\n### Automations\n\n**`ml_list_automations`** — List all automations in your account with their IDs, names, and status.\n\n**`ml_trigger_automation`** — Trigger a specific automation by UUID. Returns a `run_id` for tracking.\n\n**`ml_get_run_status`** — Check the status and output of a specific automation run.\n\n**`ml_list_runs`** — List recent automation run history, optionally filtered to a specific automation.\n\n### Agent Sync (Hub)\n\n**`sync_agent_install`** — Register a locally-installed agent with the Memory Layer hub dashboard.\n\n**`log_agent_run`** — Log a completed agent run to the hub's Run History dashboard.\n\n## How It Works\n\n1. **Start a conversation** → AI calls `start_session` → gets project context + last handoff\n2. **Do work** → AI calls `remember` to save knowledge mid-session\n3. **End the conversation** → AI calls `end_session` with a handoff note\n4. **Start a NEW conversation** → AI calls `start_session` → gets the handoff from step 3\n\nThat's persistent memory across conversations, powered by the Memory Layer API, delivered via MCP.\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-66665e5959b4144a91b103ae3f261dba"}