@reclaimprotocol/mcp

MCP server that adds Reclaim Protocol verification to any project through Claude Code. Auto-detects your framework, writes API routes, generates frontend components, and wires up the complete proof verification flow.

Quick Start

npx @reclaimprotocol/mcp

Add to Claude Code

claude mcp add reclaim -- npx -y @reclaimprotocol/mcp

Set your app secret as an environment variable:

export RECLAIM_APP_SECRET=your-app-secret

Then ask Claude:

Integrate Reclaim verification into this project. App ID is 0x..., Provider ID is d504....

Parameters

| Parameter | Required | Source | Description | |-----------|----------|--------|-------------| | appId | Yes | Passed directly | Application ID from dev.reclaimprotocol.org | | appSecret | Yes | RECLAIM_APP_SECRET env var or passed as parameter | Application secret. Prefer the env var — the secret is never logged or returned in tool output. | | providerId | Yes | Passed directly | Data source to verify (GitHub, Google, etc.) from dev.reclaimprotocol.org | | projectDir | No | Defaults to cwd | Absolute path to project root |

Get all three credentials at dev.reclaimprotocol.org.

What It Does

1. Detects your stack — Next.js (App Router / Pages Router), Express, React, Vue, SvelteKit, Nuxt, Fastify, Hono, or plain Node.js
2. Writes backend routes — Proof request initialization endpoint + callback endpoint with verifyProof()
3. Generates frontend UI — Verification component with QR code display and status handling
4. Creates .env.local — Pre-filled with your credentials

Example: Next.js App Router

Files generated:

src/app/api/reclaim/config/route.ts      # GET  — builds proof request
src/app/api/reclaim/callback/route.ts    # POST — verifies proof
src/app/components/ReclaimVerification.tsx  # Client component with QR code
.env.local                                 # RECLAIM_APP_ID, RECLAIM_APP_SECRET, RECLAIM_PROVIDER_ID

Tools

The server exposes two MCP tools:

• integrateReclaim — Full integration: detect stack, write code, set up env vars
• detectProjectStack — Just detect the framework, package manager, and TypeScript usage

License

MIT