Indelible MCP Server

Blockchain-backed memory for Claude Code. Save your AI conversations permanently on BSV via a federated mesh of SPV bridges.

Quick Start

npm install -g indelible-mcp
indelible-mcp setup

Setup

1. Install & Create Wallet

npm install -g indelible-mcp
indelible-mcp setup

This generates a BSV keypair locally (your private key never leaves your machine) and registers with the Indelible server.

2. Fund Your Wallet

Send a small amount of BSV to the address shown after setup. Any BSV wallet works (HandCash, RelayX, etc.).

3. Add MCP Config to Claude Code

Run indelible-mcp --show-config to get your config, or add this to your Claude Code settings.json:

{
  "mcpServers": {
    "indelible": {
      "command": "indelible-mcp"
    }
  }
}

Usage

Once configured, just talk to Claude Code naturally:

• "Save this session to blockchain" - saves your conversation
• "Load my previous context" - restores past sessions
• "Delta save" - saves only new messages (cheaper, faster)

Auto-Save & Auto-Restore

Indelible automatically saves before Claude Code compacts your context, and restores your sessions after compaction. Nothing is lost.

CLI Commands

indelible-mcp setup              Generate wallet & register
indelible-mcp setup --migrate    Derive API key from existing wallet
indelible-mcp save               Save current session
indelible-mcp save --summary XYZ Save with custom summary
indelible-mcp load               Load context from blockchain
indelible-mcp load --sessions=5  Load N sessions
indelible-mcp status             Show account status
indelible-mcp hook pre-compact   Pre-compaction save hook
indelible-mcp hook post-compact  Post-compaction restore hook

How It Works

1. Your conversation is encrypted locally with your WIF key
2. A minimal OP_RETURN transaction is built containing only {protocol, encrypted} — no metadata leaks
3. The signed transaction is broadcast via Indelible's federation bridges
4. Session metadata is automatically indexed across all federation bridges for fast retrieval
5. Your private key never leaves your machine

Federation

Indelible uses a multi-seed architecture — your saves and loads automatically try multiple federation bridges. If one bridge is down, the next picks up. No single point of failure.

Bridges sync session metadata via SessionRelay (WebSocket peer-to-peer), so all your sessions are available from any bridge in the mesh. The web app and CLI read from bridges first, with blockchain fallback.

The federation mesh is powered by Relay Federation.

Security

• Zero-knowledge encryption - your WIF-derived AES-256-GCM key encrypts all data before it touches the network
• Privacy-hardened transactions - OP_RETURN contains only {protocol, encrypted} — no plaintext metadata on-chain
• Self-sovereign keys - generated locally with @bsv/sdk, never transmitted
• Immutable storage - once on BSV, your data cannot be altered or deleted

Learn More

indelible.one