ChainMemory MCP Server

by chaelynetio.github.chaelynet/chainmemoryv2.9.1

Verifiable, portable AI memory. Optional vault: encrypted on your machine, 12 words only you hold.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install ChainMemory MCP server

claude mcp add chainmemory -e CHAINMEMORY_API_KEY='<chainmemory-api-key>' -e CHAINMEMORY_SEED_PHRASE='<chainmemory-seed-phrase>' -e AICHAIN_KEY='<aichain-key>' -- npx -y chainmemory-mcp

{
  "mcpServers": {
    "chainmemory": {
      "command": "npx",
      "args": [
        "-y",
        "chainmemory-mcp"
      ],
      "env": {
        "CHAINMEMORY_API_KEY": "<chainmemory-api-key>",
        "CHAINMEMORY_SEED_PHRASE": "<chainmemory-seed-phrase>",
        "AICHAIN_KEY": "<aichain-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "chainmemory": {
      "command": "npx",
      "args": [
        "-y",
        "chainmemory-mcp"
      ],
      "env": {
        "CHAINMEMORY_API_KEY": "<chainmemory-api-key>",
        "CHAINMEMORY_SEED_PHRASE": "<chainmemory-seed-phrase>",
        "AICHAIN_KEY": "<aichain-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "chainmemory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "chainmemory-mcp"
      ],
      "env": {
        "CHAINMEMORY_API_KEY": "<chainmemory-api-key>",
        "CHAINMEMORY_SEED_PHRASE": "<chainmemory-seed-phrase>",
        "AICHAIN_KEY": "<aichain-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "chainmemory": {
      "command": "npx",
      "args": [
        "-y",
        "chainmemory-mcp"
      ],
      "env": {
        "CHAINMEMORY_API_KEY": "<chainmemory-api-key>",
        "CHAINMEMORY_SEED_PHRASE": "<chainmemory-seed-phrase>",
        "AICHAIN_KEY": "<aichain-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
CHAINMEMORY_API_KEY	yes	yes	ChainMemory API key. REQUIRED for every tool except chainmemory_seal. Get one at https://faucet.chainmemory.ai
CHAINMEMORY_SEED_PHRASE	—	yes	12-word BIP-39 phrase for the blind vault. Optional: without it the server works exactly as before. With it, sealed:true encrypts a memory on your machine and computes its search vector here, so sealed memories can still be found, and searches send the query's vector instead of its text. Generate one with chainmemory_new_seed. It never leaves your machine and cannot be recovered.
CHAINMEMORY_API_BASE	—	—	API base URL (default: https://api.chainmemory.ai)
CHAINMEMORY_MODELS_DIR	—	—	Folder for the 45 MB search model used with the blind vault (default: ~/.chainmemory/models). Downloaded once from models.chainmemory.ai and checked against its SHA-256 anchored on ChainMemory's chain.
AICHAIN_KEY	—	yes	NOT NEEDED for normal use — leave it empty. Only the chainmemory_seal tool reads it, to sign a contract call yourself instead of letting the API anchor the memory (which chainmemory_remember already does). If you do set it, it is a wallet private key: use a dedicated wallet holding only a few AIC, never your main one. No other tool uses it.
AICHAIN_RPC	—	—	RPC endpoint used only by chainmemory_seal (default: https://rpc.chainmemory.ai). Leave it empty unless you set AICHAIN_KEY.

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-07 · 2d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-10-07 · 2d ago · official registry · v2.9.1

FAQ

›How do I install the ChainMemory MCP server in Claude Code?

Run: claude mcp add chainmemory -e CHAINMEMORY_API_KEY='<chainmemory-api-key>' -e CHAINMEMORY_SEED_PHRASE='<chainmemory-seed-phrase>' -e AICHAIN_KEY='<aichain-key>' -- npx -y chainmemory-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does ChainMemory require an API key?

Yes. It expects CHAINMEMORY_API_KEY, CHAINMEMORY_SEED_PHRASE, AICHAIN_KEY, of which 3 are secrets.

›Can I use ChainMemory as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is ChainMemory in the official MCP registry?

Yes, as io.github.chaelynet/chainmemory.