Factline X402 Health

@pipeworx/factline-x402-health

x402 販売者とファシリテーターの健全性：Factline による販売者の夜間プローブとファシリテーターの毎時プローブを、リクエストごとにライブでプロキシします。

Pipeworx の一部です。AI エージェントを 1858 以上のライブデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。

ツール

• x402_facilitator_health(facilitator?) -- 追跡対象のすべての x402 ファシリテーターについて、現在の状態（稼働中／停止中／不明）、過去 7 日間の稼働率、レイテンシ、対応ネットワークを返します。ID、名前、URL を指定すると 1 件に絞り込めます。毎時更新されます。
• x402_seller_health(query?, tag?, network?, limit?) -- 過去 30 日間の支払者数順に並べた x402 販売者と、夜間プローブによる健全性の評価（healthy/degraded/unhealthy/insufficient_data/unprobed）を返します。1 回の呼び出しで最大 100 件までです。残りを確認するには、query、tag、network で絞り込んでください。
• x402_seller_lookup(origin) -- origin、ホスト、URL で販売者を 1 件検索し、日ごとのプローブ履歴、稼働率、登録済みの payTo ウォレット、健全性の評価を返します。販売者に支払う前に使用してください。

すべてのレスポンスには source、cite_as、cadence、data_as_of、warnings が含まれます。

認証

キーは不要です。Factline はエージェントでの利用向けに、これらのフィードを無料で提供しています。

データソース

• Factline、x402 Seller Health Index -- 公開 x402 カタログに掲載されている販売者を夜間にプローブします。
• Factline、x402 Facilitator Health -- x402 ファシリテーターを毎時プローブします。

「Source: Factline (factline.dev)」と明記してください。更新頻度：販売者は毎晩、ファシリテーターは毎時です。data_as_of は最新のプローブを示し、更新頻度から見てデータが古い場合は warnings に項目が追加されます。

結果の読み方

• 結果がないことは健全性を意味しません。found:false または count:0 は不明、または一致するものがないことを意味し、「問題なし」を意味するものではありません。このパックはペイロード内でその旨を示します。
• 販売者フィードはリクエストごとに最大 100 件の販売者を返し、ページ分割には対応していません（追跡対象は約 1,000 件です）。coverage_note に対象範囲の制限が記載されます。
• health と status_now は Factline の数値に基づくこのパック独自の評価（ルールは health_basis / status_basis に記載）であり、Factline 自身の判定ではありません。API キーが必要なファシリテーターは /supported のみをプローブします（verify_tested: false）。
• 販売者のプローブでは、サンプルのエンドポイントが有効な支払いチャレンジに応答するかを確認します。支払いは行われず、販売者が提供するものの品質についても何も示しません。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "factline-x402-health": {
      "url": "https://gateway.pipeworx.io/factline-x402-health/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/factline-x402-health/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember/recall、その他ゲートウェイ全体のツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールに加えて共有ツールが約 30 個表示されます。接続の initialize レスポンスには正確な範囲が示され、その日の情報としての確定値となります。

これは意図的なものであり、偶発的な多重化ではありません。メタツールを使うことで、このパックが対応していない質問にも、カタログ全体を横断してルーティングする ask_pipeworx 経由で回答できます。そのため、MCP サーバーを追加する必要はありません。現在、メタツールを含めずにパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL からも、同じゲートウェイと 1858 以上のデータソースにアクセスできます。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使えば、すべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/x402_facilitator_health \
  -H 'Content-Type: application/json' \
  -d '{"facilitator":"payai"}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/x402_facilitator_health を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

npm から実行する

@pipeworx/mcp-factline-x402-health は、Pipeworx ゲートウェイへのローカルな stdio ブリッジです。MCP クライアントが npx で起動し、すべての呼び出しを上記と同じ https://gateway.pipeworx.io/factline-x402-health/mcp エンドポイントに転送します。ネットワークアクセスが必要です。オフラインモードはありません。

{
  "mcpServers": {
    "factline-x402-health": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-factline-x402-health"]
    }
  }
}

キーがない場合は匿名で呼び出し、1 日あたり 50 回までに制限されます。無料アカウントを作成すると、1 日あたり 200 回まで利用できます。https://pipeworx.io/signup でキーを取得し、サーバーエントリーに "env": { "PIPEWORX_API_KEY": "<your key>" } を追加してください。 キーはホスト型接続の場合と同じように Bearer トークンとして送信されるため、呼び出しはそこでの利用とまったく同じように計測され、課金されます。

デフォルトでは、このパックのツールのみを一覧表示します。PIPEWORX_META_TOOLS=1 を設定すると、ask_pipeworx とその他のゲートウェイ全体のツールも一覧表示されます。

HTTPS プロキシ経由の場合：Node の組み込み fetch は、デフォルトでは HTTPS_PROXY を読み取りません。新しい Node リリースでは、NODE_USE_ENV_PROXY=1 を設定するとこの環境変数が有効になります。お使いの Node バージョンのドキュメントをご確認ください。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントだけでなく、ゲートウェイ全体でも利用できます。

ask_pipeworx({ question: "your question about Factline X402 Health data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

その他

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT