# PayStage Preflight

> PayStage Preflight is an open-source MCP server for finance and payments. Checks an x402 payment against your spending policy and returns pay, review or block. It runs locally on your machine and is started by your AI client.

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

## About

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.

## Features

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

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

- [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-2
