gold402-mcp

gold-402 をベースにしたMCPサーバー — 24K Labs が管理するキュレーション済みx402ディレクトリです。MCP対応のエージェント（Claude、Cursor、その他MCPを話せるもの）に、x402サービスを検索し、お金を使う前にエンドポイントを確認するための4つのツールを提供します。

ステータス: v0.1 — テスト済み、パッケージ化済み、未公開。 stdio上で動作します。

ツール

無料 vs 有料

5つのツールのうち4つは無料で、今後も無料です — 検索、シェルフ、エントリ参照、ライブプローブ。キー不要、ウォレット不要、アカウント不要。

gold402_verdict は有料: Base上の0.001 USDC。 唯一の有料ツールであり、無料プローブが明示的に提供しないもの — 人間の判断 — を購入します。有効な402はドアが機能することを証明しますが、判定はメンテナーが「見知らぬ人のお金を払う価値がある」と認めたことを意味します。

このサーバーはウォレットを保持せず、あなたに代わって支払いを行うことはありません。 gold402_verdict を payment_signature なしで1回呼び出すと、デコードされたx402条件 — 価格、ネットワーク、アセット、payTo、タイムアウト — が返されます。自分のウォレットで署名し、シグネチャを付けて再度呼び出してください。お金はあなたから24K Labsへ直接送金されます。このプロセスは経路に含まれません。

gold402_check_endpoint は、メンテナーが実行するドアチェックを呼び出し可能にしたものです。ディレクトリにないエンドポイントでも動作します。これがポイントです: 見知らぬ人に支払おうとしているエージェントは、まず確認できるのです。

Related MCP server: Secant Agent Research

回答が主張すること、主張しないこと

掲載されているということは、メンテナーがプローブし、レビュー時点でx402リクエストに正しく応答したことを意味し、定期的に再プローブしています。これはプロバイダーの監査、稼働時間の保証、または呼び出しが成功するという約束ではありません。有効な402はドアが機能することを証明します — サービスが成果を提供することを証明するものではありません。すべての応答には as_of スタンプと、その情報の出所が含まれます。

ディレクトリにないことは、サービスに対する否定的な判定ではありません。これはキュレーションされたリストであり、全数調査ではありません。

インストール

uvx gold402-mcp            # no install step
pip install gold402-mcp    # then run: gold402-mcp

クローンから:

python3 -m venv .venv && ./.venv/bin/pip install -e .
./.venv/bin/gold402-mcp

クライアント設定

Claude Desktop / Claude Code（claude_desktop_config.json または .mcp.json）:

{
  "mcpServers": {
    "gold402": {
      "command": "uvx",
      "args": ["gold402-mcp"]
    }
  }
}

pipがお好みですか? インストールしてから、引数なしで "command": "gold402-mcp" を使用してください。

データソース

https://24klabs.ai/directory.json — 公開、発行済み、15分キャッシュ。キー不要、認証不要、スクレイピング不要。フェッチが失敗し、キャッシュコピーが存在する場合は、キャッシュコピーが提供され、その古さが隠蔽されることなく開示されます。

カバレッジを明確に説明します。 そのエンドポイントは意図的な プレビュー です: 完全なシェルフ構造と真のシェルフごとのカウントを含みますが、レコードとしては直近に掲載されたエントリのみを含みます。24K Labsは匿名の呼び出し元に完全なセットを一括提供していません（理由）。したがって、このサーバーは持っていないものを暗示しません:

• すべての応答は、キュレーションされた合計と実際に検索されたエントリ数の両方を報告します;

• プレビューレコードのないシェルフは、空または存在しないシェルフとしてではなく、カバレッジの制限として報告されます;

• プレビュー外のものについては: https://24klabs.ai/directory を閲覧するか、/api/v1/verify?resource=<url> で1つのリソースを検索するか、gold402_check_endpoint を使用してください。これは掲載の有無にかかわらず任意のエンドポイントで動作します。

テスト

./.venv/bin/python test_tools.py    # tool-level, incl. error paths
./.venv/bin/python test_stdio.py    # end-to-end over the real MCP protocol

両方とも2026-08-20時点でパスしています。インストール済みのコンソールスクリプト（クリーンなvenv、ビルド済みホイールからの pip install）に対してもパスしています — ソースファイルだけでなく。

キュレーション: 24K Labs · ディレクトリ: https://github.com/Haustorium12/gold-402