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 分