PayStage Preflight

io.github.base-buzz由 GitHub 帳號 base-buzz 發布v0.2.3更新於 Nov 12, 2026

Evaluate x402 PaymentRequired against a local spending policy before an agent pays

發布方自己的服務：Preflight

已驗證STDIO僅桌面金融安全與監控

服務詳細資訊

識別碼: io.github.base-buzz/preflight
傳輸: STDIO
執行環境: Desktop only
信任: Verified
發布於: Nov 12, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 base-buzz。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.base-buzz%2Fpreflight.svg)](https://sourceweft.com/mcp/io.github.base-buzz%2Fpreflight?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

本機 stdio MCP 伺服器，在代理付款前用 JSON 消費策略檢核 x402 PaymentRequired 內容，回傳 pay、review 或 do_not_pay。

可以做什麼: 評估付款請求：用本機策略檢核 x402 PaymentRequired 內容，取得 pay、review 或 do_not_pay 三種判定之一。
套用消費規則：允許的網路、資產與收款地址，單次與單工作階段金額上限，人工審核門檻，以及最大逾時。
將格式錯誤或違反策略的請求判為 do_not_pay，將超過人工門檻的請求判為 review。
適用情境: 當代理能發起 x402 付款，而你想在資金流出前用可重現的本機檢查攔阻或升級不符合規則的付款時使用。
執行需求: 需要 Node.js 與 npx 以 stdio 方式在本機執行這個 npm 套件，並需要一個策略 JSON 檔案，其絕對路徑透過 PAYSTAGE_POLICY_PATH 指定。判定過程不需要帳號、API 金鑰或網路存取。

安裝前請注意

判定僅供參考：它本身不付款也不保管資金，用戶端必須真正遵守 pay、review 與 do_not_pay。策略寫錯（網路、資產、收款地址或上限）會直接改變被核准的付款，請仔細核對策略檔案。README 說明此套件會讀取策略檔案與 PAYSTAGE_POLICY_PATH，並提到相關套件使用 PAYSTAGE_RPC_URL。

安裝

在 SourceWeft 中

開啟儀表板中的 PayStage Preflight，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照儲存庫中的啟動說明。

README

@paystage/preflight

Evaluate an x402 PaymentRequired against a local spending policy before your agent pays. Returns one of three verdicts: pay, review, or do_not_pay.

Local-first — policy lives in a JSON file on your machine. No secrets, no network calls to decide.
MCP-native — runs as a stdio MCP server so Claude Desktop, Cursor, and any MCP client can call it as a tool.
Deterministic — same input + same policy ⇒ same verdict.

Install

Run directly with npx (no global install):

Or add it to your MCP client config.

Claude Desktop

Add to claude_desktop_config.json:

json

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

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

Cursor

Add to .cursor/mcp.json:

json

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

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

Example `policy.json`

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"}

{  "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"}

Amounts are human-readable USDC (e.g. "0.50" = 0.50 USDC). Networks use CAIP-2 identifiers.

Verdicts

Verdict	Meaning
`pay`	Within policy — safe to proceed automatically.
`review`	Allowed but above a human threshold — ask a human before paying.
`do_not_pay`	Violates policy (network, asset, payTo, amount, timeout, or malformed).

Supply chain and access

Socket.dev scores this package on what it can do, not what it does with it, so the flags it raises are worth explaining rather than removing:

Flag	Why it is there
Filesystem access	Reads the policy JSON you point it at (`policy_path` / `PAYSTAGE_POLICY_PATH`). Nothing is written.
Environment variable access	`PAYSTAGE_POLICY_PATH` only (and `PAYSTAGE_RPC_URL` via `auth-watch`).
Network access, URL strings	None in this package. The RPC endpoints you may see in the tree belong to `@paystage/auth-watch`.

No shell, no eval, no telemetry, no key custody. The full table is in SECURITY.md; the deny list is published with a citation per entry in KNOWN_DRAINERS.md.