# PayStage Preflight

> PayStage Preflight is an open-source MCP server for finance and payments. Check an x402 payment request against a local spending policy before your agent pays. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://paystage.xyz
- **Repository:** https://github.com/base-buzz/paystage/tree/HEAD/packages/preflight
- **MCP Registry name:** xyz.paystage/preflight
- **Categories:** finance and payments, security
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add preflight -- npx -y @paystage/preflight
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "preflight": {
      "command": "npx",
      "args": [
        "-y",
        "@paystage/preflight"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "preflight": {
      "command": "npx",
      "args": [
        "-y",
        "@paystage/preflight"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "preflight": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@paystage/preflight"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "preflight": {
      "command": "npx",
      "args": [
        "-y",
        "@paystage/preflight"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "preflight": {
      "command": "npx",
      "args": [
        "-y",
        "@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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/paystage-preflight
