Skip to content
MCP server

PayStage Preflight

Check an x402 payment request against a local spending policy before your agent pays

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

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

  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