@agentstash/mcp

Shared memory for Claude Code, Cursor, and Codex. Decisions, progress, and context persist across sessions, machines, and tool switches.

Setup

1. Get an API key.

Sign in with GitHub at agentstash.ai, or register headlessly:

curl -X POST https://agentstash.ai/register/agent \
  -H 'Content-Type: application/json' \
  -d '{"agent_name": "my-project"}'

The response includes your API key and a claim_url:

{
  "api_key": "sk_...",
  "claim_url": "https://agentstash.ai/auth/claim/...",
  ...
}

Save the api_key — it won't be shown again. The claim_url is a one-time link to connect a GitHub account to this key. Open it in a browser whenever you want to enable upgrades. Your API key and all stored memory carry over automatically.

2. Add to your tool's MCP config.

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "agent-stash": {
      "command": "npx",
      "args": ["-y", "@agentstash/mcp"],
      "env": {
        "AGENT_STASH_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "agent-stash": {
      "command": "npx",
      "args": ["-y", "@agentstash/mcp"],
      "env": {
        "AGENT_STASH_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Memory is scoped to your current git project automatically (detected from git remote.origin.url). Override with AGENT_STASH_PROJECT if needed.

Tools

| Tool | When to use | |------|-------------| | remember(key, value) | After a meaningful decision or architectural choice | | recall(key) | At session start to load prior context | | list_memories(prefix?) | To discover what's stored in this project | | forget(key) | To remove a stale memory | | save_progress(task, completed_steps, next_step, decisions, files_touched) | Before risky work or when context is filling up | | resume_progress() | At session start when continuing prior work | | log_event(event, details?) | To record significant actions for the audit trail | | read_log(limit?) | To see what happened in prior sessions | | find_memory(query) | To search memories by key name |

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | AGENT_STASH_API_KEY | Yes | API key from agentstash.ai | | AGENT_STASH_PROJECT | No | Override project namespace (default: git repo name) | | AGENT_STASH_URL | No | Override API URL (default: https://agentstash.ai) |

License

MIT