PayStage Trade Preflight

@paystage/trade-preflight

MCP ツール：取引前に、HIP-3／trade.xyz の注文をローカルの TradePolicy に照らして評価します。

金融アドバイスではありません。これはローカルで動作するポリシーゲートにすぎず、注文の発注やルーティング、取引の推奨は行いません。提案された注文を定義済みのルールに照らして評価し、判定を返します。

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

提案された HIP-3／trade.xyz の注文を、ローカルの TradePolicy に照らして評価します。

入力（形式）：

• 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