x402 Oracle について
x402 Oracleは、x402、MCP、A2A、Bazaarに関する有料相談をMCPとHTTPで提供します。決済エラーの調査、MCPマニフェストの確認、Bazaar掲載文の修正に使え、有料回答には判定、助言、実装プロンプト、リスク、引用、レシートが含まれます。
主な機能
- 01無料のヘルスチェックと料金確認ツール
- 02有料のx402エラー診断
- 03有料のMCPマニフェストレビュー
- 04有料のBazaar掲載文リライト
活用シーン
- 01HTTP 402決済エラーの診断
- 02MCPマニフェストの確認
- 03Bazaar掲載文の書き換え
MCP 対応
ストリーミングHTTPのMCPエンドポイントで、無料のヘルスチェック・料金確認ツールと有料相談ツールを提供します。有料相談はHTTP 402決済フローを使い、Base上のUSDCで決済します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://x402orcle.vercel.app/mcpclaude mcp add --transport http kwizzlesurp10-ctrl-x402orcle https://x402orcle.vercel.app/mcp{"mcpServers":{"kwizzlesurp10-ctrl-x402orcle":{"type":"http","url":"https://x402orcle.vercel.app/mcp"}}}Cursor で開く{"servers":{"kwizzlesurp10-ctrl-x402orcle":{"type":"http","url":"https://x402orcle.vercel.app/mcp"}}}VS Code で開く{"mcpServers":{"kwizzlesurp10-ctrl-x402orcle":{"type":"http","url":"https://x402orcle.vercel.app/mcp"}}}{"mcpServers":{"kwizzlesurp10-ctrl-x402orcle":{"serverUrl":"https://x402orcle.vercel.app/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
x402 Oracle (x402orcle)
答えは402です。質問する方法、それがOracleです。
x402/MCP/A2A/Bazaar向けの、有料MCPおよびHTTP 402の知恵を提供するマーケットです。公開ホストは販売者専用です。Base USDC(eip155:8453)。
検出
| サーフェス | パス |
|---|---|
| ランディングページ | / |
| カタログ | /.well-known/x402 |
| MCP | /mcp ストリーミング可能なHTTP JSON-RPC + /.well-known/mcp.json |
| A2A | /.well-known/agent-card.json |
| 資金調達 | /.well-known/funding.json |
| LLM | /llms.txt |
| エージェント | /agents.txt |
| OpenAPI | /openapi.json(x-payment-info) |
ツール
無料:oracle_health、oracle_pricing
有料:oracle_ask $0.10 · oracle_diagnose_402 $0.50 · oracle_review_mcp $3 · oracle_bazaar_rewrite $1.50 · complete_oracle_task $10(MAX_PRICE_USD=25 を上限とします)
有料の応答は知恵のエンベロープです。判定、知恵、実装プロンプト、リスク、引用、レシートが含まれます。
環境変数(決済用秘密鍵は設定しないでください)
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
Vercel/Renderに EVM_PRIVATE_KEY を設定しないでください。購入者の鍵はオペレーターのノートPCに保管してください。
x402.org/facilitator は、メインネットEVMの本番環境におけるデフォルトの経路ではありません。
実行
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
未払いの問い合わせ → HTTP 402 + PAYMENT-REQUIRED(base64 JSON、extensions.bazaar)。
デモ:POST /v1/demo/mint-payment を実行し、PAYMENT-SIGNATURE を付けて再試行します。
Bazaar
カタログへの登録は決済の成立がトリガーです。まずは支払いなしで検証します。
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"}'
その後、ローカルの使い捨てウォレットからメインネットで1件シード決済を行います。決済がなければランクは付きません。
モノレポ
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(apps/mcp/src/x402-foss.ts を参照)。
法務
提供済みの問い合わせ成果物への支払い、または任意のチップです。トークンではなく、株式でもなく、資金調達でもありません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。