Agent402 について
Agent402は、AIエージェント向けのオープンソースでセルフホスト可能なMCPサーバーです。ウェブ検索や引用付き回答、決定論的なツール群、複数ツールのスキルパックを提供し、x402とMPPによる従量課金にも対応します。
主な機能
- 01引用付きウェブ検索
- 02500以上の呼び出し可能なツール
- 03ブラウザー描画、PDF・画像・OCR処理
- 04金融データとCPUユーティリティ
- 05複数ツールのスキルパック
- 06x402とMPPによる決済
活用シーン
- 01エージェントのタスクに必要なツールの検索と呼び出し
- 02ウェブページの描画やPDF・画像の処理
- 03決定論的なデータ処理や計算の実行
- 04API呼び出し単位でのエージェントへの課金
MCP 対応
ホスト型コネクターまたはローカルサーバーを通じて、MCPクライアントに検索、ツール、スキルパックを公開します。HTTP APIとしても利用できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://agent402.tools/mcpclaude mcp add --transport http Agent402 https://agent402.tools/mcp{"mcpServers":{"Agent402":{"type":"http","url":"https://agent402.tools/mcp"}}}Cursor で開く{"servers":{"Agent402":{"type":"http","url":"https://agent402.tools/mcp"}}}VS Code で開く{"mcpServers":{"Agent402":{"type":"http","url":"https://agent402.tools/mcp"}}}{"mcpServers":{"Agent402":{"serverUrl":"https://agent402.tools/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
15| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| query | string | はい | 実行したい内容。例:"search the web for x402"、"answer a question with citations"、"decode JWT" |
| limit | number | いいえ | 結果の最大数(デフォルトは 10) |
詳細
Agent402:AI エージェント向けの500以上のツール、従量制モデル、完成済みレポート
agent402.tools で公開中です。
AI エージェント向けの有料ゲートウェイです。500以上のツール、従量制モデル、完成済みレポートを、x402 と MPP 経由の USDC またはカードで、呼び出しごとに支払って利用できます。Agentic Finance の応用レイヤーです。オープンソース、セルフホスト可能、MCP ネイティブです。
Havok Holdings LLC が運営 · 公開中 · ここで支払う理由 · 領収書 · ステータス · セキュリティ · 会社情報
30秒で試す: claude mcp add agent402 -- npx -y agent402-mcp を実行するか、https://agent402.tools/mcp を任意の MCP クライアントに貼り付けてください。無料枠にウォレットは不要です。Cursor、VS Code、Windsurf、Cline、Roo Code、Codex CLI、Gemini CLI、Continue、ElizaOS、AgentCore 向けの検証済みセットアップ手順:agent402.tools/guides/agent-hosts(ショートリンク agent402.sh/<host>、例:agent402.sh/cursor)。
支払う人: エージェントは呼び出しごとに支払います($0.001から。モデルは提示された上限額の範囲で従量制となり、実際の使用量に応じて精算されます)。人は完成済みレポート($2~$5)とモニター(月額$5)をカードで購入します。サイトは料金所を設置してクローラーに課金します。
Agent402 とは
エージェント型ファイナンスとは、ソフトウェアエージェントが自律的に支払い、報酬を受け取ることです。サービスを見つけ、オープンプロトコル(x402、MPP)を介してウォレットからリクエストごとに支払い、検証可能な領収書を受け取り、その見返りとしてリクエストごとに収益を得ます。Agent402 はその実用レイヤーです。解説:agent402.tools/agentic-finance · 用語集。
x402 API を販売していますか?
/sellから無料でインデックスに登録できます(POST /api/index/register:セルフサービス、登録不要、手数料 0%)。ルーターは、複数の独立した購入者からの決済済み支払いがルートで確認されると、購入者を販売者へ誘導します。価格が $0.01 以下の呼び出しは、それ以前でも試すことができ、購入者の領収書には未検証として記載されます。自社サイトでクローラーに課金しますか?agent402-tollboothを使えば、サイトの前段に 402 ゲートを設置できます。他との違い: Agent402 はオープンソースでセルフホスト可能です。また、1 回の統合で、購入者は x402 エコシステム全体を対象とする3 つの無料プリミティブを利用できます。
- 検索 -
/api/find?q={task}はタスクの説明から、最も適合するツール(ルート、価格、スキーマ、すぐに使える例)を特定します。- ルーティング -
POST /api/routeは中立的なスマートオーダールーターです。クロールしたすべての x402 販売者のツールをランク付けします(Coinbase CDP Bazaar から自動検出)。稼働状況を考慮し、include=externalで当社を除外できます。レスポンスには上位 N 件が返され、スコアを算出した件数はmatchedに含まれます。- リーダーボード -
GET /api/leaderboardは、x402 販売者をBase の USDC 決済済み取引量で並べた公開オンチェーンランキングです。販売者ごとの提供呼び出し数、totalUsd、ユニーク購入者数を表示します。返されるのは常に上位 N 件であり、ランキング全体ではありません(デフォルトは 25 件、上限は 50 件。全体の件数はtotalSellersに含まれます)。パイプライン:Bazaar →eth_getLogs→ 呼び出しごとの上限 →payToごとに集計。1 時間ごとにスナップショットを作成します。さらにカタログもあります。500 以上の充実したツール:検索/回答を MCP の入り口とし、その先に 500 以上のツールと厳選されたスキルパック(MCP プロンプトとして呼び出せる複数ツールのワークフロー)を用意しています。すべて自分で実行できます。加えて、x402 のもう一方の側のためのオープンなクロールごとの課金ゲート、
agent402-tollboothもあります。2 つの窓口、2 つの価格表。 エージェントは USDC で呼び出しごとに支払う(x402/MPP)か、プルーフ・オブ・ワークを使って無料で利用できます。その方法で完成したレポートの価格は $0.60~$2.00 です。人はカードで支払います。agent402.tools/reports にある同じレポート(企業概要、13F ファンドレポート、インサイダー取引の動向、市場概要、詳細調査、FDA リコール、ドメイン監査)の価格は $2~$5 です。変更時に再実行するモニターは /monitors で月額 $5 です。また、すでに発行済みのプリペイドクレジットキーでは、成功した呼び出しごとに引き続き支払えます(
Authorization: Bearer a402_…。新しいクレジットは販売していません)。カード価格には決済処理費用が含まれます。同じレポートでも、エージェントが呼び出しごとに支払う場合は、より低いツール価格が適用されます。2 つの決済方式、1 つの URL。 すべての有料エンドポイントは、x402(
PAYMENT-SIGNATURE、12 のチェーンで USDC、または Robinhood Chain で USDG)と MPP(Machine Payments Protocol。Tempo と Stripe が共同策定した、IETF で標準化が進むPaymentHTTP 認証スキーム)の両方を受け付けます。同じ 402 レスポンスで両方に対応し、mppxクライアントはそのまま支払えます。MPP の決済は Base と Celo(USDC)、Tempo 上でネイティブに(Tempo のリレー経由で USDC.e または PathUSD)、または MPP 経由のカード(Stripestripe/charge。運営者が設定した場合、価格が $0.50 以上のルートで提供)で行われます。 MPP マーケットプレイス では、ライブ検証が可能なすべての MPP 販売者を掲載しています。詳細:MPP とは · ライブ MPP 決済。 フレームワークアダプター(主要なエージェントスタックにそのまま追加できるツール。決済は内部で自動処理されます):![]()
![]()
![]()
![]()
![]()
![]()
![]()
![]()
500種類以上の充実したツールを提供。ライブウェブ検索と出典付き回答をMCPの入り口として、すぐに使えるウェブツールや複数ツールのスキルパックを、1台のサーバーからAIエージェントに提供します。すべてのツールは呼び出しごとに料金が設定され、オンチェーンで決済されます。ブラウザー描画、ウェブ検索、PDF、画像、OCR、最新の金融/暗号資産/マクロ経済データ、SEC EDGAR、決定論的統計、予測、オプション/債券価格計算(Black-Scholes、YTM)、圧縮、そして150種類以上のCPUのみで動作するユーティリティを備えています。 30秒で無料で自分で実行し(MCP または
プレーンHTTP、APIキー不要、登録不要。無料枠とx402/MPP決済ではキーは不要です。発行済みのプリペイドクレジットキーのみ、ベアラーキーとして機能します)、Claude/ChatGPT/任意のMCPクライアントに接続して、数行で独自のツールを追加できます。
ユーティリティツールの回答をLLMが生成することはありません。また、サードパーティーのキーなしでCIから実行できるすべてのツールは、リリースのたびにそれぞれのサンプルを使って再テストされます。モデルを使用する機能は明示されており、それに応じた料金が設定されています。具体的には、上限額を見積もったうえで従量課金される、または定額プランとなる/v1ゲートウェイと、完成済みレポート製品(以下の/v1/research、/v1/dossierなど)です。
オプションで、同じサーバーを x402 プロトコル経由で呼び出しごとに課金することもできます(Base、Solana、Polygon、Arbitrum、Monad、Celo、Avalanche、 Sei、Optimism、Arc、Stellar、Algorand上のUSDC、およびRobinhood Chain上のUSDG。計13チェーン)。これにより、無料で セルフホストしたインスタンスを、ホスト型の収益化インスタンスとして運用することもできます。無料モードは1つの 設定(
FREE_MODE=true)で有効になります。有料インスタンスには、受取用ウォレットが必要です。
🟢 ホスト型デモ:agent402.tools · 📖 Wiki · 📦 npm · 🔌 MCP Registry · 🧩 Smithery
30 秒で自分で実行する
用途に合う方法を選んでください。どれも無料で、ウォレットは不要です。
1. インストール不要 - ホスト型コネクターを Claude に追加する(claude.ai → Settings → Connectors → Add custom connector):
https://agent402.tools/mcp
2. コマンド 1 つ - MCP サーバーをローカルで実行する(純粋な CPU で動作するツールはキー不要です。少額のプルーフ・オブ・ワークも自動で処理されます):
npx -y agent402-mcp
# in Claude Code: claude mcp add agent402 -- npx -y agent402-mcp
3. クローンして全体をホストする(500 以上のツールすべてを HTTP API + MCP として利用できます。無料モードで、支払いは不要です):
git clone https://github.com/MikeyPetrillo/Agent402 && cd Agent402
npm install
FREE_MODE=true npm start # → http://localhost:3000 (HTTP API + /mcp)
# try a tool over HTTP - no auth in free mode
curl -s -X POST localhost:3000/api/hash -H 'content-type: application/json' \
-d '{"text":"hello world","algo":"sha256"}'
4. Railway にワンクリックでデプロイする(完全なセルフホスト型インスタンス。分析とレスポンスキャッシュ用に、オプションで Postgres + Redis プラグインを追加できます):
リポジトリの Dockerfile から直接起動します。オプションのプラグインは env 経由で自動検出されます。Redis を追加すると、REDIS_URL により上流レスポンスキャッシュ(X-Cache: hit|miss)が有効になり、Postgres を追加すると、DATABASE_URL により公開 /api/analytics ダッシュボードが有効になります。無料モードでの起動に環境変数は不要です。
ウォレットから呼び出しごとに支払う
すべての有料ルートは、x402 オファーと MPP チャレンジの両方を付けて 402 を返すため、どちらのクライアントでも支払えます。API キーも登録も不要で、ウォレットがアカウントになります。
mppx を使った MPP(Tempo 上の USDC.e または PathUSD。402 では先に表示されます。または Base や Celo 上の USDC):
import { Mppx, tempo, evm } from "mppx/client";
const account = (await import("viem/accounts")).privateKeyToAccount(process.env.AGENT_KEY);
const res = await Mppx.create({ methods: [tempo.charge({ account }), evm.charge({ account })] }).fetch("https://agent402.tools/api/uuid");
@x402/fetch を使った x402(Base およびその他のチェーン上の USDC):
import { wrapFetchWithPayment } from "@x402/fetch"; import { x402Client } from "@x402/core/client"; import { registerExactEvmScheme } from "@x402/evm/exact/client";
const client = new x402Client(); registerExactEvmScheme(client, { signer: (await import("viem/accounts")).privateKeyToAccount(process.env.AGENT_KEY) });
const res = await wrapFetchWithPayment(fetch, client)("https://agent402.tools/api/uuid");
詳細:MPP での支払い · x402 での支払い。
カタログの内容(500 以上のツール)
すべてのツールは、妥当な価格でオンチェーン決済されることで、採用に値するものとなっています。また、サードパーティーのキーなしで CI が実行できるすべてのツールは、CI の実行ごとにそれぞれの例を使ってテストされます。 CI はカタログの最低数を 400 件に設定し、 実行中のカタログに対して「500 以上」という主張を検証します(
scripts/sync-count.js --check)。 カタログは、呼び出す価値のあるツールがある場合にのみ拡大します。 | | 例 | |---|---| | ブラウザーとウェブ |render(ヘッドレス Chromium、JS を実行)、screenshot、extract(記事→Markdown)、meta| | ライブ検索と回答 |search(実際のウェブインデックス)、search-lite(手早く確認できる5件のサンプル)、answer(引用付きウェブ回答)、search-news/search-images/search-videosの各種機能、search-suggest、multi-search| | PDFとメディア |pdf-to-markdown、pdf-merge、pdf-extract-pages、pdf-rotate、images-to-pdf、audio-convert、audio-normalize(EBU R128、実際の ffmpeg) | | 画像 |image-resize、image-convert、image-thumbnail、barcode-decode(jimp/zxing、CPU のみで動作) | | OCR |image-ocr(あらゆる画像からテキストを抽出。CPU のみで動作し、モデル不要) | | 地理情報 |geo-distance(ハバーサイン式、CPU のみで動作)、geocode、reverse-geocode、place-search、geo-lookup| | ライブデータ |fx-rate(ECB)、barcode-lookup(Open Food Facts)、gov-data(data.gov)、weather-forecast/weather-alerts、earthquakes(USGS) | | 金融と暗号資産 |stock-quote/stock-history(ライセンス取得済みフィード、複数市場を統合)、crypto-price/crypto-market/crypto-history/crypto-trending/crypto-global(CoinGecko) | | 暗号資産デリバティブとオプション |perp-markets、perp-funding、perp-funding-screener、perp-basis、perp-open-interest、perp-klines、perp-orderbook(ライブの無期限先物:マーク価格/オラクル価格、資金調達率、OI、ローソク足、板の厚み);options-summary、crypto-options-chain、options-ticker、options-volume(オプション板、IV とグリークス、オンチェーンのオプション取引量) - 1回あたり $0.001~$0.005、取引所アカウント不要 | | DeFiとステーブルコイン |defi-yields(チェーン、プロジェクト、TVL、ステーブルコインのみでプールを絞り込み)、defi-yield-history、defi-protocols、defi-protocol、defi-chains、defi-chain-tvl-history、defi-fees、defi-dex-volume、stablecoins、stablecoin-supply-history- 1回あたり $0.001~$0.003 | | Solana トークン情報 |sol-token-pairs、sol-token-search、sol-trending、sol-price、sol-swap-quote、sol-token-lookup- 任意のミントの市場、価格、ルーティング | | 暗号資産市場の網羅情報 |crypto-news、crypto-indicators(RSI、MACD、移動平均をここで計算)、crypto-market-pulse、coin-profile、coin-history、coin-ohlc、coin-market-chart-range、coin-categories、coin-price-by-contract(トークンのアドレスで価格を取得。コイン ID は不要)、global-defi、exchanges、exchange-tickers、exchange-rates、coin-search、coins-list- さらに、同じ CoinGecko キーでトークン化された実世界資産も利用可能:rwa-list、rwa-markets、rwa-asset、rwa-issuers、rwa-issuer(株式、ETF、コモディティのトークン化資産と、オンチェーン市場データおよび発行者情報) | | インデックス化されたチェーンデータ |asset-transfers(絞り込み可能な送金履歴)、token-balances、token-allowance、tx-receipt(デコード済み送金)、block-receipts、token-price-history- 主要な EVM チェーンを横断したインデックス済みデータの読み取り。ノードも独自のキーも不要 | | Farcaster のソーシャル機能 |fc-cast-search、fc-channel-feed、fc-trending、fc-user-casts、fc-cast、fc-cast-replies、fc-channel、fc-user-search、fc-cast-metrics- オンチェーンのソーシャルグラフ上での検索、フィード、エンゲージメント指標 | | サイトのクロール |site-map(サイトの URL を列挙)とsite-crawl(幅優先でクロールし、クリーンな Markdown に変換。robots.txt を尊重し、ページ数/深さ/時間の上限を厳守) - 「サイト全体を読んで」というタスクを支える決定論的な2つのツール | | マクロ経済(FRED ほか) | イールドカーブ、米国債、財政、フェデラルファンド金利、CPI、失業率、サーム・ルール、ECB 為替、世界銀行、FRED の一括リリース観測値 | | SEC EDGAR | ティッカー→CIK、提出書類一覧、10-K/10-Q のテキスト、XBRL フレーム、インサイダー取引、13F 保有銘柄、IPO カレンダー、全文検索 | | 完成レポート(引用付き) |research/research-pro/research-max(根拠に基づく詳細調査)、market-brief、dossier/dossier-max(企業のデューデリジェンス)、fund-report/fund-report-max(13F ポートフォリオ)、domain-audit/domain-audit-pro(評価付きセキュリティ+配信可能性)、recall-report(FDA)、insider-report(Form 4 の動向)、token-risk/token-risk-pro(オンチェーンのコントラクトリスク)、filing-report(最新の SEC 提出書類)、token-brief(Solana ミントのリスク根拠。データソースが応答する場合に利用可能)、ticker-pack(企業調査資料+インサイダー動向+保有者)、ipo-report(S-1+424B4 の要約、決定論的) - x402/MPP 経由でレポート1件あたり $0.05~$2.00、または /reports でカード決済なら $2~$5。下記の/v1の表を参照 | | ネットワークの実態確認 |dns、dns-lookup、tls-cert、whois、http-check、robots-check、email-validate、ip-info| | 暗号資産と決済 |usdc-balance、tx-status、gas-estimate、ens-resolve、x402-quote、x402-verify、transfer-authorization- カストディ不要、マルチチェーン対応(Base/Polygon/Arbitrum/Optimism/Ethereum) | | エージェントのメモリ | ウォレットをキーにした KV+TTL、アトミックカウンター、ウォレット間の許可、ハッシュチェーン監査ログ、類似性に基づく検索 | | 統計と予測 |stats-summary、correlation、linear-regression、moving-average、outliers;forecast-naive、forecast-ses、forecast-holt、forecast-holt-winters+forecast-eval(MAPE/RMSE によるバックテスト) | | 金融計算 |black-scholes(オプション価格算定+グリークス)、bond-price/bond-ytm、cagr、sharpe-ratio、annuity、npv/irr、compound-interest、loan-payment/amortization、break-even、effective-annual-rate(CPU のみで動作、決定論的) | | 圧縮 |gzip/gunzip、brotli-compress/brotli-decompress、compress-compare(アルゴリズムの比較、node:zlib による CPU のみの処理) | | HTML 抽出 |html-select(CSS クエリ)、html-table、html-strip、html-links、html-meta-extractに対応する決定論的なツール | | ネットワーク運用 |dns-lookup、dns-propagation、spf-check/dmarc-check/dkim-lookup、email-deliverability;cert-transparency、http-headers(セキュリティ監査)、tech-stack、asn-info(IP の地理情報) | | チェーンの読み取り |block-number、chain-info、block-info、contract-code、erc721-owner、event-logs- Ethereum/Base/Polygon/Arbitrum/Optimism で複数エンドポイントにフェイルオーバーする、キー不要の JSON-RPC 読み取り。$0.001 から | | SQL ポリシー |sql-guard($0.004 - SQL 文に対して、リスク名付きの pass/warn/block 判定を返します。署名キーを設定すると、Ed25519 署名付きのチェック結果も返します)、sql-cert-verify($0.001 - 署名済みの結果が、対象の SQL 文そのものに対するものかを検証します) | | x402 販売者情報 | 同じ質問に対する3段階の調査を、安価なものから順に用意しています。seller-trust(GET /api/x402/seller-trust、$0.005) - ルーターの判定項目を一つずつ確認します。インデックス登録済みか、マニフェストを解析できるか、対応チェーンを提示しているか、決済済みの呼び出しが確認されているか、購入者の資金を使うに値するかを調べます。seller-dossier(POST /api/seller-dossier、$0.05) - 取りまとめた記録を提供します。各価格の出典、提示されたウォレットと実際に支払われたウォレットの照合、ソースごとの決済根拠、チェーンごとのディスパッチ判定とその理由、ルーターが支払った際の結果を確認できます。seller-payability(POST /api/seller-payability、$0.10) - 実際の呼び出しを1件その場で購入し、accept の EIP-712 ドメインが指定されたトークンと一致しているかを含む、すべての処理段階を報告します。最初の2つは既知の情報をオフラインで読み取りますが、3つ目は実際に USDC を使って確認します | | CPU のみで動作する150以上のユーティリティ | ハッシュ化、JWT、base58、JSON⇄CSV/YAML、token-count、text-chunk、json-validate、テキスト統計、cron 計算、バリデーター、13カテゴリにわたる単位変換(パラメーター指定型ツール1つ) | 完全なスキーマは/openapi.jsonにあります。機械可読なカタログは/api/pricingと/llms.txtで確認できます。必要なツールがわからない場合は、/api/find?q=<task>でタスクの説明から適切なツールを特定できます。ルート、価格、スキーマ、すぐ使えるサンプルが提示されるため、エージェントはトークンを大量に消費する「ツールを探し回る」手順を省けます。
LLM ゲートウェイ(/v1)— チャット、埋め込み、再ランキング、画像、音声、完成済みレポートを呼び出しごとに支払い
任意の OpenAI SDK でbase_url = https://agent402.tools/v1を指定し、x402 または MPP 経由で呼び出しごとに USDC で支払えます。API キー、サインアップ、アカウントは不要です(すでに発行済みのプリペイドクレジットキーも使用できます。人間向けを参照してください)。
| エンドポイント | 価格 | 提供内容 |
|---|---|---|
POST /v1/nano/chat/completions | $0.003 | nano モデル — 高頻度のエージェントループ向けの価格設定 |
POST /v1/auto/chat/completions | $0.01 | モデルの指定は不要 — 評価に基づく決定論的なルーティング(コード/推論/長文/一般)。同じ価格で任意のquality: fast | balanced | bestを指定でき、判断内容はagent402_routerで開示されます |
POST /v1/chat/completions | $0.02 | 低価格/中価格帯モデル(gpt-4o-mini、claude haiku、gemini flash、deepseek、llama…) |
POST /v1/pro/chat/completions | $0.10 | 中位フロンティアモデル(gpt-4o、gpt-4.1、gpt-6 sol、claude sonnet、gemini pro、grok) |
POST /v1/premium/chat/completions | $0.50 | フロンティアモデル(gpt-5 および gpt-6 astra、o3 および o4-mini、claude opus および claude fable 5.1) |
POST /v1/grounded/chat/completions | $0.03 | 自動ルーターに加え、呼び出しごとにライブウェブ検索を実行します。回答には OpenAI 形式のurl_citation注釈が付き、キャッシュはされません |
POST /v1/{nano,auto,pro,premium}/messages、POST /v1/messages | ティア別価格 | すべてのティアでAnthropic Messages 形式を使用します(チャットルートと同じ許可リスト、上限、フェイルオーバー)。Claude 4.7 以降ではeffort(low〜max)で深度を制御し、それ以前の Claude ではthinking.budget_tokensを使用します |
POST /v1/{nano,auto,pro,premium}/responses、POST /v1/responses | ティア別価格 | すべてのティアでOpenAI Responses 形式を使用します(関数ツールのみ、サーバー状態なし) |
POST /v1/embeddings | $0.002 | OpenAI の埋め込み。最大64件をまとめて入力できます。同一の繰り返しリクエストは無料です。繰り返し分の支払いは請求されません。ただし、呼び出し前に送信された Tempo の送金は、送信時点で取り消せません(出力は決定論的、キャッシュはデフォルトで有効) |
POST /v1/rerank | $0.002 | Cohere 互換の再ランキング({query, documents[], top_n})。最大50件のドキュメントに対応し、キャッシュはデフォルトで有効です |
POST /v1/images/generations | $0.08 | 画像生成(FLUX.2 Pro、1024x1024 PNG)— OpenAI images 形式、インラインの base64 出力 |
POST /v1/images/fast | $0.02 | 低価格のテキストから画像への生成。同じ OpenAI images 形式で、1枚あたり約2秒です |
POST /v1/images/pro | $0.05 | 高忠実度のテキストから画像への生成。1回の呼び出しにつき1枚です |
POST /v1/videos/generations | $0.20 | テキストから動画を生成。無音の4秒720pクリップ1本を、MP4 のインライン base64 で出力します。16:9 または9:16に対応 |
POST /v1/audio/speech | $0.06 | テキスト読み上げ。OpenAI のaudio.speech.create()形式です。最大2,000文字の入力に対応し、MP3(デフォルト)または PCM バイト列を出力します。5モデルのフェイルオーバーチェーンを備えています |
ストリーミング(stream: true)、ツール/関数呼び出しの完全なパススルー、チャットティアで任意に有効化できるプロンプトキャッシュ(cache: true → 10分間、バイト単位で同一の繰り返しリクエストは無料です。繰り返し分の支払いは請求されません。ただし、呼び出し前に送信された Tempo の送金は、送信時点で取り消せません)、カナリアで実証済みのモデルを終点とするアップストリームのフェイルオーバーチェーン、すべてのモデルとそのティアおよび上限を一覧表示する無料のGET /v1/modelsを提供します。実際の資金によるカナリアが、チャットティア、Messages と Responses の形式、埋め込み、再ランキング、画像生成、音声の主要機能を毎日購入します。ストリーミング、ルーティングの開示、両方のキャッシュ動作も対象に含まれます。
完成済みレポート製品は同じ /v1 プレフィックス上で提供されます。有料の呼び出し 1 回で、モデルの生の応答ではなく、引用付きの完全なレポート(JSON、出典の付録付き)が返されます。各レポートは、統合前にサーバーが自ら取得する一次データ(EDGAR の提出書類、openFDA、DNS/TLS プローブ、オンチェーンデータの読み取り、ライブのウェブ検索)に基づいています。ipo-report は完全に決定論的です(モデルをまったく使用しません)。
| エンドポイント | 価格 | レポート |
|---|---|---|
POST /v1/research · /v1/research/pro · /v1/research/max | $0.60 · $0.85 · $1.10 | 詳細調査レポート({query})— 複数の検索、再ランク付け、根拠に基づく統合 |
POST /v1/research/market-brief | $0.85 | 市場/競合の概要({query}) |
POST /v1/dossier · /v1/dossier/max | $0.85 · $1.10 | 企業のデューデリジェンス資料({ticker})— 提出書類、インサイダーの資金フロー、ウェブ |
POST /v1/fund · /v1/fund/max | $0.60 · $0.85 | 最新の 13F に基づくファンドのポートフォリオレポート({manager})— 前四半期の購入・売却 |
POST /v1/domain-audit · /v1/domain-audit/pro | $0.60 · $0.85 | ドメインのセキュリティおよび配信可能性の評価レポート({domain}) |
POST /v1/recall-report | $0.60 | FDA のリコールレポート。医薬品/食品/医療機器({query}) |
POST /v1/insider-report | $0.60 | 解析済み Form 4 提出書類に基づくインサイダーの資金フローレポート({ticker}) |
POST /v1/filing-report | $0.85 | 最新の SEC 提出書類を読み、値動きの要因となった事実とともに要約({ticker}) |
POST /v1/token-brief | $0.60 | オンチェーンデータと市場データに基づく Solana トークンのリスク情報({mint})。データソースが応答する間、利用可能 |
POST /v1/ticker-pack | $2.00 | 1 つのレポートに 1 ティッカー分の情報をまとめます。企業資料、インサイダーの資金フロー、保有者情報 |
POST /v1/token-risk · /v1/token-risk/pro | $0.60 · $0.85 | オンチェーンの根拠に基づくトークンおよびコントラクトのリスクレポート({address, chain}) |
POST /v1/ipo-report | $0.05 | EDGAR 全文検索による IPO パイプラインのダイジェスト。S-1 と 424B4({days, keyword})。決定論的 |
レポートの購入にはウォレットのみを使用します(x402/MPP/前払いクレジット。プルーフ・オブ・ワークは使用しません)。生成には数分かかります。同じレポートは、agent402.tools/reports で一般ユーザー向けにもカード決済で販売されており、価格は深さに応じて $2~$5 です。カード決済の価格には決済処理手数料が含まれます。x402 または MPP で呼び出しごとに支払うエージェントは、同じレポートをより低いツール価格で購入できます。
2 つの関連ツールが一連の処理を完結させます。POST /api/route/execute($0.01。より高額なツール向けに execute-plus は $0.05、execute-max は $0.55、execute-pro は $3.30 の各ティア)は、タスクの説明から最適なツールを特定し、有料の呼び出し 1 回で実行します。include:"external" を指定すると、他の x402 販売者が販売するツールも対象になります(実績のあるオンチェーン決済量に基づいてルーティングします。例外として、まだ履歴のない Base または Solana の販売者は、実績のある候補をすべて試した後に限り、1 回あたりの上限額を低く設定して試行され、領収書には未検証と記載されます。その結果を販売者から支払いに使用したチェーン上で購入し、あなたに販売します。Base、Solana、Algorand、Tempo が対象です。スマートオーダールーターガイドを参照)。POST /api/my-usage($0.005)は、支払いを行ったウォレット自身の購入履歴を返します。ウォレットのパラメーターは不要です。x402 の支払いが本人確認の役割を果たすため、他のウォレットのプロフィールを読み取ることはできません。
人向け:レポートとモニター
同じカタログには、カード決済に対応した入口(Stripe Checkout)もあります。運営者が STRIPE_SECRET_KEY を設定すると有効になり、設定されていない場合、これらのページは表示されません。
| ページ | 内容 |
|---|---|
| agent402.tools/reports | 上記の表にある完成済みレポートを、カードで(POST /api/buy)2~5ドルで購入できます(最も深い階層とティッカーパックはこの価格帯の上限です。現在の価格はページをご確認ください)。/r/<session> で受け取れます。ウォレットもアカウントも不要です。カード価格には決済処理手数料が含まれます。同じレポートをエージェントが呼び出しごとに支払う場合は、より低いツール価格になります。レポートは、Stripe で支払いが確認されたセッションに対して一度だけ生成されます。生成に失敗した場合は自動的に返金されます。 |
| agent402.tools/monitors | 月額5ドルのサブスクリプションです。何かが変わるとレポートを再実行し、メールでお知らせします(30日間に最大4件の完全なレポートを受け取れます。それを超える変更はアラートメールで届きます)。ドメインセキュリティモニター(毎日の無料再調査、セキュリティ上の変更時、証明書の有効期限まで14日以内になった時、または30日ごとに有料の完全なレポートを再実行)、SEC 提出書類ウォッチ(新しい提出書類)、Solana トークンリスクウォッチ(リスク情報の変更時。データソースが応答している間のみ利用可能)、ファンド13Fウォッチ(新しい提出書類)、FDA リコールウォッチ(新しいリコール番号)、インサイダー取引ウォッチ(新しい Form 4)、IPO パイプラインウォッチ(週次ダイジェスト)があります。レポートは /m/<id> に届きます。Stripe Customer Portal の /monitors/manage から管理またはキャンセルできます。 |
| agent402.tools/credits | プリペイドクレジット:現在販売していません。すでに発行済みのキー(a402_…)は引き続き使えます。価格が設定された任意のルートに Authorization: Bearer a402_… として送信すると、残高から支払われます。成功した応答の場合にのみ引き落とされます。整数のマイクロドル単位なので、1セント未満の価格も正確に扱え、有効期限はありません。GET /api/credits/balance(同じヘッダーを指定)で残高を確認できます。{reason, balanceUsd, topup} を含む402応答は、残高不足を意味します。アイデンティティにひも付いたツール(/api/memory*、my-usage)では、支払いがアイデンティティそのものとなるためクレジットを利用できません。これらのツールには x402 レールで支払ってください。 |
発行済みのクレジットキーは SDK でも認識されます。agent402-mcp は
AGENT402_CREDITS_KEY を読み取り、agent402-client は { creditsKey } を受け取ります。
判断する - タスクを説明して、プランを取得
POST /api/decide は、平易な言葉で書かれたタスクを、すぐに呼び出せるプランに変換します。使用するツール(このカタログ内のものと、過去1週間に402が検証された外部 x402 販売者のもの)、実行順序、フォールバック、各ツールのスキーマに適合する入力、コストとレイテンシの見積もりを提示します。
深さに応じた料金設定です。quick(最適なツールを1つ)、plan(ステップとフォールバック)、full(コンパイル済みプロンプトも含む)があり、x402 または MPP 経由で判断1回あたり0.005ドルから利用できます。
curl -X POST https://agent402.tools/api/decide \
-H "Content-Type: application/json" \
-d '{"task":"Check whether wallet 0xd8dA...6045 is on a sanctions list, then list its recent token transfers on Base","depth":"plan"}'
- 中立的なランキング。 すべての候補を、適合性、観測された信頼性、価格、スキーマの品質、鮮度に基づく同じ計算式でスコアリングします。ツールの販売者を考慮する項目はなく、各ステップにはツールが自社のものかどうか(
firstParty)が示されます。 - 手数料は戻ってきます。 判断手数料は24時間有効なクレジットとして返還され、プランを実行する
POST /api/decide/executeに利用できます。自社ツールは直接実行し、外部のステップは販売者から購入して、販売者の価格に開示済みの5%のマークアップを加えて再販します。支出は予算の範囲内にとどまり、フォールバックは順番に試されます。どのステップも成功しなかった実行には課金されません。 - MCP では同じ機能の組み合わせが
decide.planとdecide.executeです。decide.feedback(無料)では、ステップが成功したかどうかを記録できます。ページ:agent402.tools/decide。
スキルパック - 70 以上のマルチツールワークフロー
複数のツールにまたがる作業――「ドメインを監査する」「メール配信の問題を診断する」
「時系列データを分析する」「正体不明のデータを解読する」など――に対応するため、
Agent402 は厳選されたスキルパックを提供しています。各パックは、順序と型が定められた
ツール呼び出しの連続と、Claude 向けのプロンプトテンプレートで構成されています。
MCP プロンプト(prompts/list → prompts/get { name, arguments })として、
または GET /api/skill-packs/{slug}/prompt への通常の HTTP リクエストとして呼び出せます
(すべてのスラッグは、無料の JSON インデックス
/api/skill-packs.json に掲載されています)。
タスクに応じたクエリを catalog.search(ホステッドコネクターの検索ツール。以前の名前
search_tools もエイリアスとして引き続き使用できます)に送ると、個別のツールとともに
該当するパックが返されます。
| 注目のパック | チェーン | 用途 |
|---|---|---|
security-audit | cert-transparency · dns-lookup · spf-check · dmarc-check · http-headers · tls-cert · tech-stack | ドメインのセキュリティ状況 |
trend-analysis | stock-history · fred-series · stats-summary · moving-average · linear-regression · outliers · correlation · forecast-eval | あらゆる時系列データの定量分析 |
structured-scrape | extract · render · html-select · html-table · html-strip · html-links · html-meta | 判定手順に沿った決定論的なスクレイピング |
decode-blob | jwt-decode · gunzip · brotli-decompress · base64 · hex · json-format · hash | 正体不明の文字列を特定して解読 |
forecasting-bake-off | stock-history · fred-series · forecast-eval · forecast-naive · forecast-ses · forecast-holt · forecast-holt-winters | 4 つの予測手法を RMSE で順位付けし、最適な手法を選択 |
document-intel | pdf-info · pdf-to-markdown · pdf-extract-pages · image-ocr · barcode-decode · pdf-merge · images-to-pdf | PDF/OCR/バーコード処理パイプライン |
status-snapshot | dns-lookup · http-check · http-headers · tls-cert · robots-check | サービスの正常性を一括チェック |
すべての 80 以上のパックは /skills にあります ·
JSON インデックスは /api/skill-packs.json にあります ·
MCP ではパックが prompts/list に表示されるため、MCP 対応のクライアントなら自動的に取得できます。
x402 インデックス - 検索 · ルーティング · ランキング
Agent402 は、x402 エコシステム全体に対応するオープンなルーティングおよびランキングレイヤーでもあります。
公開されている x402 の販売元(ローカルカタログと、
Coinbase CDP Bazaar から自動検出した販売元。
1 時間ごとに更新)をクロールし、無料で利用できる 3 つのインターフェースを通じて公開します。
ロジックは /api/find と同じです。探索の基本機能に費用はかかりません。
| サーフェス | 内容 |
|---|---|
GET /api/find?q={task} | タスクに最も適したツールを特定します(ルート、価格、スキーマ、すぐに使えるサンプル) |
POST /api/route | スマートオーダールーター:{ query, top, include } → 複数の販売者のツールを順位付けして返します(一致スコア、次に健全性、次に価格の順で評価し、判定モデルが実際にタスクを実行する掲載項目を最上位に移動します。同等の性能なら最安のものを選び、その結果は judged に報告されます)。include=external を指定すると Agent402 自体は除外されます |
GET /api/leaderboard | Base で決済された USDC 取引量に基づく x402 販売者のオンチェーンランキング(販売者ごとの callsSettled、totalUsd、uniqueBuyers)。上位 N 件のみ - デフォルトは 25 件、上限は 50 件。全件数は totalSellers で確認できます。パイプライン:Bazaar → eth_getLogs → 呼び出しごとの上限 → 集計。毎時スナップショット |
/marketplace | 公開 HTML ダッシュボード:全販売者、ツール数、ネットワーク、最終取得時刻、直近の健全性 |
GET /api/index | 販売者インデックスを JSON で返します(合計、販売者ごとの健全性/ルーティング可能フラグ)。ページネーション対応 - 1 ページあたり最大 250 件。残りがある場合は complete: false と rel="next" を含む Link ヘッダーが返され、総数は sellerCount で確認できます。単一オリジンの情報をページ分割せず、クロール履歴とともに取得するには ?seller=<host> を指定します |
/stellar · /algorand | チェーンごとのマーケットプレイスページ:それぞれのレールで決済される販売者とツール |
# "I need an OCR tool - find me the cheapest healthy one anywhere on x402"
curl -X POST https://agent402.tools/api/route \
-H 'content-type: application/json' \
-d '{"query":"ocr image to text","top":5}'
# "Who are the most-used x402 sellers right now? (on-chain proof, not self-reports)"
curl 'https://agent402.tools/api/leaderboard?top=25&include=external'
ディスパッチ対象は明示され、暗黙に決まりません: /api/route の各行と /api/index の各販売者には、routerDispatchEligible と routerDispatchReason(crawl_failed、network_unknown、settlement_required、settlement_checked_at_pay_time、eligible、...)が付与されます。executeVia は、ルーターがその時点ですぐに支払いを実行する行(executeViaCallableNow: true)にのみ表示されます。それ以外の場合は、executeViaWhenEligible に移されます。routable が示すのはクロールの準備状況であり、支払いを約束するものではありません。マニフェストに価格が記載されたルートは、実際の 402 応答もライブで読み取り、その後は毎週再確認されるため、販売者のマニフェストに反映されていない場合でも、実際に提示されるチェーンが行に反映されます。
健全性を考慮: 直近の数回のクロールでエラーが発生した販売者はルーターから除外されます(停止中の販売者にルーティングすると、購入者の費用が無駄になるためです)。健全性の高い販売者は、一致スコアと価格が同じ場合の優先順位にも反映されるため、不安定でも安価な販売者より、信頼性の高い販売者が選ばれます。履歴のない新規販売者は、問題がないものとして扱われます。
適合性の判定: 語句の一致スコアは、掲載項目名にタスクの語句が含まれているほど高くなります。そのため、ある販売者の細分化された 20 個のルートが、タスクを実行できる汎用ツールより上位になることがあります。現在は判定モデルが候補一覧(販売者ごとに最大 2 行と、ローカルカタログの最有力候補)を読み、実際にタスクを実行する掲載項目を最上位に移動します。同等の性能の候補が複数ある場合は、最安のものが選ばれます。このモデルが、決済ゲートで許可されていない販売者を追加することはありません。また、「どれも該当しない」と判断できます(その場合、route-execute は支払いが行われる前に拒否します)。モデルの判定に失敗した場合は、語句一致の順位にフォールバックします。ツール自体は引き続きモデルを実行しません。これはルーターの選択方法に限られます。
運用者向けダッシュボードでは、3 つのレールごとのアトリビューションを確認できます(/api/stats、/__operator。トークンが必要で、運用者トークンがない場合は 404 を返します)。USDC、Proof of Work、ハートビートプローブのトラフィックは個別に集計されます。また、ハートビートのレールには POW_SECRET で署名されたトークンが必要です(偽装可能な User-Agent ではありません)。そのため、運用者ビューには実際の外部需要が反映されます。
API 販売者向け: /sell は販売者向けの入口です。既存の x402 対応 API は、POST /api/index/register でインデックスに無料で登録できます(健全性に基づくルーティング、手数料 0%、セルフサービス、登録不要)。または、agent402-tollbooth(tollbooth)をインストールすると、まだ x402 にネイティブ対応していないサイトに、クロールごとの課金ゲートを設置できます。
コードから使う場合、agent402-client npm パッケージがこれらすべてをラップします。find()でツールを探し、call()で呼び出します。支払いは自動で行われます(無料ツールには組み込みのプルーフ・オブ・ワーク、有料ツールには x402 ウォレットを使用)。キャッシュと冪等性のある再試行にも対応しています。
npm install agent402-client
import { Agent402 } from "agent402-client";
const a = new Agent402(); // free tier (proof-of-work)
const out = await a.call("hash", { text: "hello world", algo: "sha256" });
// a prepaid credits key already issued pays wallet-only tools (new credits are not on sale)
const b = new Agent402({ creditsKey: "a402_..." });
リアルタイムの支払いビュー(services/live)
Base 上の x402 支払いと Tempo 上の MPP 支払いが決済される様子を表示する、読み取り専用の独立したサービスです。公開チェーン RPC と公開ディスカバリーリストを読み込み、直近1時間分をメモリに保持し、単一のサーバー送信イベントストリームを通じてブラウザーに配信します。API とはプロセス、データベース、キーを共有しません。https://live.agent402.tools でホストされています。
ローカルで実行します(Node 22 以上、依存関係なし)。
cd services/live
PORT=8090 node server.js # then open http://localhost:8090
node test.js # offline tests
任意の設定:LIVE_BASE_RPCS と LIVE_TEMPO_RPCS(カンマ区切りの RPC URL)、LIVE_INCLUDE_UNLISTED=1(ディスカバリーリストに名前がないウォレットへの Base 支払いもカウントします)、LIVE_INTERNAL_PAYERS(テストトラフィックとしてラベル付けする支払者ウォレット)、LIVE_MAX_PAYMENT_USD(デフォルトは 50)。
エージェントフレームワークに組み込む(依存関係ゼロのアダプター)
以下のスタック(OpenAI、Anthropic、Vercel AI SDK、LangChain(JS または Python)、LlamaIndex、Strands、Google ADK、OpenAI Agents SDK)のいずれかをすでにお使いなら、接続処理は不要です。Agent402 カタログをフレームワークのネイティブなツールオブジェクトに変換する、すぐに使えるパッケージがあります。支払い処理も内部で行われます(無料ツールにはプルーフ・オブ・ワーク、@x402/fetchを渡した場合は x402+USDC)。
| スタック | npm | 戻り値 |
|---|---|---|
| OpenAI function-calling(chat.completions / Assistants v2 / Responses) | agent402-openai-tools | tools:パラメーター用のtools[] |
Anthropic Messages API(tool_use) | agent402-anthropic-tools | tools:パラメーター用のtools[] |
Vercel AI SDK(streamText / generateText) | agent402-ai-sdk | Record<name, tool()> |
| LangChain JS / LangGraph | agent402-langchain | DynamicStructuredTool[] |
| LlamaIndex TS | agent402-llamaindex | FunctionTool[] |
| Strands Agents(AWS Bedrock AgentCore) | agent402-strands | new Agent({ tools })用のStrandsTool[] |
| Google ADK(Agent Development Kit) | agent402-google-adk | ADK エージェント用のFunctionTool[] |
| OpenAI Agents SDK | agent402-openai-agents | @openai/agents用のAgent tools |
| Coinbase AgentKit(CDP、Privy、ZeroDev、viem ウォレット) | agent402-agentkit | AgentKit.from({ actionProviders })用のActionProvider |
| LangChain Python / CrewAI | agent402-langchain(PyPI) | Agent402Toolkit.get_tools()によるStructuredTool[]。4つのメタツール(find / route / call / about)で、スラッグごとのツールではありません |
// e.g. OpenAI - every adapter has the same surface.
import OpenAI from "openai";
import { agent402Tools } from "agent402-openai-tools";
const openai = new OpenAI();
const { tools, execute } = await agent402Tools({ slugs: ["extract", "hash", "render"] });
const res = await openai.chat.completions.create({ model: "gpt-4o-mini", tools, messages: [...] });
// when the model returns a tool call: await execute(call.function.name, JSON.parse(call.function.arguments));
Claude/MCP をすでにお使いですか?agent402-mcpが引き続き最適な方法です。クライアントにhttps://agent402.tools/mcpを貼り付けてください。アダプターは、MCP が利用できない直接 API 統合向けです。ソース:adapters/。
OpenClaw エージェント:skills/openclaw/agent402/SKILL.mdを追加してください。OpenClaw エージェントが、500 以上のツールやパックを検索し、支払い(Base 上の x402 USDC、ほかに11のチェーンに対応、または無料のプルーフ・オブ・ワーク)を行い、呼び出せるようになります。
独自のツールを追加する(約15行)
ツールはキット配列内のオブジェクトにすぎません。これを
src/tools/ 内の任意のファイルに追加すると(例:src/tools/agent-kit.js の AGENT_TOOLS に追記)、
すぐに利用できます。ルーティング、スキーマの公開、MCP への公開が行われ、
「すべてのツールが独自の例に回答する」CI チェックの対象にもなります。
{
route: "POST /api/reverse",
name: "Reverse text",
slug: "reverse",
category: "text",
price: "$0.001", // free via proof-of-work for pure-CPU tools
description: "Reverse a string. Example: {\"text\":\"abc\"} → {\"reversed\":\"cba\"}",
discovery: {
inputSchema: { properties: { text: { type: "string" } }, required: ["text"] },
example: { text: "abc" }, // CI calls this and checks it works
},
handler: (input) => {
if (typeof input.text !== "string") { const e = new Error('"text" required'); e.statusCode = 400; throw e; }
return { reversed: [...input.text].reverse().join("") };
},
}
これが契約のすべてです。handler(input) は JSON にシリアライズ可能なオブジェクトを返すか、
4xx の場合は .statusCode を持つ Error をスローします。CPU のみを使うツールは
自動的にプルーフ・オブ・ワークによる無料利用の対象となります。ネットワークやディスクにアクセスする
ツールは、引き続きウォレットのみで利用できます。詳しい手順については、CONTRIBUTING.md をご覧ください。
オプション:x402 で呼び出しごとに課金する
同じサーバーで呼び出しごとに支払いを要求できます。公開インスタンスをホストする場合に便利です。
支払いはデフォルトで必須です。npm start をそのまま実行するとフェイルクローズとなり、
WALLET_ADDRESS が設定されていない場合は終了します。支払いなしで実行するには、
明示的なオプトインが必要です(FREE_MODE=true npm start)。課金するには、WALLET_ADDRESS
と CDP ファシリテーターのキーを設定します(portal.cdp.coinbase.com で無料)。
エージェントは標準の x402 クライアントを使って、Base 上の USDC(または Solana、Polygon、Arbitrum、Monad、Celo、Avalanche、Sei、Optimism、Arc、Stellar、
Algorand 上の USDC、あるいは PAYMENT_NETWORKS=…,robinhood と
ROBINHOOD_FACILITATOR_URL を介した Robinhood Chain 上の USDG)で支払います。
すべての 402 は @x402/core 独自のスキーマに準拠しており(最大5つのタグ、すべてのルートで CI によるチェック済み)、
型付き出力スキーマを2か所に含みます。bazaar 検出拡張と、最初の accept における
accepts[0].outputSchema です。そのため、仕様のこのフィールドを読み取るクライアントは、
支払い前にレスポンスの形式を確認できます。
オプション:GATEWAY_NANOPAYMENTS=on を設定すると、Arc と Base で通常の accept に加えて
Circle Gateway のバッチ accept が追加されます(価格と payTo は同じです。Gateway に USDC を入金した購入者は
ガス代なしで呼び出しごとに署名でき、Gateway がオフチェーンで精算して Gateway 残高に入金します。
残高は scripts/gateway-withdraw.js で引き出せます)。デフォルトでは無効です。wiki の Self-Hosting ページをご覧ください。
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/extract", {
method: "POST", headers: { "Content-Type": "application/json" },
body: JSON.stringify({ url: "https://agent402.tools/guides/x402-in-5-minutes" }),
});
MPP のデュアルスタック対応。 ペイウォールは MPP(Machine Payments Protocol — tempoxyz/mpp の
IETF 標準化トラックにある Payment HTTP 認証スキーム)にも対応しています。
同じ 402 に WWW-Authenticate: Payment チャレンジが含まれ、Authorization: Payment 認証情報で精算され、精算済みのレスポンスでは Payment-Receipt が返されます。
MPP にはここで2つの方式があります。evm は x402 と同様に精算されます(EIP-3009 USDC、
同じファシリテーター、同じ価格)。tempo は Tempo 独自のリレーを通じてネイティブに精算されます
(TIP-1034/TIP-20、x402 ファシリテーターは不要)。これは完全に独立した精算経路であり、
有効にするには TEMPO_API_KEY を設定します。どちらの方式でも mppx
クライアントはそのまま利用できます。独自のインスタンスでシムを有効にするには
MPP_SECRET_KEY を設定します。どちらの方式でも URL は同じです。購入者のクライアントが方式を選択します。
ウォレットを持たないエージェントも、1回限りの sha256 プルーフ・オブ・ワークを解くことで、 CPU のみを使うすべてのツールを利用できます(ノート PC なら1秒未満で完了します。MCP サーバーが自動で処理します)。詳しくはこちら: wiki:x402 での支払い · MPP での支払い · コンピューティングによる支払い。
ここで支払う理由 — 他とは違う7つの点
すべての主張には、その根拠を確認できる場所(公開中のバージョン、ホームページの該当セクション:agent402.tools/#why)へのリンクがあります。
- モデルが使った分だけ支払い、上限額は事前に提示されます。 従量課金ゲートウェイ(
POST /v1/metered/chat/completions)は、リクエスト本文に基づいて各402の料金を提示します。uptoを支払うウォレットでは、上限額の範囲内で実際の使用量に応じて決済され、プロンプトキャッシュの読み取りなどのプロバイダー割引もそのまま反映されます。決済済みのx402またはMPPレスポンスにはすべてレシートが付与されます。EVMウォレットで購入したJSON回答は、そのウォレットによってBase上で証明できます(POST /api/attest)。 - 失敗したx402呼び出しには課金されず、レスポンスがそれを証明します。 決済はハンドラーの実行後に行われ、エラーステータスの場合は取り消されるため、支払いレシートがないレスポンス、または
success:falseと記されたレシートは、資金が移動していないことを示します。同じIdempotency-Keyと同じ支払い認証情報を付けて再試行すると、再度支払うことなく、支払い済みの回答が再送されます。また、同じ署名済みEVM決済でリクエストを再送した場合は、キーがなくても最初の回答が返されます(X-Replayed-Answer: 1)。残る唯一のケース(エラーレスポンスに決済済みレシートが付く場合)は、当社のアラームが検知し、返金台帳に債務として記録します。黙って損失処理することはありません。 - 1つのキーですべて購入できます。 同じウォレットで、4つのプロトコル(OpenAI Chat、OpenAI Responses、Anthropic Messages、Gemini generateContent)に対応する5つのLLMティア、埋め込み、リランキング、画像、動画、音声、文字起こし、出典付きの根拠ある回答、500以上のツール、完成済みレポートを購入できます。また、EVMウォレットは独自のメモリーのキーにもなります。
- ウォレットは不要です。 純粋なCPU処理のツールはプルーフ・オブ・ワークで利用でき、MPP経由のカード決済では0.50ドル以上の料金のルートを利用できます。また、カード決済で完成済みレポートを購入できます。これらに加えて、13チェーンのUSDCまたはUSDG、Tempo上のネイティブMPPにも対応しています。
- すぐに使える完成済みの成果物。 ライブソースに基づく企業調査資料、インサイダー取引フロー、13F保有状況、提出書類レポート、IPOダイジェスト、ドメイン監査、トークンリスク、詳細調査、市場概要、リコール監視、LinkedIn記事パッケージを提供します。ほとんどの成果物にはダウンロード可能なデータ付録が付属します。モニターはスケジュールに沿って無料で確認を行い、情報に変更があれば有料レポートを再実行します。30日間で最大4件の完全なレポートを利用できます。
- 他の販売者からも調達します。
POST /api/route/executeはタスクに最適なエコシステム内の販売者を特定し、当社のウォレットでその販売者から結果を購入して、1つのレシートでお客様に販売します。販売者をルーティング対象にするには、オンチェーン決済の実績が必要です。ただし、少額の1回あたり上限額のもとでは、実績のないBaseまたはSolanaの販売者にも例外的に対応します。 - すべて検証できます。 本番環境外の2つのプローブで稼働時間を監視し(
/status)、毎日すべてのオンチェーン決済ルートで実際の資金を使ったカナリアテストを行い、トランザクションを決済ルートおよびプロトコル別に公開しています([/revenue](https://agent402.tools/revenue)。オープンソースで、セルフホスト可能です。決定論的なツールはモデルを実行しません。モデルを実行するものは明示しています(/v1の各ティア、レポート製品、画像、音声、文字起こし、埋め込み、AI回答の各ツール、Decideプランナー、およびルーターの絞り込み済み候補から選択できる判断モデル)。運営者はオンチェーンで識別できます。Agent402はBaseのERC-8004 Identity Registryにおけるエージェント94639で、/.well-known/agent-registration.jsonに解決されます。また、/.well-known/agent-card.jsonにA2Aエージェントカードがあります。
信頼できる理由
- すべてをテスト - CI では、サードパーティーのキーが不要なすべてのツールを、各ツールでドキュメント化されている例を使って呼び出し、いずれかが失敗するとリリースを停止します。キーが必要なツールとモデルを利用するツールについては、CI がサードパーティーのキーを保持しないため、入力プローブと毎日の有料カナリアテストで確認します。本番環境の外部にある独立した2つのプローブが稼働中のインスタンスを監視します(片方は5分ごとに確認し、もう片方とは別のインフラを使用)。観測結果は
/statusで公開されています。観測がない日は「データなし」と表示され、稼働時間とはみなされません。停止中にはプローブが報告できないからです。 - 堅牢なセキュリティ - URL を扱うすべてのツールに接続時の SSRF ガード(DNS リバインディング対策済み)を実装し、署名付き・単回使用・スラッグ単位のプルーフ・オブ・ワーク、IP ごとのレート制限、セキュリティヘッダーを備えています。wiki: Security Model をご覧ください。
- 決定論的なユーティリティ - ユーティリティツールの実行経路ではモデルを使用しません。純粋計算ツールは同じ入力に対して常に同じ出力を返し、ライブデータツールはデータソースの現在の値を返します。OpenAPI スキーマも完備しています。
- 監査可能なオンチェーン収益 - Base での有料呼び出しは USDC で
agent402.base.ethに決済されます(この Base 名は公開受取ウォレットを指します)。その他のチェーンの受取アドレスは、稼働中の402レスポンスと/.well-known/x402に記載されているため、誰でもオンチェーンで確認できます。稼働中の利用数は/api/statsで確認できます。 - AGPL-3.0 ライセンスで、セルフホストに適しています - クローンして、不要なものを取り除き、必要なものを追加できます。
x402 エコシステムにおける Agent402
x402 は、HTTP 402 Payment Required を基盤とするオープンな決済プロトコルです。機械間でのステーブルコイン(USDC)による従量課金に対応しています。この分野のプロジェクトの多くは、プロトコル + SDK、スターターテンプレート、または決済ファシリテーターです。Agent402 は実用レイヤーです。プロトコルに対応し、500以上の動作するツールを備えた、すぐに実行できる x402 サーバーなので、カタログを自分で構築する必要はありません。
- プロトコルまたは SDK をお探しですか? → coinbase/x402。
- x402 + MCP を使って実際に動作するサーバーを今すぐ実行したいですか? → ここがそのサーバーです。
- セルフホスト可能で、ウォレットがなくてもプルーフ・オブ・ワークで無料利用できます。また、決済ツールは非カストディアルです(エージェントは自身のキーで署名し、こちらはエージェントの暗号資産残高を預かりません。プリペイドカードのクレジットは預かり残高であり、その旨を明記しています)。
公式 MCP Registry に登録されており、Coinbase の x402 Bazaar からも見つけられます。
AWS Bedrock AgentCore Payments でそのまま動作します - AgentCore は、Agent402 がすでに対応しているプロトコルである x402 をオーケストレーションします。AgentCore Gateway を https://agent402.tools/mcp に接続すれば500以上のすべてのツールを利用できます。または agent402-strands を使って、Strands エージェント内で厳選されたツールを利用できます。5分でできる手順は wiki: AWS Bedrock AgentCore をご覧ください。
Tollbooth - あなたのサイトのクロールごとの課金(x402のもう一方の側面)
あなたのサイトにアクセスするAIクローラーに課金します。人間は無料で閲覧でき、既知のボットには
402 Payment Required を返して、x402経由でUSDCを支払うか、無料の
プルーフ・オブ・ワークを解くよう求めます。Cloudflareのクローラーごとの課金というクローズドな仕組みに対する、オープンで暗号資産ネイティブな選択肢です。CDNへのロックインも、Stripeも、販売者記録代行も、サインアップもありません。
- 製品ページ・料金・すぐに使えるインストール: agent402.tools/tollbooth
- 自分で実行(MIT、npm):
npm i agent402-tollbooth·tollbooth/· tollbooth/README.md
Expressミドルウェア、Next.js / Vercel Edgeミドルウェア、Cloudflare
Worker、リバースプロキシ、またはWordPressプラグイン(ベータ版)として動作します。
すぐに導入できるテンプレートはtollbooth/deploy/にあります。すべてを1つのWeb-Cryptoコアで動かします。
0.9.x以降、このゲートはMPPにもネイティブ対応しています。@x402/expressミドルウェアを渡すと(createTollbooth({ x402 }))、同じ402からWWW-Authenticate: Payment evmチャレンジを発行します。または、Tempoリレーキー(createTollbooth({ tempo: { apiKey, recipient, currency, splits } }))を渡すと、x402ミドルウェアなしでTempo上のMPP tempo/charge 認証情報を精算でき、任意で支払いを分割できます。
0.10.0以降、エッジビルドもMPPに対応しています。secret、payTo、verifyX402コールバックを設定すると、すべての402にx402の見積もりと並んでWWW-Authenticate: Paymentチャレンジが含まれます。さらに、そのチャレンジにHMACで紐付けられ、有効期限内で、対象のリソース専用に発行されたAuthorization: Payment認証情報はPAYMENT-SIGNATUREに変換され、同じ検証関数に渡されます。
<<|>>## リポジトリ構成
| パス | 内容 |
|---|---|
src/server.js | Express アプリとツールカタログ(ルート、価格、スキーマ、検出) |
src/tools/ | ツールキット(ウェブ、PDF、メディア、画像、ライブデータ、暗号資産/x402、CPU のみで動作するユーティリティ 150 種以上)- ツールはここに追加してください |
src/mcp-http.js | ホスト型 MCP コネクター(ストリーミング可能な HTTP、無料枠は認証不要) |
src/pow.js | Proof-of-work 層(署名付き、使い捨て、スラッグ単位のチャレンジ) |
src/payments.js | オプションの x402 v2 接続:Base/Solana/Polygon/Arbitrum/Monad/Celo/Avalanche/Sei/Optimism/Arc/Stellar/Algorand 上の USDC と Robinhood Chain 上の USDG(13 チェーン)、CDP ファシリテーター、Bazaar による検出 |
src/mpp-shim.js, src/mpp-tempo.js, src/mpp-stripe.js | 同じルートでの MPP:x402(evm)に変換される Payment チャレンジ/認証情報、Tempo のリレーを介したネイティブ Tempo 決済、MPP 経由の Stripe カード |
src/x402-index.js | x402 Index + Smart Order Router:販売者をまたいだクロール、自動検出、稼働状況を考慮したルーティング、チェーンごとのマーケットプレースページ(/stellar、/algorand) |
src/sell.js | /sell - 販売者向けの入口:無料のセルフサービス登録(POST /api/index/register)、またはクロールごとの課金に対応する agent402-tollbooth |
src/human-checkout.js | レポート製品向けカード決済の入口:/reports(ページは src/human-reports-page.js)、POST /api/buy、/r/:sessionId での配信(Stripe Checkout、一度だけ生成、失敗時は自動返金) |
src/stripe-subscriptions.js | /monitors - 月額 5 ドルのモニターサブスクリプション(MONITOR_PRODUCTS:domain、filing、token、fund、recall、insider、ipo)、署名検証済みウェブフック、カスタマーポータル |
src/monitor-scheduler.js | モニターの履行処理:低コストな日次プローブ、変更時の有料再実行、メール配信、/m/:id でのレポート |
src/credits.js | プリペイドカードクレジット:/credits、a402_ ベアラーキー、価格設定されたすべてのルートの前段にある認可後に引き落とすゲート |
mcp/ | agent402-mcp npm パッケージ(stdio MCP サーバー) |
client/ | agent402-client 購入者向け SDK(自動決済に対応した find() + call()) |
tollbooth/ | agent402-tollbooth のクロールごとの課金ゲート(Express / edge / proxy) |
adapters/ | 上記のアダプターテーブルにあるすべてのフレームワーク向けのドロップインツール(npm、および LangChain/CrewAI Python 用の PyPI パッケージ langchain-py) |
wiki/ | GitHub wiki のソース(CI で同期) |
scripts/ | テスト、デモ、運用ツール |
法的事項
- agent402.tools のホスト型インスタンスは、 利用規約(許容される利用に関するポリシーを含みます。プログラムによる利用を含め、本サービスを利用すると規約に同意したものとみなされます)および プライバシーポリシーに基づいて提供されます。
- AI ゲートウェイのトラフィック(
/v1のチャット、埋め込み、画像、音声)には、上流のモデルプロバイダーの利用ポリシーも適用されます。禁止コンテンツに使用されたウォレットは、決済前にブロックされます(WALLET_BLOCKLIST)。 - サーバーコードは AGPL-3.0 ライセンスで、現状のまま提供されます。公開されている各 npm パッケージは MIT ライセンスで、それぞれのディレクトリに独自の LICENSE ファイルがあります:
agent402-mcp(mcp/)、agent402-client(client/)、agent402-tollbooth(tollbooth/)、agent402-openclaw(openclaw/)、agent402-agentkit(adapters/agentkit/)、elizaos-plugin-agent402(adapters/eliza/)、およびファシリテーター(facilitator/)。GitHub のリポジトリレベルのライセンスバッジはサーバーの AGPL を示します。各パッケージには、そのパッケージのlicenseフィールドとディレクトリ内の LICENSE が適用されます。保証なしで現状のまま提供されます(LICENSE と NOTICE を参照)。「Agent402」とロゴは Havok Holdings LLC の商標です。ライセンスの対象はコードであり、名称ではありません。フォークでは名称を変更する必要があります(TRADEMARKS.md を参照)。 セルフホストする場合、運用者はあなたです。デプロイ、利用規約、コンプライアンスはあなたの責任です。 Havok Holdings LLC が運用するのはホスト型インスタンスのみであり、第三者によるデプロイには責任を負いません。
お問い合わせ
- メール: [email protected]
- X / Twitter: @Agent402Tools
- GitHub: MikeyPetrillo/Agent402
コントリビューション
便利なツールの追加、バグの修正、ドキュメントの改善を目的とした PR を歓迎します。CONTRIBUTING.md をご覧ください。サーバーは AGPL-3.0、公開されている各パッケージは MIT です(上記の「法務」をご覧ください)。Havok Holdings LLC がメンテナンスしています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。