WhiteMagic — governed local memory for agent continuity

Name: WhiteMagic — governed local memory for agent continuity
Author: lbailey94

Remote

whitemagic.devMemory & Knowledge0Updated today

Repository Visit website

About WhiteMagic — governed local memory for agent continuity

WhiteMagic is a local-first memory and session-continuity MCP server for AI coding agents. It stores memory on the user's machine and can sign handoffs as verifiable continuity receipts.

Key features

01Persistent agent memory
02Session continuity and handoffs
03Signed continuity receipts
04Local-first storage
05Static Rust binary with no default telemetry

Use cases

01Preserving context between coding sessions
02Handing off agent state with a verifiable receipt
03Keeping agent memory on a local machine

MCP support

An MCP server that gives MCP clients access to persistent memory and session continuity. The hosted evaluation endpoint is read-only; the local binary provides the full-write path.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://mcp.whitemagic.dev/mcp

Copy install command

Claude CodeTerminalclaude mcp add --transport http lbailey94-whitemagic https://mcp.whitemagic.dev/mcp

Cursor.cursor/mcp.json{"mcpServers":{"lbailey94-whitemagic":{"type":"http","url":"https://mcp.whitemagic.dev/mcp"}}}Open in Cursor

VS Code.vscode/mcp.json{"servers":{"lbailey94-whitemagic":{"type":"http","url":"https://mcp.whitemagic.dev/mcp"}}}Open in VS Code

Claude Desktopclaude_desktop_config.json{"mcpServers":{"lbailey94-whitemagic":{"type":"http","url":"https://mcp.whitemagic.dev/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"lbailey94-whitemagic":{"serverUrl":"https://mcp.whitemagic.dev/mcp"}}}

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Packages

npmwhitemagic-mcp10.6.1stdio

ocidocker.io/lbailey94/whitemagic:10.6.1stdio

Tools

Parameter	Type	Required	Description
args	object	No	Arguments to pass through to the target tool.
route	string	No	Explicit tool name for direct dispatch (e.g. 'memory.create', 'tools.list').
thought	string	No	Natural language input describing what to do. Auto-routes to the best-matching tool via TF-IDF NLU classification.

Details

From the project README

whitemagic-mcp

Persistent memory and session continuity for AI coding agents, over MCP. WhiteMagic is one static Rust binary — local-first, no telemetry by default, MIT — and every handoff can be signed as a verifiable continuity receipt.

Works with Claude Code, Claude Desktop, Cursor, Codex, VS Code, opencode, Antigravity, and Devin Desktop — per-client configs: https://www.whitemagic.dev/whitemagic/guide

This package installs and runs the official wm binary from the GitHub releases (checksum-verified at install time) so an MCP client can launch it without a manual download step.

Quick start (no install step)

The local, full-write path straight from npm — the package downloads and checksum-verifies the official wm binary on first run. Use the @next dist-tag: npm @latest still resolves the stable v9 line.

npx -y whitemagic-mcp@next serve --profile curated

MCP client config:

{
  "mcpServers": {
    "whitemagic": {
      "command": "npx",
      "args": ["-y", "whitemagic-mcp@next", "serve", "--profile", "curated"]
    }
  }
}

Or try the binary directly:

npx -y whitemagic-mcp@next selftest   # invariant self-test + host diagnostics
npx -y whitemagic-mcp@next --version  # wm 10.6.1
npx -y whitemagic-mcp@next doctor     # environment health check

The binary is cached under ~/.cache/whitemagic/bin/<release-tag>/ (respects XDG_CACHE_HOME). @next tracks the v10 line; unpinned @latest installs fetch the stable v9 line instead. Pin the exact release with [email protected], or override the release tag with WHITEMAGIC_RELEASE.

Try it without installing (hosted read-only lane)

The evaluation lane runs at https://mcp.whitemagic.dev/mcp (streamable-http; no SLA). Free paths, no account needed:

keyless discovery (initialize / tools/list) for directory probes;
an anonymous free tier — 3 calls/day per client IP, no key and no header;
instant evaluation keys at https://mcp.whitemagic.dev/keys (50 recalls/day, email optional);
OAuth 2.1 for MCP clients that speak it.

claude mcp add whitemagic-mcp --transport http https://mcp.whitemagic.dev/mcp

Beyond the free paths, metered calls settle per call via x402 (USDC on Base), keyless — no account, no invoice. The npm package remains the local, full-write path.

Platforms

Linux x86-64 (static musl), Linux arm64 (static musl), macOS arm64 + x64, and Windows x64 are install-gated (CI certifies each installer against the published release). Downloads prefer the compressed .gz distributable when the release ships one (~58% smaller) and fall back to the raw binary otherwise. No asset for your platform? Build from source: https://github.com/lbailey94/whitemagic#install

Privacy

Your memory store lives on your machine. wm does not phone home; this installer contacts GitHub releases only to download the binary and its checksum. See PRIVACY_POLICY.md.

mcp-name: io.github.lbailey94/whitemagic-mcp

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.