
PayStage
One MCP server for PayStage's payment, approval, trade and velocity checks
- 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/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@paystage/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@paystage/mcp"
]
}
}
}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 rulesPAYSTAGE_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments