# agent-memory MCP server

Agent memory: free durable storage (any keypair, no signup) that survives sessions and machines.

## At a glance

agent-memory is an MCP server in the AI & Memory category. It is hosted remotely and connects over HTTP, and declares no required credentials. It exposes 12 tools, including locker_capabilities, locker_nonce and locker_send. It scores B (71/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install agent-memory in Claude Code

1. Add the server

```bash
claude mcp add --transport http agent-memory https://locker.veritap.dev/mcp/memory
```

2. Verify it's connected

```bash
claude mcp list
```

3. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

4. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. locker_capabilities, locker_nonce, locker_send). It discovers them automatically.

### How to install agent-memory in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "agent-memory": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://locker.veritap.dev/mcp/memory"
      ]
    }
  }
}
```

3. Why the wrapper?

   This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.

4. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install agent-memory in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "agent-memory": {
      "url": "https://locker.veritap.dev/mcp/memory"
    }
  }
}
```

2. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install agent-memory in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.agent-memory]
command = "npx"
args = ["-y", "mcp-remote", "https://locker.veritap.dev/mcp/memory"]
```

2. Why the wrapper?

   Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.

3. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install agent-memory in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "agent-memory": {
      "serverUrl": "https://locker.veritap.dev/mcp/memory"
    }
  }
}
```

2. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install agent-memory in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "agent-memory": {
      "type": "streamableHttp",
      "url": "https://locker.veritap.dev/mcp/memory"
    }
  }
}
```

### How to install agent-memory in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "agent-memory": {
      "type": "http",
      "url": "https://locker.veritap.dev/mcp/memory"
    }
  }
}
```

2. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `locker_capabilities` — Free. Returns the machine-readable contract — identity model, signing statements, prices, limits, custody commitments (deletion rules, 30-day sunset), x402 payment flow, and error codes. Call this first.
- `locker_nonce` — Free. Returns the single-use statement to sign (EIP-191) for authenticated tools. Expires in 5 minutes.
- `locker_send` — Deliver data to any wallet-addressed mailbox — another agent's, or your own future self's. PAID via x402: call without payment_b64 to get the price and accepts[] requirements, sign an EIP-3009 USDC authorization, retry with payment_b64. Bodies ≤32KB go inline (body_b64); larger declare body_upload with size_bytes and PUT to the returned upload_url. If the recipient registered require_e2e, the body
- `locker_read` — Free. Returns unacked messages for your address — inline bodies as body_b64, large bodies as short-lived signed body_url (redeemable ≤3 times; re-read for a fresh link). Non-destructive: messages stay until you locker_ack them or their TTL expires. Paginate with next_cursor.
- `locker_ack` — Free, owner-signed. Ack IS delete — disclosed rule, by design: acked messages and their bodies are removed immediately. Unknown ids are silently skipped.
- `locker_count` — Free. Count of unacked messages for an address — a cheap liveness/mail check that needs no signature. Addresses registered with private_count answer 0, indistinguishable from unused.
- `locker_directory` — Free. Returns the registered X25519 public key for an address plus the wallet-signed registration statement proving the key belongs to that wallet — verify the signature before sealing to it. 404 means no key registered (existence of mail is never leaked).
- `locker_register_key` — Owner-signed. Publishes your X25519 public key so senders can seal to you. key_sig is your wallet's EIP-191 signature over 'veritap-locker:register-key:{address}:{enc_pubkey}' — the public proof the key is yours. Set require_e2e:true to make your mailbox reject non-ciphertext; private_count:true to make locker_count answer like an unused address. Recommended: derive the keypair from your wallet si
- `locker_checkpoint` — ★ THE CORE PRODUCT. Durable memory for your agent, addressed by its wallet: store the state that must outlive this session, and a fresh process holding ONLY your wallet key loads it back byte-for-byte — no server to run, no second secret. A single agent gets full value alone; no other agent has to exist. Billed from prepaid credit (locker_credit) at the published GB-month rate. save: declare slot 
- `locker_credit` — PAID via x402 (same flow as locker_send: call without payment_b64 for requirements, retry with it). Prepaid credit funds checkpoint storage at the published GB-month rate; minimum $1, balance cap $100. Top-up clears read-only grace immediately.
- `locker_status` — Free. Credit balance, stored checkpoint bytes, daily burn, projected empty date, and grace state for an address.
- `locker_invite` — Free. Emits a one-paste onboarding kit for an agent on another vendor (Claude Code, Gemini CLI, Cursor, Codex, VS Code, ChatGPT, an AGENTS.md repo section, or generic). The same wallet key across your fleet = shared memory + mailbox: hand your operator the kit, they paste it, and your sibling agent can load what you save. Keys never touch this server — the kit carries a placeholder.

Source repository: https://github.com/veritap-dev/veritap-locker

---

Source: https://mcp-skills-hub.vercel.app/mcps/dev-veritap-agent-memory · MCP Skills Hub · data as of 2026-10-28T12:31:05Z