x402 Agent Tools

x402 エージェントツール

AI エージェント向けの従量課金制ツールです。x402 プロトコル（HTTP 402）を使用し、Base 上の USDC で支払います。API キー、サインアップ、アカウントは不要です。

• 稼働中：https://x402-agent-tools.x402agenttools.workers.dev
• LLM 向け：https://x402-agent-tools.x402agenttools.workers.dev/llms.txt
• 検出：/.well-known/x402 · /openapi.json · /health
• MCP（リモート、Streamable HTTP）：https://x402-agent-tools.x402agenttools.workers.dev/mcp

ツールと料金

エンドポイント	料金（USDC）	機能
GET /v1/markdown?url=	$0.01	Web ページをクリーンな Markdown に変換
GET /v1/extract?url=	$0.04	構造化 JSON：メタデータ／OpenGraph、JSON-LD、見出し、リンク、表、メールアドレス
GET /v1/crawl?url=&max_pages=	$0.16	同一オリジンを最大 10 ページまでクロールし、各ページを Markdown に変換
GET /v1/token-risk?address=	$0.04	Base トークン／コントラクトのヒューリスティックなリスクチェック（プロキシ、所有者、リスクのあるセレクター）
GET /v1/token-price?address=	$0.005	Base トークンの米ドル価格（GeckoTerminal、フォールバックは DefiLlama）
GET /v1/wallet-profile?address=	$0.02	Base ウォレットの ETH／USDC 残高、ノンス、最近の USDC 送金
GET /v1/fx?from=&to=&amount=&date=	$0.002	法定通貨の為替レート（ECB 基準）
GET /v1/alerts/latest?limit=	$0.01	最新の事実に基づく暗号資産／市場アラート
GET|POST /v1/alerts/pass	$1	GET /v1/alerts?since= 用の 7 日間有効な Bearer トークン
GET /v1/alerts/sample	無料	60 分以上遅延したアラート 3 件

暗号資産のアラートは、発生から約 1〜2 分後に確認できます。株式ニュースのアラートは 15〜20 分遅延します。アラートは事実に基づく観測（価格／出来高の変動）のみで、スコアや売買の推奨はなく、投資助言ではありません。

無料トライアル

/v1/markdown、/v1/token-price、/v1/fx への最初の 1 日あたり呼び出し 3 回（呼び出し元ごと。IP をハッシュ化） は無料です。支払いヘッダーを付けずに呼び出してください。全体の日次上限が適用されます。X-Free-Trial-Remaining レスポンスヘッダーで残り回数を確認できます。クロールとアラートパスは無料になりません。

エージェントの支払い方法（x402）

1. エンドポイントを呼び出します。PAYMENT-REQUIRED ヘッダー（x402 v2）と、accepts（スキーム exact、ネットワーク eip155:8453、資産 USDC、payTo、金額）を列挙した JSON ボディを含む 402 Payment Required が返されます。
2. ウォレットで USDC の認証に署名し、PAYMENT-SIGNATURE（v2）または X-PAYMENT（v1）ヘッダーを付けて再試行します。
3. ファシリテーターが検証して決済し、結果と PAYMENT-RESPONSE ヘッダーが返されます。

// any x402 client works, e.g. @x402/fetch:
import { wrapFetchWithPayment } from "@x402/fetch";
const fetchWithPay = wrapFetchWithPayment(fetch, yourX402Client);
const res = await fetchWithPay("https://x402-agent-tools.x402agenttools.workers.dev/v1/markdown?url=https://example.com");

MCP

リモート MCP サーバー。ステートレスな Streamable HTTP（JSON レスポンス）で、インストールは不要です。

{ "mcpServers": { "x402-agent-tools": { "type": "http", "url": "https://x402-agent-tools.x402agenttools.workers.dev/mcp" } } }

ツール：web_markdown、web_extract、web_crawl、base_token_risk、base_token_price、base_wallet_profile、fx_rates、alerts_latest、alerts_sample（無料）。

有料ツールを支払いなしで呼び出すと、x402 の要件を structuredContent["x402/payment-required"] に含む isError: true が返されます。x402 の支払いペイロードを Base64 でエンコードし、PAYMENT-SIGNATURE HTTP ヘッダーまたは params._meta["x402/payment"] に含めて、同じ tools/call を再試行してください。決済情報は result._meta["x402/payment-response"] で返されます。

npm は不要です。HTTP トランスポートに対応する任意の MCP クライアント、または通常の curl が使えます。

curl -s https://x402-agent-tools.x402agenttools.workers.dev/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

セルフホスト

Cloudflare Worker（Hono + @x402/hono）。

npm install
# edit wrangler.toml: account_id, KV namespace id, PAY_TO (your own receive address)
npx wrangler secret put ALERTS_HMAC   # random secret for alert tokens
npx wrangler deploy

このリポジトリにシークレットはありません。機密情報はすべて Wrangler のシークレットまたは環境変数です。

ライセンス

MIT。自律型 AI エージェントチームが運営しています。情報提供のみを目的としており、投資助言ではありません。