x402 Oracle

io.github.kwizzlesurp10-ctrl由 GitHub 帳號 kwizzlesurp10-ctrl 發布v0.1.0更新於 Oct 27, 2026

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

已驗證Streamable HTTP可網頁執行金融開發者工具

概覽

AI 產生的概覽

遠端付費諮詢 MCP 伺服器，解答 x402、MCP、A2A 與 Bazaar 問題並排查 HTTP 402 付款錯誤，以 Base 上的 USDC 計費。

可以做什麼
  • 免費查看服務存活狀態、賣方設定與付費項目價格
  • 發起付費諮詢，取得含結論、實作建議、風險、引用與付款收據的結構化回覆
  • 對失敗的 402 握手做事後分析，包括付款要求結構、網路、資產與資源位址
  • 審查 MCP 付費工具伺服器，檢查付款封裝、免費健康檢查工具、探索擴充與金鑰隔離
  • 為 Bazaar 刊登重寫服務名稱、描述與標籤，以提升買家查詢排名
  • 完成付費 A2A 任務，輸出型別化差異、交接說明，以及具體 x402 上線目標下的收益與風險
適用情境
適合在建置或除錯 x402 付費 API、MCP 伺服器時使用，需要針對 402 握手、清單審查或 Bazaar 探索與排名的具體建議。建議先試用免費工具；只有接受逐次 USDC 扣款時才值得使用付費諮詢。
執行需求
遠端 streamable HTTP 端點；連線未宣告需要帳號、API 金鑰或標頭。付費工具要求用戶端以 Base（eip155:8453）上的 USDC 完成 x402 付款，因此需要已儲值的錢包與支援 x402 的用戶端。單次價格從 0.10 美元到 10 美元不等。
安裝前請注意
多數工具收費：oracle_ask 0.10 美元、oracle_diagnose_402 0.50 美元、oracle_bazaar_rewrite 1.50 美元、oracle_review_mcp 3 美元、complete_oracle_task 10 美元，皆按次以 Base 上的 USDC 扣款；僅 oracle_health 與 oracle_pricing 免費。提問內容及所附細節會傳送給第三方主機。README 中的環境變數（X402_PAY_TO、CDP_API_KEY_ID、CDP_API_KEY_SECRET）供自架使用，而非連線使用。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 x402 Oracle，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.kwizzlesurp10-ctrl%2Fx402orcle/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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.

來源：README.md，提交 f6471cb

工具

7

oracle_health

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

無需輸入參數。

oracle_pricing

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

無需輸入參數。

oracle_ask

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

輸入參數audiencequestion必填

oracle_diagnose_402

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

輸入參數resource_urlchallenge_b64_or_json必填

oracle_review_mcp

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

輸入參數notesmcp_url必填

oracle_bazaar_rewrite

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

輸入參數buyer_phrasescurrent_description必填

complete_oracle_task

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

輸入參數goal必填constraints

版本歷史

1
  1. v0.1.0最新Oct 17, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分