PayStage Trade Preflight

@paystage/trade-preflight

MCP 工具：在交易前，根据本地 TradePolicy 评估 HIP-3 / trade.xyz 订单。

不构成财务建议。这只是一个本地策略门禁——不会下单、路由订单或推荐交易。它会根据你定义的规则评估拟议订单，并返回决策。

已在 npm 上发布，名称为 @paystage/[email protected]。

功能

提供拟议的 HIP-3 / trade.xyz 订单和本地策略文件后，服务会返回以下结果之一：

• allow — 订单符合策略中的所有规则
• review — 继续操作前需要人工或更高层级检查
• do_not_trade — 订单违反策略中的硬性规则

决策是确定性的，且在本地完成。评估策略无需网络调用；你可以将此工具作为自己订单流程的前置门禁。

安装

使用 npx 直接运行：

npx -y @paystage/trade-preflight

或者安装：

npm install @paystage/trade-preflight

该软件包提供一个 stdio MCP 服务（可执行文件：paystage-trade-preflight）。

MCP 配置

{
  "mcpServers": {
    "paystage-trade-preflight": {
      "command": "npx",
      "args": ["-y", "@paystage/trade-preflight"]
    }
  }
}

无需设置环境变量。策略通过工具参数传入。

工具

evaluate_hip3_trade

根据本地 TradePolicy 评估拟议的 HIP-3 / trade.xyz 订单。

输入（结构）：

• order — 拟议订单（市场、方向、规模、价格/限价等）
• policy — 本地 TradePolicy 对象（或其路径，具体取决于你的设置）

输出：

• decision — allow | review | do_not_trade
• reasons — 说明决策依据的规则结果列表

策略示例结构：

{
  "version": 1,
  "max_notional": { "value": "100.00", "asset": "USDC", "decimals": 6 },
  "allowed_markets": ["BTC-USD", "ETH-USD"],
  "allowed_sides": ["buy", "sell"],
  "max_leverage": 1,
  "unknown_market": "review"
}

决策

决策	含义
allow	订单符合所有策略规则。
review	订单需要人工或更高层级检查。
do_not_trade	订单违反硬性策略规则。

链接

• 网站：paystage.xyz
• HIP-3 相关信息：docs.trade.xyz
• 源码：github.com/base-buzz/paystage（packages/trade-preflight）

许可证

MIT