nsgoods-workbench-mcp

nsgoods Workbench MCP

x402 カタログの週次スキャン結果を読み取り専用で提供するインデックスです。支払い可能なエンドポイント、その料金、利用できなくなったホストを確認できます。
ウォレットもサインインも不要です。このサーバーは決済を処理しません。

回答できる内容

x402 カタログの週次全件スキャンを対象とする、ホスト型の Model Context Protocol サーバーです。このエンドポイントは支払い可能か、料金はいくらか、利用できなくなったホストはどれか、キーワードに一致するエンドポイントはどれか、署名付き nsgoods レスポンスをオフラインで検証できるかを確認できます。

ホスト型エンドポイント：https://mcp.nsgoods.org/mcp（Streamable HTTP、サインイン不要、1 IP あたり1日300回のツール呼び出し）。ランディングページとドキュメント：https://mcp.nsgoods.org/ · ヘルスチェック：https://mcp.nsgoods.org/health

データは直近の全件スキャン時点のものです。すべての回答に as_of とスキャン ID が含まれます。支払い前に単一のエンドポイントをリアルタイムで確認するには、ハブの有料 /payable オラクルを使用してください。このサーバーはインデックスです。

接続

Claude（ウェブ版またはデスクトップ版）

1. Settings、次に Connectors、次に Add custom connector を選択します
2. Name：nsgoods。URL：https://mcp.nsgoods.org/mcp。サインインは不要です。
3. 新しい会話を開始し、たとえば次のように尋ねます：nsgoods を使って、Base 上で制裁スクリーニングに使える、最も安価な支払い可能なエンドポイントを探してください

Cursor：mcp.json に追加します

{"mcpServers":{"nsgoods":{"url":"https://mcp.nsgoods.org/mcp"}}}

Smithery：https://smithery.ai/servers/nikosble1926/nsgoods-workbench

Streamable HTTP に対応する MCP クライアントであれば、同じように利用できます。

ツール

ツール	回答内容
find_endpoints	ホストまたはキーワードでカタログを検索し、最新の判定とエンドポイントごとの観測価格を表示します。価格による並べ替えも任意で指定できます
payability_verdict	指定した URL の判定、履歴、修正のヒント、価格
catalogue_stats	カタログの規模、判定件数、ネットワークごとの支払い可能なエンドポイント数、価格の中央値
host_summary	ホストごとの判定内訳、初回および最終確認日時、利用できなくなってからの期間
drift_status	スキャン間の判定の変化
x401_status	現在の x401 エミッター数
verify_signature	マニフェストと照合し、nsgoods の署名付きレスポンスをオフラインで検証します
reports	週次の支払い可能性レポートへのリンク

すべてのツールは読み取り専用で、べき等です（MCP ツールアノテーションで宣言されています）。

判定：PAYABLE、NOT_PAYABLE、MALFORMED_402、CANNOT_PAY_EITHER_VERB、UNREACHABLE、SKIPPED、UNKNOWN。

例

実際の find_endpoints("erc20-balance", 2) 呼び出しを2行に絞った結果：

{
  "query": "erc20-balance",
  "total_matches": 6,
  "returned": 2,
  "endpoints": [
    {
      "resource": "https://api.onesource.io/api/chain/erc20-balance",
      "host": "api.onesource.io",
      "last_verdict": "PAYABLE",
      "host_gone_since": null,
      "price": "0.003 USDC on eip155:8453"
    },
    {
      "resource": "https://app.heinrichstech.com/v1/cdp/chain/erc20-balance",
      "host": "app.heinrichstech.com",
      "last_verdict": "PAYABLE",
      "host_gone_since": null,
      "price": "0.003 USDC on eip155:8453"
    }
  ],
  "as_of": "2026-09-13",
  "index_scan_id": "scan-20260913T050332Z"
}

データと鮮度

インデックスは毎週のフルスキャン後に再構築されます（2026年9月13日時点で14,652件のリソース、1,971台のホスト、13,146件が支払い可能）。価格は402件のチャレンジを対象にした一斉調査から取得しています（価格が付いたエンドポイントは10,958件、中央値は0.01 USDC、2026年9月16日時点）。各エンドポイントについて、GET のみで再プローブした結果を含むサンプルを CC BY 4.0 で公開しています：https://x402.nsgoods.org/proof/payability-sample-2026-09-13.json

