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

米国経済、SEC EDGAR、オンチェーンデータ — 従量課金型 MCP サーバー

AI エージェントが発見し、呼び出しごとに支払いを行う21種類のデータツールです。支払いは x402 決済プロトコルを介して、Base 上で USDC により精算されます。アカウント、API キー、サブスクリプションは不要です。

稼働中： https://x402.agentfund.net · エージェント向けガイド · 検証台帳 · 決済状況

エンドポイント	目的
POST /mcp	ストリーミング可能な HTTP による MCP（ステートレス）
POST /x402/<tool>	ツールごとに1つの HTTP ルートを用意し、引数を通常の JSON ボディとして渡します
GET /openapi.json	各ルートに x-payment-info を含む OpenAPI 3.1 のディスカバリードキュメント
GET /SKILL.md	エージェント向け使用ガイド
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

料金は1回の呼び出しにつき $0.001〜$0.03 です。

これらの情報源を選んだ理由

すべてのツールは、無料で利用できる米国政府の公開データ（財務省、BLS、BEA、国勢調査局、EIA、SEC EDGAR）または公開 RPC を介したオンチェーンへの直接読み取りを利用しています。上流ベンダーのライセンスがないため、第三者によって利用停止や価格変更が行われることはなく、原価もゼロです。

情報源の特性は、公開元から引き継がれます。政府統計には公表の遅れや改訂があり、13F は四半期ごとで、仕様上、情報が古くなります。また、これらはいずれも市場データではありません。こうした制約は隠さず、SKILL.md に明記しています。

正確性

各ツールはリリース前に、実際の上流データに照らして検証しました。コードと同じ誤った前提に基づいて書かれたテストは簡単に通ってしまうため、ユニットテストだけでは不十分です。

その結果、6件の実際の不具合が見つかりました。SEC 自身の ドキュメント に従ったために13Fの値が1000倍になっていた問題や、国勢調査局が全国値を期待していたところ、地域別の行を黙って5件返していた問題などです。それぞれについて、発見の根拠となった証拠を記録し、回帰テストで再発を防止しています：VERIFICATION.md。

失敗した呼び出しに料金が請求されることはありません。 MCP SDK はツールエラーをスローすると、isError: true を含む HTTP 200 に変換します。決済ゲートは結果を確認し、呼び出し元が受け取っていない結果に料金を請求するのではなく、エラーを未精算のまま返します。

アーキテクチャ

• Base mainnet 上の Coinbase CDP facilitator を利用する x402 v2（@x402/core、@x402/evm）。
• @hono/mcp の StreamableHTTPTransport を介した Workers 上の MCP（SDK 独自のトランスポートは Node の http ベースです）。ステートレスな JSON です。
• 2 つのエントリーポイントで、決済経路は 1 つです。 /mcp と /x402/<tool> はどちらも PaymentGate.chargeAndRun を経由するため、資金の安全性に関するルールに差異が生じません。
• 検出用にツールごとの HTTP ルートを用意しています。 x402 Bazaar がインデックス化するのは通常の HTTP リソースだけです。カタログの各項目は type: "http" なので、MCP エンドポイントだけでは掲載されません。
• 検出にシークレットは不要です。 initialize、tools/list、ping は決済設定なしで応答するため、新規にクローンした環境や CI サンドボックスでもサーバーを問題なく調査できます。
• 検証には Ajv ではなく @cfworker/json-schema を使用します。 Ajv は Function を使ってコンパイルしますが、Workers ではこれが禁止されています。また、スキーマは実行時の入力であるため、事前コンパイルできません。
• 秘密鍵は使用しません。 サーバーが保持するのは公開の受取アドレスのみです。config.ts は秘密鍵やシードに見える入力を拒否します。

ツールの追加は、1 つのファイルを変更し、src/tools/index.ts に 1 行追加するだけです。

開発

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.toml には記載せず、wrangler secret put で設定してください。

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

決済は支払者にとってガス代不要です（トランザクションは facilitator が送信します）。そのため、テスト用ウォレットに必要なのは USDC で、ETH は不要です。index-all.mjs はインデックス済みのルートをスキップし、--yes を指定しない限り支出を拒否します。

ライセンス

MIT（package.json で宣言されています。LICENSE ファイルはまだ追加されていません）。