Skip to content
MCP server

PayStage Preflight

Checks an x402 payment against your spending policy and returns pay, review or block

Runs locallyStatus and history
Install
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/preflight

Add to claude_desktop_config.json

{
  "mcpServers": {
    "preflight": {
      "command": "npx",
      "args": [
        "-y",
        "@paystage/preflight"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "preflight": {
      "command": "npx",
      "args": [
        "-y",
        "@paystage/preflight"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments