x402 Oracle
Paid x402 help: debug 402 errors, review MCP manifests, rewrite Bazaar listings. USDC on Base.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http x402-oracle 'https://x402orcle.vercel.app/mcp'{
"mcpServers": {
"x402-oracle": {
"type": "http",
"url": "https://x402orcle.vercel.app/mcp"
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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) |
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 DemoFacilitatorDo 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 landingUnpaid 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-brainFOSS: @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.
Questions fréquentes
Qu'est-ce que x402 Oracle ?
Paid x402 help: debug 402 errors, review MCP manifests, rewrite Bazaar listings. USDC on Base.
Comment installer x402 Oracle ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http x402-oracle 'https://x402orcle.vercel.app/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour x402 Oracle ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
x402 Oracle est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient x402 Oracle ?
Il est publié par kwizzlesurp10-ctrl. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.