English Français العربية

x402 Oracle

Official registry Developer tools

Paid x402 help: debug 402 errors, review MCP manifests, rewrite Bazaar listings. USDC on Base.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http x402-oracle 'https://x402orcle.vercel.app/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "x402-oracle": {
            "type": "http",
            "url": "https://x402orcle.vercel.app/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. x402 Oracle (x402orcle)
  2. Discover
  3. Tools
  4. Env (never a spend key)
  5. Run
  6. Bazaar
  7. Monorepo
  8. Legal

x402 Oracle (x402orcle)

402 is the answer. The Oracle is how you ask.

Paid MCP + HTTP 402 wisdom market for x402 / MCP / A2A / Bazaar. Seller-only public host. Base USDC (eip155:8453).

Discover

SurfacePath
Landing/
Catalog/.well-known/x402
MCP/mcp streamable HTTP JSON-RPC + /.well-known/mcp.json
A2A/.well-known/agent-card.json
Fund/.well-known/funding.json
LLMs/llms.txt
Agents/agents.txt
OpenAPI/openapi.json (x-payment-info)

Tools

Free: oracle_health, oracle_pricing
Paid: oracle_ask $0.10 · oracle_diagnose_402 $0.50 · oracle_review_mcp $3 · oracle_bazaar_rewrite $1.50 · complete_oracle_task $10 (clamped to MAX_PRICE_USD=25)

Paid replies are a wisdom envelope: verdict, wisdom, implementation_prompt, risk, citations, receipt.

Env (never a spend key)

X402_PAY_TO=0x…                 # 42-char address only
X402_NETWORK=eip155:8453
X402_FACILITATOR_URL=https://api.cdp.coinbase.com/platform/v2/x402
CDP_API_KEY_ID=                 # Secret API key id (JWT). Not a wallet key.
CDP_API_KEY_SECRET=
MAX_PRICE_USD=25
DEMO_MODE=true                  # local DemoFacilitator

Do not set EVM_PRIVATE_KEY on Vercel/Render. Buyer keys stay on the operator laptop.

x402.org/facilitator is not the default production path for mainnet EVM.

Run

cp .env.example .env
pnpm install
pnpm --filter @x402orcle/oracle-brain test
pnpm --filter @x402orcle/mcp test
pnpm --filter @x402orcle/mcp dev     # :4021
pnpm --filter @x402orcle/web dev     # :3000 landing

Unpaid consult → HTTP 402 + PAYMENT-REQUIRED (base64 JSON, extensions.bazaar).
Demo: POST /v1/demo/mint-payment then retry with PAYMENT-SIGNATURE.

Bazaar

Cataloging is settlement-triggered. Validate first (no pay):

curl -sS -X POST https://api.cdp.coinbase.com/platform/v2/x402/validate \
  -H 'content-type: application/json' \
  -d '{"resource":"https://YOUR_HOST/api/consult/oracle_ask","method":"POST"}'

Then one mainnet seed settle from a local burner. No settlement = no rank.

Monorepo

apps/web            Next.js App Router landing + discovery + 402
apps/mcp            streamable-HTTP paid MCP + HTTP twins
packages/oracle-brain

FOSS: @x402/mcp createPaymentWrapper + x402ResourceServer, @x402/extensions/bazaar declareDiscoveryExtension (see apps/mcp/src/x402-foss.ts).

Payment for delivered consult artifacts or a voluntary tip. Not a token, not equity, not a raise.

Frequently asked questions

What is x402 Oracle?

Paid x402 help: debug 402 errors, review MCP manifests, rewrite Bazaar listings. USDC on Base.

How do I install x402 Oracle?

It runs as a remote server. In Claude Code: claude mcp add --transport http x402-oracle 'https://x402orcle.vercel.app/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does x402 Oracle need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is x402 Oracle open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains x402 Oracle?

It is published by kwizzlesurp10-ctrl. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.