# PayStage Trade Preflight

> PayStage Trade Preflight is an open-source MCP server for finance and payments. Check HIP-3 and trade.xyz orders against a local trade policy before an agent trades. 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/trade-preflight
- **MCP Registry name:** xyz.paystage/trade-preflight
- **Categories:** finance and payments, security
- **Listing updated:** 2026-11-14

## About

A trade gets one of three decisions: allow, review or do_not_trade, each with a list of rule results that explain it. The policy is passed as a tool argument and can restrict the maximum notional in USDC, the allowed markets such as BTC-USD and ETH-USD, the allowed sides, the maximum leverage, and what to do with an unknown market, for example send it to review.

It never places an order or signs anything, and the README states it is not financial advice. Its one network call is a read-only POST to Hyperliquid's info endpoint for market data, made only when the caller does not supply a market snapshot. No environment variables are required.

It installs from npm as a stdio server, and the same tool is available inside the umbrella PayStage package.

## Features

- **Three decisions:** allow, review or do_not_trade with rule reasons.
- **Notional cap:** Set a maximum order size in USDC.
- **Market and side lists:** Limit allowed markets and sides.
- **Leverage limit:** Set a maximum leverage.
- **Unknown-market rule:** Decide whether unfamiliar markets are reviewed or blocked.

## Good for

- Keep an agent to BTC and ETH markets only
- Cap order notional at a fixed amount
- Force review for unfamiliar markets
- Block leveraged orders

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `evaluate_hip3_trade`: Evaluates an order against a TradePolicy and returns allow, review or do_not_trade

## FAQ

### Does it place orders?

No, it only evaluates and never signs.

### What does it call on the network?

A read-only POST to api.hyperliquid.xyz/info when no market snapshot is passed.

### Does it need environment variables?

No.

### Is this advice?

The README says it is not financial advice.

### Is PayStage Trade Preflight free?

Yes. PayStage Trade Preflight is open source, so you can use and self-host it for free.

### How do I add PayStage Trade Preflight to Claude Code?

Run this command in your terminal: claude mcp add trade-preflight -- npx -y @paystage/trade-preflight

### What are the best alternatives to PayStage Trade Preflight?

The closest alternatives to PayStage Trade 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-trade-preflight
