PayStage Preflight

Name: PayStage Preflight
Author: paystage.xyz

本地服务

paystage.xyz金融数据42 天前更新

代码仓库访问官网

关于 PayStage Preflight

PayStage Preflight 是供处理 x402 支付的 Agent 使用的本地策略检查器。它在付款前评估 PaymentRequired 请求，并返回 pay、review 或 do_not_pay。

主要功能

01本地 JSON 支出策略
02确定性判定
03检查网络、资产、收款方和金额
04提供三种支付判定

适用场景

01付款前检查 x402 请求
02超过阈值时要求人工审核
03阻止违反策略的支付

MCP 相关

它以 stdio MCP 服务运行，向 Claude Desktop、Cursor 等 MCP 客户端提供支付评估工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "xyz-paystage-preflight": {
      "command": "npx",
      "args": [
        "-y",
        "@paystage/preflight"
      ],
      "env": {
        "PAYSTAGE_POLICY_PATH": "<PAYSTAGE_POLICY_PATH>"
      }
    }
  }
}

启动命令npx -y @paystage/preflight

需要配置的环境变量

PAYSTAGE_POLICY_PATHPath to policy.json spending rules

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@paystage/preflight0.1.0stdio

工具

收录的工具列表 · 更新于 4 天前

参数	类型	必填
policy	any	否
policy_path	string	否
payment_required	any	否

详细介绍

@paystage/preflight

在 Agent 付款之前，根据本地支出策略评估 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、金额、超时或格式错误）。