
PayStage Preflight
Check an x402 payment request against a local spending policy before your agent pays
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.2.2
- 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.
The decision happens on your machine from a JSON file, with no network call, so the same input and the same policy always return the same verdict. The policy names allowed networks, allowed assets and allowed recipient addresses, then sets limits: a maximum per call, a maximum per session, an amount above which a human is required, a maximum timeout and a default verdict such as review. Amounts are human-readable USDC.
Verdicts are pay, review or do_not_pay. Setup is an npx command plus a PAYSTAGE_POLICY_PATH variable, with example configs for Claude Desktop and Cursor. Of the PayStage family, this is the smallest: it covers x402 only, leaving approvals and trade orders to sibling packages.
The site describes the project as read-only and key-free; an agent remains the only signer.
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
- Local policy file
- Rules live in JSON on your machine.
- Deterministic verdicts
- Same request and policy give the same result.
- Spend limits
- Per-call and per-session caps plus a human-approval threshold.
- Allow lists
- Restrict networks, assets and recipient addresses.
- stdio MCP server
- Runs through npx for Claude Desktop, Cursor and others.
Good for
- Cap a single x402 payment at one dollar
- Require approval above a set amount
- Allow payments only to known recipients
- Default unknown requests to review
Pricing
Open source
MIT licensed
Prices change. Check paystage.xyz before you buy.
PayStage Preflight FAQ
Does it call the network?
The README says no network calls are made to decide.
What are the verdicts?
pay, review or do_not_pay.
How is the policy supplied?
Through a JSON file named in PAYSTAGE_POLICY_PATH.
Which clients are documented?
Claude Desktop and Cursor.
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