PayStage

Umbrella MCP: payment preflight, auth watch, HIP-3 trade preflight, velocity checks

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
77%
Naming quality
98%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,494Tokens (tool definitions)
~1.1 KBTypical response size
Moderate attention impact (1.17% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "@paystage/mcp"
      ]
    }
  }
}

Runnable packages

npm@paystage/mcp0.3.5stdio

Remote endpoints

https://api.paystage.xyz/mcpstreamable-http

What it can do

Tool inventory

Tools (9)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢evaluate_mcp_payment(payment_required, policy_path, policy, agent_id)

Evaluate an x402 PaymentRequired payload against a PayStage spending policy before paying

Input Schema

{
  "type": "object",
  "properties": {
    "payment_required": {},
    "policy_path": {
      "type": "string"
    },
    "policy": {},
    "agent_id": {
      "description": "Which agent is asking. Required to reach per-agent budgets in policy.agents.",
      "type": "string"
    }
  },
  "required": [
    "payment_required"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢list_outstanding_auths(wallet, network, tokens, spenders, policy_path, ...)

List outstanding token authorizations for a wallet

Input Schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string"
    },
    "network": {
      "type": "string"
    },
    "tokens": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "spenders": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "policy_path": {
      "type": "string"
    },
    "policy": {},
    "eip3009_nonces": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "rpc_url": {
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢evaluate_outstanding_auths(wallet, network, tokens, spenders, policy_path, ...)

List and evaluate outstanding token authorizations against a policy

Input Schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string"
    },
    "network": {
      "type": "string"
    },
    "tokens": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "spenders": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "policy_path": {
      "type": "string"
    },
    "policy": {},
    "eip3009_nonces": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "rpc_url": {
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢evaluate_hip3_trade(proposal, policy, policy_path, snapshot)

Evaluate a Hyperliquid HIP-3 (trade.xyz) order against a TradePolicy before an agent trades. Returns decision allow | review | do_not_trade.

Input Schema

{
  "type": "object",
  "properties": {
    "proposal": {
      "type": "object",
      "properties": {
        "dex": {
          "type": "string"
        },
        "asset": {
          "type": "string"
        },
        "side": {
          "type": "string",
          "enum": [
            "buy",
            "sell"
          ]
        },
        "size": {
          "type": "string"
        },
        "leverage": {
          "type": "number"
        },
        "order_type": {
          "type": "string",
          "enum": [
            "limit",
            "market"
          ]
        },
        "limit_px": {
          "type": "string"
        }
      },
      "required": [
        "dex",
        "asset",
        "side",
        "size"
      ]
    },
    "policy": {},
    "policy_path": {
      "type": "string"
    },
    "snapshot": {}
  },
  "required": [
    "proposal"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢evaluate_velocity(history, proposed, policy, policy_path, now_ms)

Rolling-window rate and spend-pattern check for a proposed payment against recent action history and a policy.velocity config

Input Schema

{
  "type": "object",
  "properties": {
    "history": {
      "default": [],
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "timestamp_ms": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "amount_atomic": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "decimals": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "asset": {
            "type": "string"
          }
        },
        "required": [
          "timestamp_ms"
        ]
      }
    },
    "proposed": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "timestamp_ms": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "amount_atomic": {
          "type": "string"
        },
        "amount": {
          "type": "string"
        },
        "decimals": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "asset": {
          "type": "string"
        }
      },
      "required": [
        "timestamp_ms"
      ]
    },
    "policy": {},
    "policy_path": {
      "type": "string"
    },
    "now_ms": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "proposed"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢verify_receipt(receipt, key_url)

Verify a PayStage receipt against the published signing key. Returns the verdict it attests to, or why it cannot be trusted.

Input Schema

{
  "type": "object",
  "properties": {
    "receipt": {
      "description": "The receipt object as issued"
    },
    "key_url": {
      "description": "Override the published key location",
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "receipt"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢decode_payment_required(header)

Decode a base64 `payment-required` header from a 402 response into the JSON challenge, so an agent can inspect it before deciding anything.

Input Schema

{
  "type": "object",
  "properties": {
    "header": {
      "type": "string",
      "minLength": 1,
      "description": "The raw base64 value of the payment-required header"
    }
  },
  "required": [
    "header"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢validate_policy(policy)

Check a policy document without evaluating a payment. Returns the exact validation error when it is wrong, which is the question behind most support requests.

Input Schema

{
  "type": "object",
  "properties": {
    "policy": {}
  },
  "required": [
    "policy"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢evaluate_batch(payments, policy)

Evaluate several payment challenges against one policy in a single call. Returns one verdict per input, in order, so an agent settling a batch decides once per payment and can stop at the first refusal.

Input Schema

{
  "type": "object",
  "properties": {
    "payments": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {}
    },
    "policy": {}
  },
  "required": [
    "payments",
    "policy"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded9 tools