mcpField
P
PayStage

PayStage

Local
paystage.xyzFinance4Updated 2d ago
RepositoryVisit website

About PayStage

PayStage is an MCP server for agents that need payment checks, authorization monitoring, and HIP-3 trade preflight. Its local policy evaluations return decisions before signing or trading; it does not place orders.

Key features

  1. 01Evaluate x402 payments against local policy
  2. 02List ERC-20, Permit2, and EIP-3009 authorizations
  3. 03Flag outstanding authorizations for review
  4. 04Preflight HIP-3 orders with policy decisions

Use cases

  1. 01Check a proposed payment before an agent signs
  2. 02Find authorizations that were approved but not settled
  3. 03Review a HIP-3 order against a trading policy

MCP support

Exposes four payment, authorization, and trade-preflight tools through a stdio MCP server. The trade-preflight tool evaluates policy only and does not execute orders.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "xyz-paystage": {
      "command": "npx",
      "args": [
        "-y",
        "@paystage/mcp"
      ],
      "env": {
        "PAYSTAGE_POLICY_PATH": "<PAYSTAGE_POLICY_PATH>",
        "PAYSTAGE_RPC_URL": "<PAYSTAGE_RPC_URL>"
      }
    }
  }
}
Run commandnpx -y @paystage/mcp
Environment variables to set
PAYSTAGE_POLICY_PATHPath to policy.json spending rules
PAYSTAGE_RPC_URLBase RPC URL override

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@paystage/mcp0.2.2

Tools

5

Saved tool list · updated 1d ago

ParameterTypeRequiredDescription
policyanyNo
policy_pathstringNo
payment_requiredanyNo

Details

From the project README

@paystage/mcp

PayStage umbrella MCP server: payment preflight, auth watch, and HIP-3 trade preflight.

Not financial advice. The trade preflight tool is a local policy gate only — it does not place orders or recommend trades.

Published on npm as @paystage/[email protected].

Install

npx -y @paystage/mcp

Or:

npm install @paystage/mcp

The package exposes a stdio MCP server (bin: paystage-mcp).

MCP configuration

{
  "mcpServers": {
    "paystage": {
      "command": "npx",
      "args": ["-y", "@paystage/mcp"],
      "env": {
        "PAYSTAGE_POLICY_PATH": "./policy.json"
      }
    }
  }
}

Environment variables (all optional):

  • PAYSTAGE_POLICY_PATH — path to policy.json spending rules
  • PAYSTAGE_RPC_URL — Base RPC URL override

Tools

evaluate_mcp_payment — Available now

Evaluates a proposed x402 payment against a local policy file and returns a verdict before the agent signs anything.

list_outstanding_auths — Available now

Lists outstanding ERC-20, Permit2, and EIP-3009 authorizations.

evaluate_outstanding_auths — Available now

Flags outstanding authorizations that need attention (e.g. authorized but never settled).

evaluate_hip3_trade — Available now

Evaluates a proposed HIP-3 / trade.xyz order against a local TradePolicy and returns a decision: allow | review | do_not_trade.

Backed by @paystage/trade-preflight (0.1.0), which is also published on npm and can be run standalone:

npx -y @paystage/trade-preflight

The policy is passed as a tool argument; no extra environment variables are required for this tool.

Packages

PackageVersionPurpose
@paystage/mcp0.2.0Umbrella server (4 tools)
@paystage/auth-watch0.1.0Outstanding-auth tools
@paystage/trade-preflight0.1.2HIP-3 / trade.xyz trade preflight

Links

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.