US Economic, SEC EDGAR & On-Chain Data (x402)

美国经济、SEC EDGAR 与链上数据——按次付费的 MCP 服务

21 个数据工具，AI Agent 可按调用次数发现并付费，通过 x402 支付协议以 USDC 在 Base 上结算。无需账户、API 密钥或订阅。

线上服务： https://x402.agentfund.net · Agent 指南 · 验证记录 · 结算记录

端点	用途
POST /mcp	通过可流式传输的 HTTP 提供 MCP（无状态）
POST /x402/<tool>	每个工具对应一个 HTTP 路由；参数以纯 JSON 请求体传递
GET /openapi.json	OpenAPI 3.1 发现文档，各路由均包含 x-payment-info
GET /SKILL.md	面向 Agent 的使用指南
GET /VERIFICATION.md	各工具的验证方式及发现的上游陷阱
GET /monitor	实时链上结算仪表板
GET /health	存活状态与配置模式

工具

美国宏观经济 — treasury_yield_curve、bls_cpi、macro_pce、macro_jobs、macro_gdp、 macro_retail_sales、macro_housing、macro_energy、macro_release_calendar

SEC EDGAR — edgar_filings_feed、edgar_financials、edgar_insider_transactions、 edgar_13f_holdings、edgar_full_text_search

EVM 链上 — onchain_token_balances、onchain_portfolio、onchain_cross_chain_balances、 onchain_oracle_price、onchain_gas

纯计算 — structured_json_repair、tabular_to_json

每次调用的价格为 $0.001–$0.03。

数据来源说明

每个工具都封装了免费的美国政府公有领域数据（财政部、BLS、BEA、人口普查局、EIA、SEC EDGAR），或通过公共 RPC 进行直接链上读取。不存在上游供应商许可，因此第三方无法撤销或重新定价，商品成本也为零。

其代价来自数据发布方：政府统计数据存在滞后且会修订，13F 按季度发布，按设计存在时效滞后，而且这些数据都不是市场数据。相关限制已在 SKILL.md 中明确说明，而非刻意隐瞒。

正确性

发布前，每个工具都经过了实时上游数据核验——不仅仅是单元测试，因为如果测试和代码基于相同的错误假设，测试也会轻松通过。

核验发现了 6 个实际缺陷，包括遵循 SEC 自身文档导致 13F 数值放大 1000 倍，以及 Census 悄然返回 5 条区域数据，而非预期的全国数据。每个问题都记录了揭示问题的证据，并通过回归测试加以防范：VERIFICATION.md。

失败的调用绝不会收费。 MCP SDK 会将抛出的工具错误转换为携带 isError: true 的 HTTP 200 响应；支付关卡会检查结果，并让错误保持未结算状态，而不会对调用方从未收到的结果收费。

架构

• x402 v2（@x402/core、@x402/evm），使用 Base 主网上的 Coinbase CDP facilitator。
• 在 Workers 上运行 MCP，通过 @hono/mcp 的 StreamableHTTPTransport（SDK 自带的传输基于 Node 的 http）。无状态 JSON。
• 两个入口，一条支付路径。 /mcp 和 /x402/<tool> 都通过 PaymentGate.chargeAndRun 运行，因此资金安全规则不会在两者之间出现偏差。
• 提供逐工具 HTTP 路由以供发现。 x402 Bazaar 只为纯 HTTP 资源编制索引——目录中的每个条目都是 type: "http"，因此仅有 MCP 端点永远无法被列出。
• 发现功能无需密钥。 无需支付配置即可响应 initialize、tools/list 和 ping，因此在全新克隆的项目或 CI 沙盒中，服务器都能顺利完成自省。
• 验证使用 @cfworker/json-schema，而不是 Ajv——Ajv 通过 Function 编译，而 Workers 禁止使用 Function；且该 schema 是运行时输入，因此无法预编译。
• 不使用私钥。 服务器只保存公开的收款地址；config.ts 会拒绝看起来像私钥或助记词的输入。

添加工具只需修改一个文件，并在 src/tools/index.ts 中添加一行。

开发

npm install
npm test          # 174 tests
npm run typecheck
npm run dev       # wrangler dev
npm run dev:node  # tsx watch src/node.ts

将 .dev.vars.example 复制为 .dev.vars 以进行本地配置。始终只需要公开的收款地址——绝不需要私钥或助记词。

文档会复制到程序包中（Workers 没有文件系统）；编辑 SKILL.md 或 VERIFICATION.md 后运行 npm run gen:docs，否则 test/docs.test.ts 会因内容不一致而失败。

部署

生产环境运行在 Cloudflare Workers 上。使用 wrangler secret put 设置密钥，绝不要将密钥写入 wrangler.toml：

npx wrangler deploy --env production

项目包含用于自托管 Node 入口点的 Dockerfile；它不需要任何密钥，因此容器启动后即可直接通过自省。完整的运行手册请参阅 OPERATOR_CHECKLIST.md。

买方侧测试客户端

PAYER_PRIVATE_KEY=0x… node scripts/pay-test.mjs      # pay via /mcp
PAYER_PRIVATE_KEY=0x… node scripts/pay-http.mjs      # pay via /x402/<tool>
node scripts/index-all.mjs                            # dry run: Bazaar index status

付款方无需支付 Gas 费（交易由 facilitator 提交），因此测试钱包只需要 USDC，不需要 ETH。index-all.mjs 会跳过已编入索引的路由，并且在未指定 --yes 时拒绝消费。

许可证

MIT（在 package.json 中声明；目前尚未添加 LICENSE 文件）。