
PayStage Preflight
Checks an x402 payment against your spending policy and returns pay, review or block
- Pricing
- Open source
- Platforms
- CLI
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- 3 days ago
About PayStage Preflight
PayStage Preflight is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
PayStage Preflight sits outside the wallet. Before an agent signs an x402 payment, you pass it the payment request and it replies with one of three verdicts: pay, review or do_not_pay, together with the rule that fired. Nothing is signed or sent by this server, so the agent stays the only signer.
The policy is one JSON file you point to with an environment variable. It can restrict networks and assets, allow-list payee addresses, cap the amount per call and per session, require a human above a threshold, limit the timeout and set a default verdict. The same input and policy always give the same result, and the server fails closed.
The npm package makes no network calls to decide and has no telemetry. The project site describes nine MCP tools in the wider suite and a published deny list of known drainer addresses with a citation for each.
Install
Run in a terminal
claude mcp add preflight -- npx -y @paystage/preflightAdd to claude_desktop_config.json
{
"mcpServers": {
"preflight": {
"command": "npx",
"args": [
"-y",
"@paystage/preflight"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"preflight": {
"command": "npx",
"args": [
"-y",
"@paystage/preflight"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"preflight": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@paystage/preflight"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"preflight": {
"command": "npx",
"args": [
"-y",
"@paystage/preflight"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"preflight": {
"command": "npx",
"args": [
"-y",
"@paystage/preflight"
]
}
}
}Configuration
PAYSTAGE_POLICY_PATHPath to policy.json spending rules
What it does
- Three clear verdicts
- Returns pay, review or do_not_pay for each proposed payment.
- Rule that fired
- Each verdict names the policy rule behind it rather than a risk score.
- Local JSON policy
- Networks, assets, payees, per-call and per-session caps and timeouts live in one file.
- Deterministic and offline
- Same input and policy give the same verdict, with no network call to decide.
- Never signs
- Read-only by design; it holds no keys and cannot move funds.
Good for
- Stop an agent paying an unknown payee over x402
- Cap what a session may spend in USDC
- Send payments above a threshold to a human
- Audit why a payment was refused
Pricing
Open source
Free, MIT licence
Prices change. Check paystage.xyz before you buy.
PayStage Preflight FAQ
Does it hold keys or sign payments?
No. The site says it is read-only, holds no keys and never signs.
Where does the policy live?
In a JSON file on your machine, found through the PAYSTAGE_POLICY_PATH variable.
What network does the example policy allow?
The example allows Base mainnet and Base Sepolia, written as eip155:8453 and eip155:84532.
What licence is it?
MIT.
Is PayStage Preflight free?
Yes. PayStage Preflight is open source, so you can use and self-host it for free.
How do I add PayStage Preflight to Claude Code?
Run this command in your terminal: claude mcp add preflight -- npx -y @paystage/preflight
What are the best alternatives to PayStage Preflight?
The closest alternatives to PayStage Preflight are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.
Alternatives to PayStage Preflight

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments