PayStage

Safety tools for AI agent payments (x402 + MCP).

PayStage sits in front of an agent's wallet and answers one question before money moves: should this payment happen? Tools return pay, review, or do_not_pay.

Quick start

npx -y @paystage/mcp

@paystage/mcp is the umbrella MCP server. It exposes the PayStage tools over stdio and reads a local policy file.

Related MCP server: x402-triage-mcp

Configure

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "paystage": {
      "command": "npx",
      "args": ["-y", "@paystage/mcp"],
      "env": {
        "PAYSTAGE_POLICY_PATH": "/absolute/path/to/policy.json",
        "PAYSTAGE_RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "paystage": {
      "command": "npx",
      "args": ["-y", "@paystage/mcp"],
      "env": {
        "PAYSTAGE_POLICY_PATH": "/absolute/path/to/policy.json",
        "PAYSTAGE_RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}

• PAYSTAGE_POLICY_PATH (required): path to your local policy.json.

• PAYSTAGE_RPC_URL (optional): RPC endpoint used by on-chain checks. Defaults to a public Base RPC.

Tools

Packages

Links

• Website: https://paystage.xyz

• GitHub: https://github.com/base-buzz/paystage

• npm: https://www.npmjs.com/org/paystage

Development

This is a monorepo.

pnpm install
pnpm build
pnpm test
pnpm lint

License

MIT