PayStage
Umbrella MCP: payment preflight, auth watch, HIP-3 trade preflight, velocity checks
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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
0.3.5stdioRemote endpoints
https://api.paystage.xyz/mcpstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟢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
Evidence