Skip to content
MCP server

PayStage Trade Preflight

Check HIP-3 and trade.xyz orders against a local trade policy before an agent trades

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.0
Listing updated
3 days ago

About PayStage Trade Preflight

PayStage Trade Preflight is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MIT licensed

Prices change. Check paystage.xyz before you buy.

PayStage Trade Preflight 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 to PayStage Trade 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