Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Reclaim developer tools

Add to Claude Code

Installation and Claude Code marketplace for the Reclaim MCP server — the tools that helps you use Reclaim Protocol to let your app verify data points about its users (a follower count, an account balance, an order history). 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.

The server itself is published to npm as @reclaimprotocol/agent (bin: reclaim-mcp-server); this repo carries the Claude Code plugin/marketplace and the install instructions for every client.

Prerequisites

  • Node ≥ 20 — works best on a current LTS release (22 or 24).

The first time you run a proof, the server downloads the ZK circuit files it needs (~280 MB) — allow a moment for that first proof. The download is deferred to first proof on purpose (not an install step), so the MCP server itself starts immediately.

It runs as a stdio MCP server. Point any MCP-capable agent at this command:

npx -y --package=@reclaimprotocol/agent reclaim-mcp-server

Claude Code

install the plugin from the marketplace:

claude plugin marketplace add reclaimprotocol/developer-tools
claude plugin install reclaim@reclaim

Prefer this over the manual claude mcp add below unless you have a specific reason not to.

Advanced / fallback — add the MCP server directly (skip if you used the plugin above):

# `-s user` installs this for your user
claude mcp add reclaim -s user -- npx -y --package=@reclaimprotocol/agent reclaim-mcp-server

…or add it to .mcp.json yourself:

{
  "mcpServers": {
    "reclaim": {
      "command": "npx",
      "args": ["-y", "--package=@reclaimprotocol/agent", "reclaim-mcp-server"]
    }
  }
}

If you are using Claude desktop, then fully quit and reopen it (a window close is not enough) so it re-reads the config and starts the server.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "reclaim": {
      "command": "npx",
      "args": ["-y", "--package=@reclaimprotocol/agent", "reclaim-mcp-server"]
    }
  }
}

opencode

Add to opencode.json (project) or ~/.config/opencode/opencode.json (global):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "reclaim": {
      "type": "local",
      "command": ["npx", "-y", "--package=@reclaimprotocol/agent", "reclaim-mcp-server"],
      "enabled": true
    }
  }
}

Codex

# 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):

[mcp_servers.reclaim]
command = "npx"
args = ["-y", "--package=@reclaimprotocol/agent", "reclaim-mcp-server"]

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:

{
  "mcpServers": {
    "reclaim": {
      "command": "npx",
      "args": ["-y", "--package=@reclaimprotocol/agent", "reclaim-mcp-server"]
    }
  }
}

Optional environment

Defaults target the production old-devtools backend, so no env is needed for the common case. To override, add an env block (or environment in opencode) to the config above:

"env": {
  "USE_OLD_DEVTOOLS": "true",
  "RECLAIM_OLD_API_URL": "https://devapi.reclaimprotocol.org"
}

For builder mode (USE_OLD_DEVTOOLS=false) and the full env-var list, see the @reclaimprotocol/agent package docs.

Using it from your agent

The MCP server is all you need — it ships a how_it_works tool that returns the full capture → prove → publish guide (login detection, choosing auth-bound endpoints, OPRF decisions, troubleshooting). Have your agent call how_it_works first, then just ask in plain language, e.g.:

"Use Reclaim to create a provider that proves my GitHub follower count."

The agent orchestrates authentication, Chrome capture, provider synthesis, replay, the zkTLS proof, and publishing for you. Your only manual steps are signing in when the browser windows open and confirming the value you want to prove.

Maintaining

The plugin runs the published @reclaimprotocol/agent via npx, so the version shown in the marketplace/plugin manifests should track that package. To sync it (requires Node on your PATH):

node scripts/sync-version.ts          # copy the latest @reclaimprotocol/agent version from npm
node scripts/sync-version.ts 0.2.0    # or set an explicit version

It rewrites the version fields in .claude-plugin/marketplace.json (marketplace metadata + the plugin entry) and reclaim/.claude-plugin/plugin.json, preserving formatting.

About

Marketplace & installation information of MCP server for agents

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages