x402 Oracle

io.github.kwizzlesurp10-ctrlPublished by GitHub account kwizzlesurp10-ctrlv0.1.0Updated Oct 27, 2026

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

VerifiedStreamable HTTPWeb executableFinanceDeveloper Tools

Overview

AI-generated overview

Remote paid-consult MCP server that answers x402, MCP, A2A and Bazaar questions and debugs HTTP 402 payment errors, billed in USDC on Base.

What you can do
  • Check the service's liveness, seller posture and price menu for free
  • Ask a paid consult question and get a structured reply with verdict, build notes, risk, citations and a payment receipt
  • Post-mortem a failed 402 handshake, including payment-required shape, network, asset and resource URL
  • Review an MCP paid-tool server for payment wrapper, free health tool, discovery extension and key isolation
  • Rewrite a Bazaar listing's service name, description and tags for buyer-query ranking
  • Complete a paid A2A task with typed diffs, handoff notes and revenue/risk for a concrete x402 shipping goal
When to use it
Useful when you are building or debugging an x402-paid API or MCP server and want targeted advice on 402 handshakes, manifest review, or Bazaar discovery and ranking. The free tools are worth a look first; paid consults only make sense if you accept per-call USDC charges.
Requirements
Remote streamable HTTP endpoint; no account, API key or header is declared for connecting. Paid tools require the client to settle x402 payments in USDC on Base (eip155:8453), so a funded wallet and an x402-capable client are needed. Prices run from $0.10 to $10 per call.
Before you install
Most tools cost money: oracle_ask $0.10, oracle_diagnose_402 $0.50, oracle_bazaar_rewrite $1.50, oracle_review_mcp $3 and complete_oracle_task $10, charged in USDC on Base per call. Only oracle_health and oracle_pricing are free. Questions and any details you send go to a third-party host. The README's environment variables (X402_PAY_TO, CDP_API_KEY_ID, CDP_API_KEY_SECRET) are for self-hosting, not for connecting.

Installation

In SourceWeft

  1. Open x402 Oracle in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.kwizzlesurp10-ctrl%2Fx402orcle/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "x402-oracle": {
      "type": "http",
      "url": "https://x402orcle.vercel.app/mcp"
    }
  }
}

README

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 onlyX402_NETWORK=eip155:8453X402_FACILITATOR_URL=https://api.cdp.coinbase.com/platform/v2/x402CDP_API_KEY_ID=                 # Secret API key id (JWT). Not a wallet key.CDP_API_KEY_SECRET=MAX_PRICE_USD=25DEMO_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

bash
cp .env.example .envpnpm installpnpm --filter @x402orcle/oracle-brain testpnpm --filter @x402orcle/mcp testpnpm --filter @x402orcle/mcp dev     # :4021pnpm --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):

bash
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 + 402apps/mcp            streamable-HTTP paid MCP + HTTP twinspackages/oracle-brain

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

Legal

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

Source: README.md at commit f6471cb

Tools

7

oracle_health

Free liveness + seller posture (payTo configured, no spend key, network, demo/live).

Takes no parameters.

oracle_pricing

Free menu of paid consults, A2A tasks, and connect how-to. No keys requested.

Takes no parameters.

oracle_ask

Paid x402/MCP/A2A/Bazaar consult. JSON wisdom envelope: verdict, wisdom, developer build notes, risk, citations, receipt.

Parametersaudiencequestionrequired

oracle_diagnose_402

Post-mortem a 402 handshake: PAYMENT-REQUIRED shape, bazaar extension, network, asset, resource.url.

Parametersresource_urlchallenge_b64_or_jsonrequired

oracle_review_mcp

Review an MCP paid-tool server for createPaymentWrapper, free health tool, discovery extension, burner isolation.

Parametersnotesmcp_urlrequired

oracle_bazaar_rewrite

Rewrite serviceName (≤32), description (≤500), tags (≤5) for buyer-query rank. Warns on first-index freeze.

Parametersbuyer_phrasescurrent_descriptionrequired

complete_oracle_task

Outcome A2A task: typed diffs, operator handoff notes, and revenue/risk for a concrete x402 shipping goal.

Parametersgoalrequiredconstraints

Version history

1
  1. v0.1.0LatestOct 17, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts