Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

PayStage — x402 payment safety and spend policy

by base-buzzversion 0.8.14i★ 5 (Stars for the whole repo)iComputer or cloudOfficial site ↗
Registry nameio.github.base-buzz/x402-payment-safety

How to install

What it does

x402 payment safety: judge a payment against your policy before signing. No keys, never signs.

  • Connects Computer or cloud
  • Account or key No key needed
  • Category Online shops & payments

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity32/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score52/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install PayStage — x402 payment safety and spend policy. Follow https://mcp.popnx.com/i/base-buzz-x402-payment-safety.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (api.paystage.xyz) · ✓ Commands checked Nov 18, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NamePayStage — x402 payment safety and spend policy
    Remote MCP server URL · Addresshttps://api.paystage.xyz/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsPayStage — x402 payment safety and spend policy

  4. Try it

    Use PayStage — x402 payment safety and spend policy and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using PayStage — x402 payment safety and spend policy or shows a PayStage — x402 payment safety and spend policy tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NamePayStage — x402 payment safety and spend policy
    Connection · Addresshttps://api.paystage.xyz/mcp
  3. Pick PayStage — x402 payment safety and spend policy in a chat

    Start a new chat and pick PayStage — x402 payment safety and spend policy from your plugins before typing

  4. Try it

    Use PayStage — x402 payment safety and spend policy and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using PayStage — x402 payment safety and spend policy or shows a PayStage — x402 payment safety and spend policy tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user x402-payment-safety https://api.paystage.xyz/mcp
  3. Type /mcp in Claude Code

    You should see PayStage — x402 payment safety and spend policy listed as connected

  4. Try it

    Use PayStage — x402 payment safety and spend policy and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using PayStage — x402 payment safety and spend policy or shows a PayStage — x402 payment safety and spend policy tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use PayStage — x402 payment safety and spend policy and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using PayStage — x402 payment safety and spend policy or shows a PayStage — x402 payment safety and spend policy tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use PayStage — x402 payment safety and spend policy and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using PayStage — x402 payment safety and spend policy or shows a PayStage — x402 payment safety and spend policy tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://api.paystage.xyz/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use PayStage — x402 payment safety and spend policy💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user x402-payment-safety https://api.paystage.xyz/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "x402-payment-safety": {
      "url": "https://api.paystage.xyz/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "x402-payment-safety": {
      "type": "http",
      "url": "https://api.paystage.xyz/mcp"
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user x402-payment-safety -- npx -y @paystage/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "x402-payment-safety": {
      "command": "npx",
      "args": [
        "-y",
        "@paystage/mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "x402-payment-safety": {
      "command": "npx",
      "args": [
        "-y",
        "@paystage/mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "x402-payment-safety": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@paystage/mcp"
      ]
    }
  }
}

Values you fill in

  • PAYSTAGE_POLICY_PATH env
    Path to policy.json spending rules
  • PAYSTAGE_RPC_URL env
    Base RPC URL override

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

GitHub starsi
5 (Stars for the whole repo)
This repo holds several MCP listings; its stars count once in rankings
Downloads per weeki
4,139/wk
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
0.8.14
Published to registryi
Nov 18, 2026
Code last changedi
Nov 18, 2026
Last checked
Nov 18, 2026
Maker
base-buzz
Packages
npm: @paystage/mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 18, 2026. The maker wrote them, not us; we show them as plain text.

  • evaluate_mcp_payment

    verify the recipient. Call this BEFORE signing any x402 payment. Verdict is pay | review | do_not_pay, each with stable reason codes (e.g. 'amount 1.00 USDC exceeds max_amount 0.05 USDC'). Returns the decision plus a signed receipt you can verify offline with verify_receipt. Read

  • list_outstanding_auths

    spending limits. Call this when auditing what an agent could still spend without a new signature — ERC-20 allowances, Permit2 and EIP-3009 authorisations. Returns each authorisation with spender, amount and expiry. Read-only and needs only a public RPC; no key, no funds moved. Us

  • evaluate_outstanding_auths

    spending limits. Call this when an agent already holds authorisations and you need to know which are dangerous. Verdict is pay | review | do_not_pay per authorisation, with reason codes naming the rule that fired (unlimited allowance, expiry already passed, spender not on the all

  • evaluate_hip3_trade

    transaction scope. Call this BEFORE an agent places a HIP-3 / trade.xyz order. Verdict is allow | review | do_not_trade, with the rule that fired (notional above cap, market not allowed, leverage too high). Returns the decision and a one-line reason. Local policy only: this is no

  • evaluate_velocity

    transparent risk assessments. Call this when an agent is about to make its Nth payment and you need to know whether the rate itself is the risk. Verdict is pay | review | do_not_pay over a rolling window (per-hour and per-day spend, count of payees). Returns the decision plus whi

  • verify_receipt

    verify the recipient. Call this when you have a receipt and want to know whether it is genuine, without trusting the server that issued it. Returns VALID with the verdict it attests to, INVALID if the payload was altered, or UNVERIFIABLE when the key cannot be fetched — and UNVER

  • decode_payment_required

    verify the recipient. Call this first when a 402 response arrives and you cannot read the payment-required header. Returns the decoded x402 v2 challenge: scheme, network, asset, atomic amount, payee, resource and timeout. Pure decoding: no network call, no signature, no verdict —

  • validate_policy

    spending limits. Call this before wiring a policy into anything: a policy that fails validation makes every evaluation refuse, which looks like a product bug and is not one. Returns valid: true, or the exact field and message that is wrong. No payment needed, no network call, no

  • request_testnet_funds

    test funds. Call this when you need Base Sepolia USDC to exercise the paid path end to end — one drip of 0.5 USDC per address per 24 hours, and the refusal tells you when it resets rather than just failing. Reads a public faucet: no key needed, no account, and it can only ever se

  • evaluate_batch

    transaction scope. Call this when an agent might pay several times in one turn and you want one policy decision covering all of them. Verdict is pay | review | do_not_pay per item, in input order, with reason codes — so the agent can stop at the first refusal rather than discover

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 18, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account base-buzz, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed today

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 335 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 10 tool descriptions and found no hidden instructions to the AI

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for @paystage/mcp@0.8.14

Checks only this package version, not every dependency · checked Nov 18, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/base-buzz-x402-payment-safety.svg)](https://mcp.popnx.com/en/servers/base-buzz-x402-payment-safety)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Online shops & paymentsi

  • More stars than 89% of the other 2903 servers in this category
  • Published to the registry more recently than 99% of the other 2903 servers in this category
  • Basic checks equal to or better than 99% of the other 2903 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is PayStage — x402 payment safety and spend policy safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed today, and the latest version (0.8.14) reached the registry today.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Stripe MCP

Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.

by stripeWidely used★ 2.1KUpdated 13 months ago

Runs in the cloud✓ service owner · stripe.com

flightclaw

Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.

by flightclawGrowing★ 86Updated 2 months ago

Runs in the cloud✓ service owner · flightclaw.com

Trade It

Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

by trade-it-incEarly★ 62Updated 33 days ago

Runs in the cloud✓ service owner · tradeit.app

idealo MCP Server

Search products, compare prices and discover deals across 6 European markets with your AI assistant.

by idealoEarly★ 28Updated 6 months ago

Runs in the cloud✓ service owner · mcp.idealo.com
Compared with similar ones
This one
PayStage — x402 payment safety and spend policy
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
Runs whereCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoYesNoNoNoNo
Basic checks5/54/44/44/44/44/4
LicenseMITMITMITCC0-1.0MITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

@paystage/mcp

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

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/mcp` — see the npm page for the current version rather than a number here that can go stale.

What a valid receipt means

paystage-verify returning exit 0 means the key it verified against signed this receipt and it has not been altered. That is all it means — and which key that was matters:

  • key_source: "published" → PayStage's published key: the issuer signed it.
  • key_source: "supplied" (you passed --key or --key-url) → the key you named signed it, which is a weaker claim and not evidence about PayStage at all. Exit 0 on that path says nothing more than that the holder of that key produced the receipt.

It does not mean the payment happened — settlement is a separate on-chain event. It does not mean the verdict was correct — a receipt records a decision, not the soundness of the policy behind it. And it does not identify the caller; no caller identity is bound into the payload, by design.

Two narrower points a careful reader should know:

  • `key_source` tells you where the verifying key came from: published (PayStage's endpoint) or supplied (someone passed --key). A receipt verified against a supplied key proves only that the holder of *that* key signed it.
  • A receipt with `signed: false` is still useful: the request and policy digests are checkable, so "over these inputs" survives even when provenance does not.
  • `--max-age` is your policy, not the issuer's. Nothing in the signed payload says how long a verdict is meant to hold, so a freshness bound is set by the verifier. If "this verdict is good for 24 hours" ever becomes the issuer's promise it has to be signed, and that is a format change.

Install

npx -y -p @paystage/mcp paystage-mcp

The server waits silently for an agent app to connect. That's normal; press Ctrl+C to exit. To try the tools without an app, run npx @modelcontextprotocol/inspector npx -y -p @paystage/mcp 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", "-p", "@paystage/mcp", "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 (published separately), which can also 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.

evaluate_velocity — Available now

Is this spend a burst, a spike, or a runaway cadence? Takes the recent action history and a policy.velocity block, and returns pay | review | do_not_pay with the window that was breached.

verify_receipt — Available now

Checks a receipt against the published signing key and returns the verdict it attests to, or why it cannot be trusted. VALID, INVALID (altered), EXPIRED (past its own lifetime), payment-mismatch (genuine, but about a different payment), or UNVERIFIABLE — which is a refusal, not a pass.

decode_payment_required — Available now

Decodes a base64 payment-required header from a 402 response into the JSON challenge: scheme, network, asset, atomic amount, payee, resource and timeout. Pure decoding — no network call, no verdict. Use evaluate_mcp_payment when you want a decision.

validate_policy — Available now

Checks a policy document without evaluating a payment, and returns the exact field and message when it is wrong. Worth running in CI on the policy an agent ships with: an invalid policy makes every evaluation refuse, which looks like a product bug and is not one.

evaluate_batch — Available now

The same question for several payments at once, one verdict each in input order — so an agent settling a batch stops at the first refusal instead of discovering it after three payments.

Packages

Ten packages. Only @paystage/mcp exposes ten MCP tools; the rest are the evaluator, guards for other frameworks, a policy schema and a skill — hence ten packages and ten tools in the same breath.

PackageRoleLinks
@paystage/mcpumbrella MCP server — start herenpm
@paystage/x402-guardpolicy gate for x402 clients, before the wallet signsnpm
@paystage/ai-sdkthe same gate as Vercel AI SDK toolsnpm
@paystage/auth-watchoutstanding ERC-20 / Permit2 / EIP-3009 authorisationsnpm
@paystage/policypolicy schema and loadernpm
@paystage/preflightx402 payment preflight (the evaluator)npm
@paystage/skillagent skill manifestnpm
@paystage/trade-preflightHIP-3 / trade.xyz order preflightnpm
@paystage/velocityrate and spend-pattern checksnpm
@paystage/x-evmchain-agnostic EVM helpersnpm

Verify a receipt

Every verdict can carry a signed receipt. paystage-verify checks one without trusting us — it fetches the published key and verifies the signature over the canonical payload.

npx -y -p @paystage/mcp paystage-verify receipt.json

cat receipt.json | npx -y -p @paystage/mcp paystage-verify -

Exit codes are distinct on purpose:

CodeMeaning
0signature matches the payload
1invalid — altered, or signed by a different key
2unsigned — a record of the decision, with no proof of who made it
3unverifiable — the key could not be fetched, or an input file could not be read, so nothing can be checked
4inputs-mismatch — the receipt is genuine but does not cover the --request/--policy you supplied
5stale — the receipt is genuine but older than --max-age allows

"Invalid" and "could not check" are different facts and must not collapse into one failure. --key verifies against a local JWK for point-in-time checks.

Supply chain and access

This is the umbrella, so its install tree is wider than any single tool and Socket flags it accordingly. What it actually contains:

FlagWhere it comes from
Network access, URL strings@paystage/auth-watch (Base RPC reads) and @paystage/trade-preflight (one Hyperliquid info query).
Filesystem access@paystage/policy reading your policy file.
Environment variable accessPAYSTAGE_POLICY_PATH, PAYSTAGE_RPC_URL.
"AI-detected code anomaly"The official @modelcontextprotocol/server SDK's bundled JSON-schema validator, not PayStage code.

The umbrella itself is ~16 KB with no network, no filesystem and no eval — the capability lives in the dependencies, because that is what the tools are for.

Install a narrower surface if you only need part of it: @paystage/preflight and @paystage/policy make no network calls at all.

Full table: SECURITY.md.

Links

  • Verify receipts: npx -y -p @paystage/mcp paystage-verify

License

MIT

Tools

Every one is read-only. None of them signs, holds a key, or moves money — the agent stays the only signer, which is the entire product.

toolwhat it answers
evaluate_mcp_paymentshould this x402 payment be signed? → pay · review · do_not_pay
list_outstanding_authswhich ERC-20 / Permit2 / EIP-3009 authorisations are still outstanding
evaluate_outstanding_authswhich of those need attention before the next payment
evaluate_hip3_tradeshould this HIP-3 / trade.xyz order be placed? → allow · review · do_not_trade
evaluate_velocityis this spend a burst, a spike, or a runaway cadence
verify_receiptis this receipt really ours — and is it about *this* payment, still in date
decode_payment_requiredwhat does this base64 402 header actually say
validate_policyis this policy document valid, and if not which field
request_testnet_funds0.5 Base Sepolia USDC for testing — one drip per address per 24h, with the reset time
evaluate_batchthe same question for several payments, one verdict each

Check a policy file before you run anything

npx -y -p @paystage/mcp paystage-policy check policy.json

Exit 0 valid, 1 invalid (one line per offending field), 2 unreadable. Offline, no key, no signup — the same schema the evaluator enforces, so a file that passes here is a file that will load there.

Explain a receipt in words

npx -y -p @paystage/mcp paystage-explain receipt.json
Decision: do_not_pay

signature valid — this receipt is what PayStage issued issued 2026-11-15T18:27:34Z by @paystage/hosted

· It asks for 1 USDC, and the policy allows at most 0.05 USDC.

It verifies the signature first and says plainly when a receipt cannot be trusted. Rules it does not recognise are quoted, not paraphrased — guessing at a refusal's meaning is worse than repeating it.