x402 Oracle

Name: x402 Oracle
Author: kwizzlesurp10-ctrl

远程服务

x402orcle.vercel.app开发工具02 周前更新

代码仓库访问官网

关于 x402 Oracle

x402 Oracle 是面向 x402、MCP、A2A 和 Bazaar 主题的付费咨询服务，通过 MCP 与 HTTP 提供建议。适用于排查支付错误、审阅 MCP 清单或修改 Bazaar 条目；付费回复包含结论、建议、实施提示词、风险、引文和回执。

主要功能

01免费健康状态与定价工具
02付费诊断 x402 错误
03付费审阅 MCP 清单
04付费改写 Bazaar 条目

适用场景

01诊断 HTTP 402 支付错误
02审阅 MCP 清单
03改写 Bazaar 条目

MCP 相关

提供 streamable HTTP MCP 端点，包含免费的健康状态和定价工具，以及付费咨询工具。付费咨询采用 HTTP 402 支付流程，并以 Base 上的 USDC 结算。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://x402orcle.vercel.app/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http kwizzlesurp10-ctrl-x402orcle https://x402orcle.vercel.app/mcp

Cursor.cursor/mcp.json{"mcpServers":{"kwizzlesurp10-ctrl-x402orcle":{"type":"http","url":"https://x402orcle.vercel.app/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"kwizzlesurp10-ctrl-x402orcle":{"type":"http","url":"https://x402orcle.vercel.app/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"kwizzlesurp10-ctrl-x402orcle":{"type":"http","url":"https://x402orcle.vercel.app/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"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`
Agent	`/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）

付费回复是一个智慧信封：判定、智慧、implementation_prompt、风险、引用、收据。

环境变量（绝不可使用支出密钥）

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。买家的密钥应保存在运营者的笔记本电脑上。

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"}'

然后使用本地临时钱包进行一次主网种子结算。未结算 = 无排名。

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（参见 apps/mcp/src/x402-foss.ts）。