@reclaimprotocol/agent 0.1.9 → 0.1.10

package/README.md

@@ -1,6 +1,8 @@
 # @reclaimprotocol/agent
 
-Chrome-CDP + zkTLS provider-authoring tools. The agent captures network traffic from a browser, synthesizes Reclaim provider definitions from it (`contains` matchers + `jsonPath` / `xPath` / `regex` redactions), runs a local replay diagnostic, and produces a verified attestor proof via `@reclaimprotocol/attestor-core`.
+Reclaim Protocol lets your app verify **data points** about its users — a follower count, an account balance, an order history. This package gives your AI coding agent the tools to **find, build, test and fix the _data verification providers_** (the recipes that verify a data point) by inspecting and replaying captured requests, checking sessions, evaluate proofs, publishing updates, and much more.
+
+Under the hood it's Chrome-CDP + zkTLS provider-authoring tooling: it captures network traffic from a browser, synthesizes provider definitions from it (`contains` matchers + `jsonPath` / `xPath` / `regex` redactions), runs a local replay diagnostic, and produces a verified attestor proof via `@reclaimprotocol/attestor-core`.
 
 This package **is** the Reclaim MCP server (bin: `reclaim-mcp-server`). It depends on `@reclaimprotocol/client` for the typed HTTP client and registers the provider-authoring tools below alongside the backend-facing tools (credentials, publishing) in a single MCP surface. A standalone entry (`src/index.ts`) re-exports the client SDK plus `buildAgentTools` for embedding.
 
@@ -18,122 +20,18 @@ npx -y --package=@reclaimprotocol/agent reclaim-mcp-server
 
 > The `--package=` (short form `-p`) flag selects the `reclaim-mcp-server` binary from the package. We use the long `--package=` form throughout because the short `-p` collides with the `-p`/`--print` flag of some agent CLIs (notably `claude mcp add`), which silently swallows the command. Prefer a global install? Run `npm i -g @reclaimprotocol/agent` and use `reclaim-mcp-server` directly as the `command` (drop the `npx` wrapper and its `args`).
 
-### Claude Code
-
-**Recommended — install the plugin from the marketplace** (bundles this MCP server; no `claude mcp add` and no `-p` collision to worry about — the server's `how_it_works` tool serves the authoring guide on demand):
-
-```
-/plugin marketplace add reclaimprotocol/builder
-/plugin install reclaim@reclaim
-```
-
-This is the preferred path — prefer it over the manual `claude mcp add` below unless you have a specific reason not to (e.g. you're pinning a local build).
-
-**Advanced / fallback — add the MCP server directly** (skip if you used the plugin above):
-
-```bash
-# project scope → writes .mcp.json; add `-s user` for a global install
-claude mcp add reclaim -- npx -y --package=@reclaimprotocol/agent reclaim-mcp-server
-```
-
-…or add it to `.mcp.json` yourself:
-
-```json
-{
-  "mcpServers": {
-    "reclaim": {
-      "command": "npx",
-      "args": ["-y", "--package=@reclaimprotocol/agent", "reclaim-mcp-server"]
-    }
-  }
-}
-```
-
-### Claude Desktop (macOS / Windows app)
-
-Claude Desktop is the standalone consumer app — **separate from Claude Code**, and it does **not** support the plugin marketplace (`/plugin …` is Claude Code only). Configure the MCP server manually via its config file:
-
-- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
-
-Edit it (via **Settings → Developer → Edit Config**, or open the file directly) and add:
-
-```json
-{
-  "mcpServers": {
-    "reclaim": {
-      "command": "npx",
-      "args": ["-y", "--package=@reclaimprotocol/agent", "reclaim-mcp-server"]
-    }
-  }
-}
-```
-
-Then **fully quit and reopen** Claude Desktop (a window close is not enough) so it re-reads the config and starts the server.
-
-> **Node must be on the app's PATH.** Claude Desktop launches the server as a subprocess using the environment it inherits at startup — it does **not** bundle Node. If the server shows as failed, either install Node ≥ 20 and relaunch, or set `"command"` to an **absolute path** to `npx`/`node` (find it with `which npx`), since GUI-launched apps sometimes get a minimal PATH. Chrome capture works the same as anywhere else — see [Chrome / CDP](#platform-notes).
-
-### Cursor
+### Installing into your coding agent
 
-Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project):
+Copy-paste setup for **Claude Code** (plugin marketplace), **Claude Desktop**, **Cursor**, **opencode**, **Codex**, **Windsurf**, **VS Code**, **Cline** and other MCP clients lives in the public **[reclaimprotocol/developer-tools](https://github.com/reclaimprotocol/developer-tools)** repo — that's where the Claude Code plugin/marketplace is published.
 
-```json
-{
-  "mcpServers": {
-    "reclaim": {
-      "command": "npx",
-      "args": ["-y", "--package=@reclaimprotocol/agent", "reclaim-mcp-server"]
-    }
-  }
-}
-```
-
-### opencode
-
-Add to `opencode.json` (project) or `~/.config/opencode/opencode.json` (global):
+The quickest path, in Claude Code:
 
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "mcp": {
-    "reclaim": {
-      "type": "local",
-      "command": ["npx", "-y", "--package=@reclaimprotocol/agent", "reclaim-mcp-server"],
-      "enabled": true
-    }
-  }
-}
-```
-
-### Codex
-
-```bash
-# writes ~/.codex/config.toml
-codex mcp add reclaim -- npx -y --package=@reclaimprotocol/agent reclaim-mcp-server
 ```
-
-…or add it to `~/.codex/config.toml` yourself (Codex uses TOML, not JSON):
-
-```toml
-[mcp_servers.reclaim]
-command = "npx"
-args = ["-y", "--package=@reclaimprotocol/agent", "reclaim-mcp-server"]
+/plugin marketplace add reclaimprotocol/developer-tools
+/plugin install reclaim@reclaim
 ```
 
-### Antigravity, Windsurf, VS Code, Cline & other MCP clients
-
-These all use the standard `mcpServers` shape — add a server through the app's MCP settings (or its `mcp`/`mcpServers` config file) with:
-
-```json
-{
-  "mcpServers": {
-    "reclaim": {
-      "command": "npx",
-      "args": ["-y", "--package=@reclaimprotocol/agent", "reclaim-mcp-server"]
-    }
-  }
-}
-```
+For any other client, point it at the stdio command above (`npx -y --package=@reclaimprotocol/agent reclaim-mcp-server`) — see the developer-tools README for per-client config and the Claude Desktop / GUI-app notes.
 
 ### Optional environment
 

package/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "@reclaimprotocol/agent",
 	"title": "Reclaim Agent",
-	"version": "0.1.9",
-	"description": "Reclaim Protocol agent — SDK, CLI, and MCP server in one package. SDK + CLI talk to the builder backend; MCP server adds Chrome CDP capture, provider synthesis, replay, and zkTLS proof.",
+	"version": "0.1.10",
+	"description": "Reclaim Protocol's tools for agents — Reclaim Protocol lets your app verify **data points** about its users — a follower count, an account balance, an order history. This package gives your AI coding agent the tools to **find, build, test and fix the _data verification providers_** (the recipes that verify a data point) by inspecting and replaying captured requests, checking sessions, evaluate proofs, publishing updates, and much more.",
 	"type": "module",
 	"main": "./lib/index.js",
 	"types": "./lib/index.d.ts",