io.github.lbailey94/whitemagic-mcp MCP Server

The io.github.lbailey94/whitemagic-mcp server provides local-first memory and session continuity for AI coding agents via MCP. It runs as one static Rust binary with no cloud service and no telemetry, and is distributed under MIT.

🛠️ Key Features

Local-first memory and session continuity for AI coding agents
MCP-based integration
One static Rust binary
No telemetry and no cloud service
MIT license

🚀 Use Cases

Keep coding-agent context across sessions when used through an MCP client
Support MCP clients such as Claude Desktop, Cursor, Codex, Gemini CLI, or opencode

⚡ Developer Benefits

MCP clients can launch the server without manual binary download steps
Installs/runs the official wm binary from GitHub releases
Checksum-verified at install time

⚠️ Limitations

The provided description does not specify available tools, configuration options, or operational constraints beyond local-first delivery.

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.

bash

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

MCP client config:

json

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

Or try the binary directly:

bash

npx -y whitemagic-mcp@next selftest   # invariant self-test + host diagnostics
npx -y whitemagic-mcp@next --version  # wm 10.4.0
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 whitemagic-mcp@10.4.0, 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.

bash

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

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

cold_scan_limit	integer	optional	Maximum cold records to scan when include_cold is set (default 2048)
galaxy	string	optional	Galaxy filter (optional; default: search all memory galaxies, results labeled; "all" is accepted as an alias for the unfiltered default)
include_cold	boolean	optional	Opt-in unranked cold recovery (no thaw). Trust/importance floors apply; BM25 floors do not apply to unscored recovery. Search content is scrubbed navigation capped at 8192 characters; read by id/galaxy for the exact original.
limit	integer	optional	Maximum results (default 10; must be >= 1)
min_importance	number	optional	Minimum memory importance (0-1)
min_score	number	optional	Absolute BM25 score floor
min_score_ratio	number	optional	Relative floor: reject hits below this fraction of the top score
min_trust	number	optional	Minimum source_trust (0-1): drop results below this trust floor
query	string	required	Full-text query
since	string	optional	Inclusive lower time bound: RFC3339 ('2026-02-01T00:00:00Z') or epoch seconds
time_basis	string	optional	Time basis for since/until: 'recorded' (created_at, default) or 'event' (event_time, falling back to created_at when unset)
until	string	optional	Inclusive upper time bound: RFC3339 or epoch seconds

galaxy	string	optional	Galaxy containing the memory (default codex)
id	string	required	Memory UUID

exclude_tags	array	optional	Drop memories carrying any of these tags
galaxy	string	optional	Galaxy to list (default codex)
limit	integer	optional	Maximum entries (default 20)
offset	integer	optional	Skip this many matching entries before returning (default 0)

cold_scan_limit	integer	optional	Maximum cold records to scan when include_cold is set (default 2048)
galaxy	string	optional	Galaxy filter (optional; default: search all memory galaxies, results labeled; "all" is accepted as an alias for the unfiltered default)
include_cold	boolean	optional	Opt-in unranked cold recovery (no thaw). Trust/importance floors apply; BM25 floors do not apply to unscored recovery. Search content is scrubbed navigation capped at 8192 characters; read by id/galaxy for the exact original.
limit	integer	optional	Maximum results (default 10; must be >= 1)
min_importance	number	optional	Minimum memory importance (0-1)
min_score	number	optional	Absolute BM25 score floor
min_score_ratio	number	optional	Relative floor: reject hits below this fraction of the top score
min_trust	number	optional	Minimum source_trust (0-1): drop results below this trust floor
query	string	required	Full-text query
since	string	optional	Inclusive lower time bound: RFC3339 ('2026-02-01T00:00:00Z') or epoch seconds
time_basis	string	optional	Time basis for since/until: 'recorded' (created_at, default) or 'event' (event_time, falling back to created_at when unset)
until	string	optional	Inclusive upper time bound: RFC3339 or epoch seconds

WhiteMagic — governed local memory for agent continuity

io.github.lbailey94/whitemagic-mcp MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

wm

memory.search

memory.read

