# WhiteMagic setup guide

> Local MCP setup for Claude Code, Claude Desktop, Cursor, Codex, VS Code, opencode, Antigravity, Devin Desktop, and any generic MCP client. One static binary, no account, no cloud service.

Full guide: https://www.whitemagic.dev/whitemagic/guide

## Install

```bash
curl -fsSL https://www.whitemagic.dev/install.sh?ref=guide-md | sh
```

## Connect

- `wm connect` — detect and wire every supported client in one command
- `wm setup <client>` — configure a single client
- `wm serve` — manual local MCP endpoint (stdin/stdout)

## Verify

- `wm --version` — prints the installed version
- `wm selftest` — end-to-end invariants
- `wm grimoire` — full readiness walkthrough

## Machine surfaces

- MCP server card: https://www.whitemagic.dev/.well-known/mcp/server-card.json
- Tool manifest: https://www.whitemagic.dev/api/manifest.json
- A2A agent card: https://www.whitemagic.dev/.well-known/agent.json
- Full context: https://www.whitemagic.dev/llms-full.txt

Repository: https://github.com/lbailey94/whitemagic (MIT)