Skip to content
MCP server

PayStage

One MCP server for PayStage's payment, approval, trade and velocity checks

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

About PayStage

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

Install this one package rather than four. It is the umbrella over PayStage's smaller servers and the site counts nine tools in total, all read-only: an agent asks whether a proposed spend is acceptable and gets pay, review or do-not-pay along with the rule that fired.

The README documents four: evaluate_mcp_payment checks an x402 payment against a local policy file; list_outstanding_auths and evaluate_outstanding_auths inspect token approvals; evaluate_hip3_trade checks a HIP-3 or trade.xyz order against a TradePolicy and returns allow, review or do_not_trade. It places no orders and the README says it is not financial advice. The packages table also lists a separate velocity package.

The server runs over stdio from npm and reads PAYSTAGE_POLICY_PATH and PAYSTAGE_RPC_URL. The site stresses that it holds no keys and the agent remains the only signer; the project says it is written, tested and released by AI agents, with public history.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Configuration

  • PAYSTAGE_POLICY_PATHPath to policy.json spending rules
  • PAYSTAGE_RPC_URLBase RPC URL override

Tools this server provides (4)

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

evaluate_mcp_payment
Evaluates an x402 payment against a local policy and returns a verdict
list_outstanding_auths
Lists outstanding ERC-20, Permit2 and EIP-3009 authorisations
evaluate_outstanding_auths
Flags outstanding authorisations that need attention
evaluate_hip3_trade
Evaluates a HIP-3 order against a TradePolicy

What it does

Payment preflight
Evaluate an x402 payment against a local policy before signing.
Auth watch
List and flag outstanding token authorisations.
Trade preflight
Check HIP-3 orders against a trade policy.
Velocity checks
A velocity package is part of the umbrella.
Verdict with reason
Responses name the rule that fired.
Receipt verification
A paystage-verify command checks signed receipts.

Good for

  • Gate every x402 payment an agent makes
  • Review stale token approvals
  • Limit order size and markets for a trading agent
  • Keep one MCP entry in the client config

Pricing

Open source

MIT licensed

Prices change. Check paystage.xyz before you buy.

PayStage FAQ

Can it sign transactions?

No. The site says it holds no keys and never signs.

What are the verdicts?

pay, review or do-not-pay for payments, and allow, review or do_not_trade for trades.

Does a valid receipt prove payment?

No. The README says it only shows the verifying key signed it and it was not altered.

Is it open source?

The site states MIT licensing.

Is PayStage free?

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

How do I add PayStage to Claude Code?

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

What are the best alternatives to PayStage?

The closest alternatives to PayStage are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

Alternatives to PayStage

  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