PayStage — Claude Code MCP server: features and setup
The PayStage MCP server for Claude Code checks payments, authorizations, and trade requests against policies. Agents get a decision before signing a payment or trade order.
MIT ★ 6 updated 2026-11-16
claude mcp add --env PAYSTAGE_POLICY_PATH=<PAYSTAGE_POLICY_PATH> --env PAYSTAGE_RPC_URL=<PAYSTAGE_RPC_URL> --transport stdio mcp -- npx -y @paystage/mcpWhat PayStage does
PayStage evaluates x402 payments against a local policy file and returns a verdict before signing. It can also list pending ERC-20, Permit2, and EIP-3009 authorizations, flag ones that need attention, and assess spending patterns from recent action history.
For HIP-3 orders, the server applies a TradePolicy and returns allow, review, or do-not-trade. Other tools inspect receipts and policy documents, decode payment-required headers, and evaluate payment batches. A valid receipt signature does not establish that settlement took place; that is a separate on-chain event. The auth-watch tools read Base data through Base RPC, so they use network access.
What it helps with
- check an x402 payment before signing
- find pending ERC-20, Permit2, and EIP-3009 authorizations
- apply a trade policy to a HIP-3 order
- flag spending bursts or sharp increases
- verify a receipt and compare it with a request and policy
Example prompts for the agent
- Check this x402 payment against the local policy before signing it.
- List pending ERC-20 and Permit2 authorizations.
- Assess this HIP-3 order using our
TradePolicy.
How to install PayStage
Platform CLI
claude mcp add --env PAYSTAGE_POLICY_PATH=<PAYSTAGE_POLICY_PATH> --env PAYSTAGE_RPC_URL=<PAYSTAGE_RPC_URL> --transport stdio mcp -- npx -y @paystage/mcpReplace <…> with your own values
Platform CLI
codex mcp add mcp --env PAYSTAGE_POLICY_PATH=<PAYSTAGE_POLICY_PATH> --env PAYSTAGE_RPC_URL=<PAYSTAGE_RPC_URL> -- npx -y @paystage/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@paystage/mcp"
],
"env": {
"PAYSTAGE_POLICY_PATH": "<PAYSTAGE_POLICY_PATH>",
"PAYSTAGE_RPC_URL": "<PAYSTAGE_RPC_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@paystage/mcp"
],
"env": {
"PAYSTAGE_POLICY_PATH": "<PAYSTAGE_POLICY_PATH>",
"PAYSTAGE_RPC_URL": "<PAYSTAGE_RPC_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e PAYSTAGE_POLICY_PATH=<PAYSTAGE_POLICY_PATH> -e PAYSTAGE_RPC_URL=<PAYSTAGE_RPC_URL> mcp npx -y @paystage/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about PayStage
How do I install PayStage in Claude Code?
Run claude mcp add mcp -- npx -y @paystage/mcp. A separate install command is available for configuring environment variables.
What does PayStage do?
It evaluates payments and trade requests against policies, tracks authorizations and spending patterns, and verifies receipts.
What does PayStage need to run?
The server runs through npx using @paystage/mcp. PAYSTAGE_POLICY_PATH and PAYSTAGE_RPC_URL can provide a policy-file path and a Base RPC URL; both are optional.