mcpField
4
402xAgent

402xAgent

リモート
402xagent.com開発ツール1今日更新
リポジトリ公式サイト

402xAgent について

402xAgentは、x402従量課金サービスのカタログと自動チェックの事実結果をまとめ、支払い、見送り、再確認の判断を支援します。API、ウェブサイト、MCPから検索でき、価格、ネットワーク、署名付きレシートを確認できます。

主な機能

  1. 01x402カタログの検索と絞り込み
  2. 02支払い・見送り・再確認の判定を表示
  3. 03提示価格、ネットワーク、見送り理由を掲載
  4. 04Ed25519署名付きレシートを付与
  5. 05有料呼び出しの検証結果を検索
  6. 06機械可読なカタログファイルを公開

活用シーン

  1. 01支払い前にタスクと価格でサービスを絞る
  2. 02条件が古い場合にエンドポイントを再確認
  3. 03タスクに合う検証済みサービス結果を探す

MCP 対応

リモートMCPサーバーは`search_catalog`、`get_service`、`lookup`ツールを提供します。`lookup`は無料枠を使い、枠を使い切ると代わりに支払わずHTTP 402を返します。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://api.402xagent.com/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

すべてのエンドポイント
Streamable HTTPhttps://api.402xagent.com/mcp
Streamable HTTPhttps://verified-catalog-lookup.withgrokbot.workers.dev/mcp

ツール

7
パラメーター型必須説明
limitintegerいいえ任意。結果の最大数。1~100(デフォルトは 20)。
querystringいいえ任意。スペース区切りの語を指定します。各語はサービス ID、名前、カテゴリ、説明、またはプロバイダーに含まれている必要があります(大文字と小文字は区別しません)。省略するとすべて表示します。例:"search"、"crypto news"。
categorystringいいえ任意。サービスカテゴリに含まれる、大文字と小文字を区別しない部分文字列です。例:"web search"、"news"、"on-chain data"、"weather"、"public records"、"utility"。
max_price_usdnumberいいえ任意。1 回あたりの公表価格が指定した USD 額以下のサービスのみを残します。例:0.01。
reachable_onlybooleanいいえ任意(デフォルトは false)。true の場合、最新のチェックで到達可能だったサービスのみを残します。

詳細

検証済み従量課金カタログ

AI エージェント向けの従量課金(x402)サービスをまとめた、静的で機械可読なカタログです。独自の自動チェックによる事実に基づく結果を掲載しています。@WithGrokBot が公開しています。

検索(判定で絞り込んだインデックス)。 GET https://api.402xagent.com/v1/discover?q=<terms>&verdict=pay|skip|recheck&limit=<n> で、2026 年 10 月 20 日のクロールで収集した 122,891 件の x402 エンドポイントを検索できます。これは単なるディレクトリではありません。各結果には、pay、skip、recheck のいずれかの判定、skip の理由、クロール中にエンドポイントのライブ 402 レスポンスで提示された価格、ネットワーク、ed25519 署名付きのレシートが含まれています。結果は無償のクロールプローブによる事実であり、推奨ではありません。利用条件が 7 日より古い pay は recheck(reason_code terms_stale)として返されるため、支払いの直前に無料チェック(各結果の check_url、または MCP ツール endpoint_spot_check)を実行してください。MCP ツール discover としても https://api.402xagent.com/mcp で利用できます。— withgrokbot

1 行で試す

直近の有料呼び出しで、0.01 ドル以下で正常に動作した x402 のウェブ検索エンドポイントはどれですか?キー不要。クライアントごとに UTC 日あたり 5 回まで無料で検索できます。

curl -s "https://verified-catalog-lookup.withgrokbot.workers.dev/v1/lookup?task=web-search&max_price=0.01&ref=via-readme"
const r = await (await fetch("https://verified-catalog-lookup.withgrokbot.workers.dev/v1/lookup?task=web-search&max_price=0.01&ref=via-readme")).json();

結果は直近の有料呼び出しにおける既知の回答の合格率、次に価格の順で並び、各結果には Base の決済レシートが含まれます。その他のタスク:/v1/tasks。任意の client=<your agent name> を指定できます。ref はリンクの入手元を示すだけです。

料金

  • クライアントごとに UTC 日あたり 5 回まで無料で検索できます。 クライアントとは、指定した場合は送信された client の値、指定しない場合は IP のソルト付きハッシュです(生の IP アドレスは保存されません)。カウンターは UTC の 00:00 にリセットされます。課金対象は /v1/lookup のみです。/v1/tasks、/openapi.json、静的カタログファイルは引き続き無料です。
  • それ以降は、x402 経由で検索 1 回につき Base 上の 0.02 ドル分の USDC が必要です。 検索に対して、v2 PAYMENT-REQUIRED ヘッダー(exact スキーム、eip155:8453、USDC、payTo 0x37cfCC8a29e9ff9458902B29E31E42dc7B718674)を含む HTTP 402 が返されます。PAYMENT-SIGNATURE(または X-PAYMENT)ヘッダーを付けて再試行してください。支払いは公開 PayAI x402 ファシリテーターを通じて検証・決済され、決済トランザクションは PAYMENT-RESPONSE ヘッダーとレスポンスの access ブロックに返されます。
  • 支払いによって結果、並び順、掲載内容が変わることはありません。 購入できるのはクエリへのアクセスのみです。無料、有料、免除対象の検索は、同じデータに対して同じコードを実行し、同一の結果を返します。販売者が掲載順位を購入することはできず、チェック結果や既知の回答の結果が支払者によって変わることもありません。すべての検索レスポンスで、この内容が payment_policy に繰り返し記載されます。

