# PayStage

> PayStage is an open-source MCP server for finance and payments. One MCP server for PayStage's payment, approval, trade and velocity checks. 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/mcp
- **MCP Registry name:** xyz.paystage/mcp
- **Categories:** finance and payments, security
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

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

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