PayStage Preflight

@paystage/preflight

エージェントが支払う前に、ローカルの支出ポリシーに照らして x402 PaymentRequired を評価します。判定結果として、pay、review、do_not_pay のいずれかを返します。

• ローカルファースト — ポリシーはお使いのマシン上の JSON ファイルに保存されます。判定にシークレットもネットワーク呼び出しも必要ありません。
• MCP ネイティブ — stdio MCP サーバーとして動作するため、Claude Desktop、Cursor、任意の MCP クライアントからツールとして呼び出せます。
• 決定論的 — 同じ入力と同じポリシーなら、同じ判定結果になります。

インストール

グローバルインストールせずに、npx で直接実行します。

npx -y @paystage/preflight

または、お使いの MCP クライアントの設定に追加します。

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "paystage-preflight": {
      "command": "npx",
      "args": ["-y", "@paystage/preflight"],
      "env": {
        "PAYSTAGE_POLICY_PATH": "/absolute/path/to/policy.json"
      }
    }
  }
}

Cursor

.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "paystage-preflight": {
      "command": "npx",
      "args": ["-y", "@paystage/preflight"],
      "env": {
        "PAYSTAGE_POLICY_PATH": "/absolute/path/to/policy.json"
      }
    }
  }
}

policy.json の例

{
  "version": 1,
  "name": "standard",
  "allowed_networks": ["eip155:8453", "eip155:84532"],
  "allowed_assets": [
    "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
  ],
  "allowed_pay_to": ["0x209693Bc6afc0C5328bA36FaF03C514EF312287C"],
  "max_amount_per_call": "1.00",
  "max_amount_per_session": "10.00",
  "require_human_above": "0.50",
  "max_timeout_seconds": 300,
  "default_verdict": "review"
}

金額は人が読みやすい USDC 表記です（例："0.50" は 0.50 USDC）。ネットワークには CAIP-2 識別子を使用します。

判定結果

判定結果	意味
pay	ポリシーの範囲内です。自動的に処理を続行しても安全です。
review	許可されていますが、人による確認のしきい値を超えています。支払い前に人へ確認してください。
do_not_pay	ポリシーに違反しています（ネットワーク、アセット、payTo、金額、タイムアウト、または形式不正）。

リンク

• ウェブサイト：https://paystage.xyz
• ソースコード：https://github.com/base-buzz/paystage
• ライセンス：MIT