リモート MCP サーバー(無料)

https://verified-catalog-lookup.withgrokbot.workers.dev/mcp(Streamable HTTP、ステートレス JSON-RPC、キー不要)。mcp/server.py と同じ 3 つのツールと結果を提供します:search_catalog、get_service、lookup。lookup はクライアント名 vc-mcp を使用するため、そのクライアントの UTC 日あたり 5 回の無料検索枠を共有します。上限に達すると 402 を報告し、支払いは行いません。レジストリ名:io.github.withgrokbot/verified-catalog(server.json)。

常時有料のエンドポイント(x402)

GET https://verified-catalog-lookup.withgrokbot.workers.dev/v1/lookup/paid?task=web-search&max_price=0.01 は /v1/lookup と同じパラメーターを受け取り、同じ結果を返します。無料枠はなく、呼び出し 1 回につき Base 上の 0.02 ドル分の USDC が必要です。402 には x402 Bazaar の検出メタデータ(extensions.bazaar)が含まれます。また、/openapi.json(x-payment-info)と /.well-known/x402 にも掲載されています。不正なパラメーターの場合、決済処理の前に 400 が返されます。

製品

同じ Worker を通じて x402 で販売される有料デジタルダウンロードです(常時有料。無料検索枠と SELF_CLIENTS は適用されません)。

  • Chief of Staff 一晩セットアップパック — Base 上で $9 相当の USDC。GET https://verified-catalog-lookup.withgrokbot.workers.dev/v1/products/overnight-cos-pack(または MCP ツール get_overnight_cos_pack)。未払いの呼び出しには、Bazaar の検出メタデータを含む HTTP 402 が返されます。支払い後に、プロンプト、HTML の朝のブリーフィング用テンプレート、PDF ガイドを利用できます。

ファイル

  • index.html、services/<id>.html、methodology.html:サイト(JavaScript なし、他のホストへのリクエストなし)
  • catalog.json、services/<id>.json、llms.txt、.well-known/agent-card.json:機械可読データ
  • data/services.json:初期掲載データ(各項目に出典と取得日を記載)、data/site.json:ブランド/リポジトリ設定
  • results/latest.json、results/history.jsonl、results/raw/<run>/<id>.json、results/spend_ledger.json:チェック結果と証拠
  • scripts/run_checks.py:チェックを実行(デフォルトでは無料/ドライラン)して再構築、scripts/build_site.py:再構築のみ
  • data/quality_tests.json、scripts/quality.py:有料の呼び出しごとに実行する既知の答えテスト(合格/不合格。動作しないサービスは「事実のみ」)
  • receipts.json:すべての有料呼び出し(時刻、請求額、Basescan リンク付きの決済 tx、配信済みかどうか、既知の答えの結果)
  • worker/:信頼性の検索機能を提供する Cloudflare Worker(GET /v1/lookup?task=web-search&max_price=0.01&n=5)。このサイトの catalog.json と receipts.json を読み込み、異なるクライアント数を集計します(worker/README.md を参照)
  • mcp/server.py:search_catalog、get_service(catalog.json を読み込み)、lookup(Worker を呼び出し)を備えた小規模な stdio MCP サーバー。Worker は /mcp で同じツールをリモート提供します
  • server.json:公式 MCP Registry エントリー(リモートサーバー)
  • scripts/demand_weekly.py:異なる検索クライアント数を週ごとに集計し、results/demand_weekly.json に出力
  • .github/workflows/daily.yml:毎日の無料チェックとコミット

実行

python3 scripts/run_checks.py            # free checks, no payment (default)
python3 scripts/build_site.py            # rebuild pages from data/ and results/
python3 tests/run_tests.py               # acceptance tests (Node 18+ for the Worker tests)

有料チェックは利用できますが、デフォルトでは無効です。--pay、このフォルダーの外にあるウォレットファイル(--wallet)、および pip install -r scripts/requirements-pay.txt が必要です。上限:1 回あたり $0.10、UTC 日あたり $1.00、累計 $20.00。Base 上で署名されるのは USDC の「exact」のみです。

評価は行わず、事実のみを公開します。顧客の資金は保有せず、販売者との取引の当事者にもなりません。無料枠を超えた検索手数料は、当社のウォレットに入ります。結果に異議がある場合は、GitHub issue を作成してください(methodology.html#contest を参照)。

ライセンス

MIT。LICENSE を参照してください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。