最新のフル CDP Bazaar スキャンに含まれなくなったリソースは、別の再プローブスキャンで毎週再プローブされます。対象は PAYABLE ではない行のみで、古いものから最大1,500件を週ごとに処理します。これらの行では in_latest_scan=false が維持され、独自の last_checked_at と verdict_since が記録されます。最新のフルスキャンの数値（catalogue_stats、/health）には含まれません。

独自に実行する

python -m venv venv && venv/bin/pip install -r requirements.txt

独自の scans.jsonl（プローブごとに1行の JSON。フィールドについては build_index.py を参照）をスクリプトと同じ場所に置き、次を実行します：

venv/bin/python build_index.py
venv/bin/python server.py   # listens on 127.0.0.1:4036, path /mcp

Docker：

docker build -t nsgoods-workbench-mcp . && docker run -p 4036:4036 nsgoods-workbench-mcp

Docker イメージは未テストです（Docker ホストなしでビルドされています）。コンテナ内で WORKBENCH_HOST=0.0.0.0 を設定してください。フィードバックをお待ちしています。

環境変数：

変数	デフォルト	意味
WORKBENCH_DIR	.	インデックスおよびデータファイルのベースディレクトリ
WORKBENCH_DATA_DIR	WORKBENCH_DIR	scans.jsonl と監視状態のディレクトリ
WORKBENCH_HOST	127.0.0.1	バインドアドレス

インデックスが存在しない場合、サーバーは初回起動時に空のインデックスを作成するため、データを読み込む前でも tools/list が動作します。

プライバシーとログ

このサーバーにウォレットやサインインは不要です。サービスの運用とレート制限のため、ツールの使用状況を最小限の範囲で記録します。

• ツール呼び出しごとに、タイムスタンプ、ツール名、引数の名前と長さ、呼び出し元 IP の日次鍵付きハッシュである ip_h を保存します。引数の値や生の IP、MCP セッション ID は保存しません。
• クライアントの接続時には、タイムスタンプ、ip_h、ユーザーエージェント、クライアントが申告する名前とバージョン、要求するプロトコルのバージョンを保存します。/mcp へのリクエストが失敗した場合は、タイムスタンプ、ip_h、ユーザーエージェント、HTTP メソッドとステータス、JSON-RPC メソッド名、セッション ID が送信されたかどうか、MCP-Protocol-Version、Accept および Content-Type ヘッダー、エラーの先頭160文字を保存します。params や引数は記録しません。
• ip_h は HMAC-SHA256(daily_secret, ip) を16桁の16進文字に切り詰めた値です。シークレットはランダムに生成され、メモリ内にのみ保持され、UTC の日付が変わるたびに置き換えられ、書き留められることはありません。そのため、日付が変わった後はハッシュを IP に結び付けることはできません。
• 同じ ip_h を使って、呼び出し元ごとの1日あたり300回のツール呼び出しという無料上限を適用します。UTC の日中にサーバーが再起動した場合、新しいシークレットが生成されるため、その日の残りの間は全員のカウンターがリセットされます。
• 記録は30日後に削除されます。2026年9月26日より前に書き込まれた記録では、より詳細な形式（呼び出し元の IP、セッション ID、各引数の先頭80文字）が使用されていました。これらも同じスケジュールで削除され、最後の記録は2026年10月26日までに削除されます。

現在のフィールド一覧と保持期間は、GET /health の tool_log および client_log にもリアルタイムで表示されます。

検証

署名付きの nsgoods レスポンスでは、正規化された JSON（キーをソートし、区切り文字を詰め、ASCII エスケープし、ハッシュ計算前に signature と signed_by を除去）に EIP-191 を使用します。verify_signature ツールは、復元されたアドレスを https://x402.nsgoods.org/proof/index.json に記載された署名者と照合します。

実行される内容の検証。python3 scripts/pin_verify_signature.py server.py を実行すると、verify_signature 関数本体の行範囲、バイト範囲、sha256（def から末尾まで。デコレーターを除外し、LF 改行を使用、末尾の改行なし）と、ファイル全体の sha256 が出力されます。一致するハッシュはリポジトリの証拠にすぎず、公開されたソースが説明どおりであることを示します。デプロイの証拠ではありません。サーバーが実行している内容を示す、より強い証拠は動作です。稼働中のツールを呼び出し、結果がこのソースの生成結果と一致することを確認してください。

Links

Landing https://mcp.nsgoods.org/ · Hub https://x402.nsgoods.org · MCP section https://x402.nsgoods.org/#mcp Weekly report https://x402.nsgoods.org/proof/payability-report-2026-09-13.html Methodology https://x402.nsgoods.org/ata-audit/payability_index.json (method field)

MIT license.