@neruva/mcp 0.23.0 → 0.23.1

package/README.md

@@ -18,11 +18,13 @@ We benchmarked Neruva against the 2026 agent-memory field and made the hook **fa
 
 **What changed:** `@neruva/mcp` 0.23 bundles `neruva-record-hook` as a **native Rust binary** (~145-340 KB per platform; all 6 of Win/Mac/Linux × amd64/arm64). The hook talks to a long-lived Python daemon over TCP localhost. The daemon holds a warm `httpx` connection pool to `api.neruva.io` plus an in-memory TTL cache so consecutive prompt/tool-call hooks within a turn skip the network entirely.
 
-**Install (zero extra steps over 0.22):**
+**Install:**
 
 ```bash
-# 1. Your existing MCP setup — already installs the binary
-npx -y @neruva/mcp@latest
+# 1. MCP server. The -p ... neruva-mcp form is REQUIRED because 0.23+
+#    ships two bins (neruva-mcp + neruva-record-hook) and npx can't
+#    auto-pick when a package exposes more than one.
+npx -y -p @neruva/mcp@latest neruva-mcp
 
 # 2. The Python daemon comes from neruva-record (pip)
 pip install neruva-record
@@ -31,6 +33,19 @@ neruva-record install     # writes ~/.claude/settings.json hooks
 # That's it. Restart Claude Code.
 ```
 
+Your `~/.claude.json` mcpServers entry should be:
+
+```json
+{
+  "neruva": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "-p", "@neruva/mcp@latest", "neruva-mcp"],
+    "env": { "NERUVA_API_KEY": "nv_..." }
+  }
+}
+```
+
 On install, `@neruva/mcp` exposes `neruva-record-hook` on your PATH (a tiny Node wrapper that exec's the platform-native binary). `neruva-record install` wires it into `~/.claude/settings.json` for UserPromptSubmit + PostToolUse. The daemon auto-spawns on first SessionStart and stays warm for 30 minutes after the last hook fire (`NERUVA_DAEMON_IDLE_S` override).
 
 **For max speed**, you can skip the Node wrapper entirely by pointing `settings.json` directly at the bundled binary path:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@neruva/mcp",
-  "version": "0.23.0",
-  "description": "MCP server for Neruva agent memory + reasoning substrate. v0.23 BUNDLES neruva-record-hook native binary (Rust, ~145-340KB) for all 6 platforms (Win/Mac/Linux x amd64/arm64). Hook talks to long-lived Python daemon over TCP localhost, daemon holds warm httpx pool + TTL cache: cache-hit p95 ~80ms, warm avg 167ms -- faster than Mem0 (200ms p95) with full cognitive surface (5 KG engines + Pearl do-operator + HD analogy + CBR + ToM + EFE planning + replay). v0.22 added AUTO-PILOT (agent_route_intent_prompt + agent_reflect_prompt + auto-extract on records_ingest). Plus typed Records, 5-engine KG, federated agent_remember/recall/context, counterfactual rollouts, rule induction, replay, code_kg_* navigation, .neruva V3 container. Pattern-C throughout: substrate stays $0/call.",
+  "version": "0.23.1",
+  "description": "MCP server for Neruva agent memory + reasoning substrate. INSTALL: npx -y -p @neruva/mcp@latest neruva-mcp (the -p ... bin form is required because the package ships two bins: neruva-mcp + neruva-record-hook). v0.23 BUNDLES neruva-record-hook native binary (Rust, ~145-340KB) for all 6 platforms (Win/Mac/Linux x amd64/arm64). Hook talks to long-lived Python daemon over TCP localhost, daemon holds warm httpx pool + TTL cache: cache-hit p95 ~80ms, warm avg 167ms -- faster than Mem0 (200ms p95) with full cognitive surface (5 KG engines + Pearl do-operator + HD analogy + CBR + ToM + EFE planning + replay). v0.22 added AUTO-PILOT (agent_route_intent_prompt + agent_reflect_prompt + auto-extract on records_ingest). Plus typed Records, 5-engine KG, federated agent_remember/recall/context, counterfactual rollouts, rule induction, replay, code_kg_* navigation, .neruva V3 container. Pattern-C throughout: substrate stays $0/call.",
   "license": "MIT",
   "type": "module",
   "bin": {