Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env PAYSTAGE_POLICY_PATH=<PAYSTAGE_POLICY_PATH> --env PAYSTAGE_RPC_URL=<PAYSTAGE_RPC_URL> --transport stdio mcp -- npx -y @paystage/mcp
Open on GitHub

What 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/mcp

Replace <…> 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.

Similar MCP servers

MCP servers catalog →

From the same set4

Project sponsors

Companies that keep this analytics open