preflight402

preflight402

エージェントが支払う前に、無料で1回チェックします。稼働状況、真正性、シビル攻撃を除外した評判を、1つの判定にまとめます。

エージェント決済エコノミー（x402）向けの無料の信頼性／稼働状況チェックです。エージェントが支払う前にエンドポイントを調査し、1つの trust-preview.v1 判定を返します。稼働状況、TLS、402ハンドシェイク（x402 v1/v2 + MPPの検出）、価格の妥当性、継続的な稼働履歴、ERC-8004のID紐付け、そしてシビル攻撃を除外したオンチェーン評判をまとめ、平易な理由とともに続行／注意／回避を推奨します。ウォレットもキーも課金も不要です。

評判をフィルタリングする理由： ある稼働中エージェントの996人のレビュアーによる平均評価は99.8/100でしたが、シビルフィルタリングにより、レビュアーは12の独立した資金調達クラスターにまとめられ、評価は89.7になりました。 生の評判は簡単に不正操作できます。この判定が実際に評価するのは、この数値です。（別途、x402の支払い先のうちERC-8004 IDを紐付けているのはわずか約4%です。そのため、大半の判定は稼働状況、価格、ハンドシェイクに基づき、その旨を正直に示します。）

「掲載済み」だけでは意味がない理由： 51,331件のエンドポイントカタログに対して15日間で776万回のプローブを実施したところ、掲載されているすべてのx402エンドポイントの58%は、2つの占有ホストに集中していました。一方は*"このアプリはまだ稼働していません"*というプレースホルダーの背後で一律に404を返し、もう一方は一律にCloudflare TLSエラーを返していました。これらを除くと、実際のエンドポイントの87%が動作します。プロバイダー単位で測定すると、約7つに1つのホスト（13.9%）が有効な402を返しません。調査結果はこちらをご覧ください： 780万回のプローブが明らかにするx402エコノミーの実態 — GETのみのクロール（修正前の当方のクロールも含む）が、x402の無効率を約2倍に見積もってしまう理由も記載しています。調査方法と注意事項の全文：docs/checkpoint-m3.md。

30秒で始める

ホスト型MCPエンドポイントを任意のエージェントに指定します。ウォレット、キー、インストールは不要です。

https://preflight402.ironshell.io/mcp

または、通常のHTTPでエンドポイントをチェックします。

curl 'https://preflight402.ironshell.io/preflight?url=https://api.example.com/paid'

すべての支払いを自動で保護

preflight402-guard は、このサービスを x402 Python SDK 用の決済ゲートにします。エージェントが呼び出しを忘れないようにするのではなく、安全性をデフォルトで有効にできます。

pip install "preflight402-guard[x402]"   # PyPI publish pending; for now: pip install "git+https://github.com/duskwire/preflight402.git#subdirectory=guard"

from preflight402_guard import Guard
from x402 import x402Client

guard = Guard()          # block "avoid", warn on "caution"
client = x402Client()
guard.install(client)    # every payment is preflighted before signing;
                         # a bad verdict raises PaymentAbortedError

また、クライアントが選択した支払い先が、事前チェックしたエンドポイントと一致するかを相互確認します（402のリソースURLは攻撃者が制御できます）。実際に選択された条件に対して、任意の max_price_usd 上限を適用し、デフォルトではフェイルオープンで動作するため、サービスの稼働状況にコマースが左右されることはありません。CLIも用意されています：preflight402-guard check <url>。詳しくはguard/README.mdをご覧ください。

ステータス

preflight402.ironshell.io で稼働中です。また、公式MCPレジストリには io.ironshell/preflight402 として登録されています。無料の事前チェックエンジン（稼働状況 + 402の解析 + 判定）、稼働履歴を含む継続的なプローブ、ERC-8004の紐付け、シビルフィルターはすべてリリース済みで、実際に稼働しています。サービス全体を無料で利用でき、ペイウォールはありません。

利用方法

MCPツールとして（ウォレット、キー不要）

preflight ツールは url を受け取り、trust-preview.v1 判定を返します。

最も簡単な方法は、インストールせずにホスト型インスタンスを任意のMCPクライアントに指定することです。

https://preflight402.ironshell.io/mcp   (streamable-http)

または、stdio経由で自分で実行します。Claude Codeの場合は1行です（PyPIへの公開は保留中のため、それまでは --directory にクローン先を指定してください）。

claude mcp add preflight402 -- uvx --from preflight402 preflight402-mcp
# pre-PyPI: claude mcp add preflight402 -- uv run --directory /path/to/preflight402 preflight402-mcp

Claude Desktopの場合は、claude_desktop_config.json に追加します。

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

どちらの方法でも、preflight402-mcp --transport streamable-http を使ってホスト型HTTPサーバーとして実行できます（同じツールを http://<host>:8000/mcp で提供します）。

REST呼び出しとして

ホスト型インスタンスはRESTも提供します。

curl 'https://preflight402.ironshell.io/preflight?url=https://api.example.com/paid'

または、自分で実行します（1つのポートでRESTとMCPを提供します）。

uv run uvicorn preflight402.api.app:app --port 8402
curl 'http://localhost:8402/preflight?url=https://api.example.com/paid'

開発

uv が必要です。

uv sync                                        # create venv + install deps
uv run uvicorn preflight402.api.rest:app       # serve on :8000
curl http://localhost:8000/healthz             # {"status":"ok","version":"0.1.0"}

uv run pytest                                  # tests
uv run ruff check .                            # lint
uv run ruff format --check .                   # formatting

ディレクトリ構成

src/preflight402/
├── api/          # REST + MCP server
├── probe/        # async prober, TLS inspection, 402 parsers (x402 v1/v2, MPP)
├── verdict/      # rules -> trust-preview.v1 JSON
├── chains/       # ChainVerifier interface: EVM (Base), SVM (Solana)
├── reputation/   # ERC-8004 subgraph client, endpoint binding, Sybil filter
├── ingest/       # endpoint seed ingesters (Bazaar, x402scan, ...)
├── scheduler/    # probe loop with per-host politeness
└── db/           # SQLite (WAL) schema + queries
guard/            # preflight402-guard: client-side auto-preflight for the x402 SDK
tests/            # unit/ + golden/ (captured 402 responses) + integration/ (marked slow)
deploy/           # Dockerfile + deploy notes
docs/             # trust-preview.v1 schema + API docs (M8)