Which integrations are available for this server?

Integrates with Coinbase's CDP x402 facilitator API for payment validation and settlement, enabling paid oracle consult transactions on Base USDC and settlement-triggered Bazaar cataloging.

How do I use x402orcle?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@x402orcle ask the oracle how to handle 402 payments in my MCP server" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

Surface	Path
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`)

Related MCP server: x402-bazaar-mcp

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).

Legal

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

WarpPay402 Gateway BDeprecated
com.warppay402.api
Production-grade MCP gateway delivering 8 real-time AI tools with instant x402 micropayments settled in USDC on Base Mainnet or SPL-USDC on Solana. Features Basescan contract auditing, wallet analytics, headless browser scraping, and pre-scraped oracle data feeds.
Autonomous Agents Browser Automation Web3 & Decentralized Tech
281
WarpPay402 Gateway C
com.warppay402.api
Production-grade MCP gateway delivering 8 real-time AI tools with instant x402 micropayments settled in USDC on Base Mainnet or SPL-USDC on Solana. Features Basescan contract auditing, wallet analytics, headless browser scraping, and pre-scraped oracle data feeds.
Autonomous Agents Browser Automation Web3 & Decentralized Tech
282
Fatstack A
net.fatstack
Paid MCP tools behind one endpoint. Agents pay per call in USDC on Base via x402.
Payments & Billing Web3 & Decentralized Tech
151
AIPP Monetize A
dev.aipp
Pay-per-action access to APIs and MCP tools over Lightning L402 and Base USDC x402.
Payments & Billing Cryptocurrency Blockchain
31

Related MCP Servers

@true402.dev/mcp-server
AI & Machine Learning Cryptocurrency Web Scraping
true402
A
license
A
quality
C
maintenance
An MCP server that enables AI agents to access paid AI inference and web tools via HTTP 402 micropayments in USDC on Base, using the agent's wallet as identity.
Updated a month ago (2026-08-23 08:53 UTC)
14
83 npm
MIT
x402-bazaar-mcp
Blockchain Cryptocurrency AI & Machine Learning
sukrutkrdg
A
license
B
quality
B
maintenance
MCP server exposing x402 Bazaar's paid Base APIs (token risk/honeypot, prices, gas, wallet intel, tx decode + AI utilities) as agent tools. Your agent pays per call in USDC over x402 — no API keys, no signup.
Updated 19 days ago (2026-09-09 16:23 UTC)
17
53 npm
MIT
obolpay-x402-mcp
Payments & Billing Cryptocurrency Blockchain
Hiroshi-Ichiyanagi
F
license
A
quality
B
maintenance
MCP server for a live x402 payment gateway on Base (USDC). Lets AI agents discover, preview for free, then pay per call — with prepaid gasless payments, signed receipts, and delta delivery.
Updated 15 days ago (2026-09-13 22:53 UTC)
7
-
x402farm-mcp
Cryptocurrency Blockchain Web Scraping
laurenthalbrun
A
license
Not graded
quality
D
maintenance
MCP server that provides AI agents with pay-per-call access to a suite of tools (honeypot check, token market, DeFi yields, etc.) via USDC on Base using the x402 protocol.
Updated 2 months ago (2026-07-29 01:15 UTC)
9 npm
MIT

x402 Oracle (x402orcle)