memory.list

memory.hybrid_recall

session.continuity

memory.revisions

receipts.verify

memory.count

memory.stats

memory.tags

memory.aggregate

memory.associations

memory.batch_read

memory.query

memory.filter

memory.nearby

memory.vector.search

session.list

session.recall

session.replay

gnosis.status

gnosis.explain

memory.search_batch

whitemagic-mcp

Quick start (no install step)

Try it without installing (hosted read-only lane)

Platforms

Privacy

Install

Related servers

current_session_id	string	optional	Session to exclude (optional)
include_briefing_text	boolean	optional	Include the ready-to-inject briefing.text block (default false; adds bytes outside the turns budget)
max_content_bytes	integer	optional	Per-turn content cap in bytes (256-262144, default 8192)
max_response_bytes	integer	optional	Turns budget in bytes (256-262144, default 49152)
n	integer	optional	Number of prior turns (default 10)
since	string	optional	Time-range floor: epoch seconds, RFC 3339, or YYYY-MM-DD
until	string	optional	Time-range ceiling: epoch seconds, RFC 3339, or YYYY-MM-DD

action	string	optional	Action: list (default) \| verify
galaxy	string	optional	Galaxy (default: codex)
id	string	required	Memory UUID to inspect

bundle	object	optional	Inline bundle to verify (alternative to id)
id	string	optional	Receipt task id (UUID or urn:uuid:)
require_anchor	boolean	optional	Fail-closed: without an anchor the verdict is PROVISIONAL
variant	string	optional	Receipt variant (default original)

direction	string	optional	Direction: from \| to \| both (default: both)
id	string	required	Memory UUID to inspect

created_after	string	optional	Filter: only memories created at or after this RFC 3339 timestamp (e.g. 2026-08-01T00:00:00Z)
created_before	string	optional	Filter: only memories created at or before this RFC 3339 timestamp
galaxy	string	optional	Galaxy to query (default codex)
limit	integer	optional	Maximum entries (default 50)
max_importance	number	optional	Filter: maximum importance (0-1)
min_importance	number	optional	Filter: minimum importance (0-1)
query	string	optional	Case-insensitive substring filter over content (literal match). For tokenized, ranked full-text retrieval use memory.search
tags	array	optional	Filter: memories with all of these tags

embedding	array	optional	Raw embedding vector (alternative to memory_id)
galaxy	string	optional	Galaxy filter (optional)
limit	integer	optional	Maximum results (default 10)
memory_id	string	required	Memory UUID whose stored embedding is the query

sequence	integer	optional	Filter by start sequence number
session_id	string	optional	Filter by session UUID
title	string	optional	Filter by title substring
type	string	optional	Filter by session type

cursor	string	optional	Lossless mode opaque placement cursor
include_superseded	boolean	optional	Also return turns replaced via supersedes (default false).
max_wire_bytes	integer	optional	Lossless mode serialized JSON ceiling (1024-49152)
min_importance	number	optional	Selective mode floor (default 0.7)
mode	string	optional	full \| selective \| progressive \| lossless (default full)
n	integer	optional	Maximum turns (default 50)
page_size	integer	optional	Lossless mode records per page (1-64, default 16)
session_id	string	optional	Target session (required explicit UUID for lossless; otherwise default most recent)
since	string	optional	Time-range floor: epoch seconds, RFC 3339, or YYYY-MM-DD
token_budget	integer	optional	Progressive mode token budget (default 2000)
turn_types	array	optional	Selective mode: turn types to keep
until	string	optional	Time-range ceiling: epoch seconds, RFC 3339, or YYYY-MM-DD

args_hash	string	optional	Hash of the arguments under evaluation
has_purpose	boolean	optional	Claim: the invocation carries a purpose
is_network	boolean	optional	Claim: the invocation uses the network
is_spawn	boolean	optional	Claim: the invocation spawns a process
is_write	boolean	optional	Claim: the invocation writes
tool_name	string	optional	Tool name to explain

queries	array	required	List of query strings to search (1 to 10 queries).
limit_per_query	integer	optional	Max results per query (default 5, max 20).