whitemagic-mcp 9.3.1 → 9.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +31 -16
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -14,36 +14,32 @@ This package installs and runs the official `wm` binary from the
14
14
  (checksum-verified at install time) so an MCP client can launch it
15
15
  without a manual download step.
16
16
 
17
- ## Try it without installing (hosted read-only lane)
17
+ ## Quick start (no install step)
18
18
 
19
- The evaluation lane runs at `https://mcp.whitemagic.dev/mcp`
20
- (streamable-http; keyless discovery, free evaluation keys, no SLA):
19
+ The local, full-write path straight from npm — the package downloads and
20
+ checksum-verifies the official `wm` binary on first run:
21
21
 
22
22
  ```bash
23
- claude mcp add whitemagic-mcp --transport http https://mcp.whitemagic.dev/mcp
23
+ npx -y whitemagic-mcp serve --profile curated
24
24
  ```
25
25
 
26
- The npm package remains the local, full-write path.
27
-
28
- ## Use
26
+ MCP client config:
29
27
 
30
- Point any MCP client (Claude Desktop, Cursor, Codex, Gemini CLI,
31
- opencode) at:
32
28
  ```json
33
29
  {
34
30
  "mcpServers": {
35
31
  "whitemagic": {
36
- "command": "whitemagic-mcp",
37
- "args": ["serve", "--profile", "curated"]
32
+ "command": "npx",
33
+ "args": ["-y", "whitemagic-mcp", "serve", "--profile", "curated"]
38
34
  }
39
35
  }
40
36
  }
41
37
  ```
42
38
 
43
- Or try it directly:
39
+ Or try the binary directly:
44
40
 
45
41
  ```bash
46
- npx whitemagic-mcp --version # wm 9.3.1
42
+ npx whitemagic-mcp --version # wm 9.3.3
47
43
  npx whitemagic-mcp doctor # environment health check
48
44
  ```
49
45
 
@@ -52,11 +48,30 @@ The binary is cached under `~/.cache/whitemagic/bin/<release-tag>/`
52
48
  release tag (the `v9` tag line). Pin a different release with
53
49
  `WHITEMAGIC_RELEASE`.
54
50
 
51
+ ## Try it without installing (hosted read-only lane)
52
+
53
+ The evaluation lane runs at `https://mcp.whitemagic.dev/mcp`
54
+ (streamable-http; no SLA). Free paths, no account needed:
55
+
56
+ - keyless discovery (`initialize` / `tools/list`) for directory probes;
57
+ - an anonymous free tier — 3 calls/day per client IP, no key and no header;
58
+ - instant evaluation keys at https://mcp.whitemagic.dev/keys
59
+ (50 recalls/day, email optional);
60
+ - OAuth 2.1 for MCP clients that speak it.
61
+
62
+ ```bash
63
+ claude mcp add whitemagic-mcp --transport http https://mcp.whitemagic.dev/mcp
64
+ ```
65
+
66
+ Beyond the free paths, metered calls settle per call via x402 (USDC on
67
+ Base), keyless — no account, no invoice. The npm package remains the
68
+ local, full-write path.
69
+
55
70
  ## Platforms
56
71
 
57
- Linux x86-64 (static musl), Linux arm64 (static musl), and macOS arm64 are
58
- install-gated. macOS x64 and Windows x64 binaries are published, but their
59
- install paths are not gated yet. Downloads prefer the compressed `.gz`
72
+ Linux x86-64 (static musl), Linux arm64 (static musl), macOS arm64 + x64,
73
+ and Windows x64 are install-gated (CI certifies each installer against the
74
+ published release). Downloads prefer the compressed `.gz`
60
75
  distributable when the release ships one (~58% smaller) and fall back to the
61
76
  raw binary otherwise. No asset for your platform? Build from source:
62
77
  https://github.com/lbailey94/whitemagic#install
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "whitemagic-mcp",
3
- "version": "9.3.1",
3
+ "version": "9.3.3",
4
4
  "description": "Local-first persistent memory and session continuity for AI coding agents (Claude Code, Cursor, Codex), over MCP - one static Rust binary, no telemetry by default, verifiable handoffs.",
5
5
  "license": "MIT",
6
6
  "bin": {