English Français العربية

x402 Oracle

السجل الرسمي أدوات المطورين

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو x402 Oracle؟

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

كيف أثبّت x402 Oracle؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http x402-oracle 'https://x402orcle.vercel.app/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج x402 Oracle إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل x402 Oracle مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون x402 Oracle؟

ينشره kwizzlesurp10-ctrl. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.