Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

PayStage x402 Guard — payment safety before the wallet signs

de base-buzzversión 0.4.9i★ 5 (Estrellas de todo el repositorio)iSe ejecuta en tu computadoraSitio oficial ↗
Nombre en el registroio.github.base-buzz/x402-guard

Cómo instalar

What it does

x402 payment safety: judge a payment against your policy before signing. Read-only, never signs.

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Tiendas en línea y pagos

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad28/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso40/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: 207 (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala PayStage x402 Guard — payment safety before the wallet signs. Sigue https://mcp.popnx.com/i/base-buzz-x402-guard.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 18 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server PayStage x402 Guard — payment safety before the wallet signs para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "x402-guard": { "command": "npx", "args": [ "-y", "@paystage/x402-guard" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de PayStage x402 Guard — payment safety before the wallet signs aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "x402-guard": {
          "command": "npx",
          "args": [
            "-y",
            "@paystage/x402-guard"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. Pruébalo

    Usa PayStage x402 Guard — payment safety before the wallet signs y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando PayStage x402 Guard — payment safety before the wallet signs o muestra una herramienta de PayStage x402 Guard — payment safety before the wallet signs en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar PayStage x402 Guard — payment safety before the wallet signs

PayStage x402 Guard — payment safety before the wallet signs se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar PayStage x402 Guard — payment safety before the wallet signs

  • Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Tiendas en línea y pagos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server PayStage x402 Guard — payment safety before the wallet signs para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user x402-guard -- npx -y @paystage/x402-guard 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de PayStage x402 Guard — payment safety before the wallet signs aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user x402-guard -- npx -y @paystage/x402-guard
  4. Escribe /mcp en Claude Code

    Deberías ver PayStage x402 Guard — payment safety before the wallet signs en la lista como conectado

  5. Pruébalo

    Usa PayStage x402 Guard — payment safety before the wallet signs y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando PayStage x402 Guard — payment safety before the wallet signs o muestra una herramienta de PayStage x402 Guard — payment safety before the wallet signs en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server PayStage x402 Guard — payment safety before the wallet signs para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "x402-guard": { "command": "npx", "args": [ "-y", "@paystage/x402-guard" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de PayStage x402 Guard — payment safety before the wallet signs aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa PayStage x402 Guard — payment safety before the wallet signs y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando PayStage x402 Guard — payment safety before the wallet signs o muestra una herramienta de PayStage x402 Guard — payment safety before the wallet signs en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server PayStage x402 Guard — payment safety before the wallet signs para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "x402-guard": { "type": "stdio", "command": "npx", "args": [ "-y", "@paystage/x402-guard" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de PayStage x402 Guard — payment safety before the wallet signs aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa PayStage x402 Guard — payment safety before the wallet signs y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando PayStage x402 Guard — payment safety before the wallet signs o muestra una herramienta de PayStage x402 Guard — payment safety before the wallet signs en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa PayStage x402 Guard — payment safety before the wallet signs💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

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

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Estrellas de GitHubi
5 (Estrellas de todo el repositorio)
Este repositorio tiene varias fichas MCP; sus estrellas cuentan una sola vez en las clasificaciones
Descargas por semanai
2371/sem
Conexión
Se ejecuta en tu computadora
Última versióni
0.4.9
Publicado en el registroi
18 nov 2026
Último cambio de códigoi
18 nov 2026
Creador
base-buzz
Paquetes
npm: @paystage/x402-guard
Sitio web
paystage.xyz
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 18 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub base-buzz, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hoy

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para @paystage/x402-guard@0.4.9

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 18 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

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

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Tiendas en línea y pagosi

  • Más estrellas que el 0% de los otros 2903 servidores de esta categoría
  • Publicado en el registro más recientemente que el 99% de los otros 2903 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 2903 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro PayStage x402 Guard — payment safety before the wallet signs?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hoy, y la última versión (0.4.9) llegó al registro hoy.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

de stripeMuy usado★ 2,1 milActualizado hace 13 meses

Se ejecuta en la nube✓ del servicio · stripe.com

flightclaw

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

de flightclawEn crecimiento★ 86Actualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · flightclaw.com

Trade It

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

de trade-it-incInicial★ 62Actualizado hace 33 días

Se ejecuta en la nube✓ del servicio · tradeit.app

idealo MCP Server

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

de idealoInicial★ 28Actualizado hace 6 meses

Se ejecuta en la nube✓ del servicio · mcp.idealo.com
Comparado con otros parecidos
Este
PayStage x402 Guard — payment safety before the wallet signs
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoSíNoNoNoNo
Revisiones básicas3/34/44/44/44/44/4
LicenciaMITMITMITCC0-1.0MITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

@paystage/x402-guard

The ten lines between *"the agent decided to pay"* and *"the money moved."*

x402-fetch runs the payment loop well: request, read the 402, sign, retry. What it does not do is ask whether that payment should happen. This wraps it, evaluates your policy against the actual challenge, and refuses before the wallet signs.

The whole change

-const res = await fetch("https://api.example.com/paid");

+const res = await guarded("https://api.example.com/paid");

Two lines, one call site. The policy below is configuration you write once; the guard only changes how the request is made.

npm install @paystage/x402-guard x402-fetch   # v1, unscoped: takes a signer (see "two packages" below)

Published with provenance. Every version from 0.1.1 onward is built and signed by this

repository's CI (npm view @paystage/x402-guard dist.attestations shows it). The one exception is

0.1.0, which was published by hand on 2026-11-12 before the Trusted Publisher existed and carries

no attestation — pin >=0.1.1 if that matters to your policy.

import { guardFetch } from "@paystage/x402-guard";

import { privateKeyToAccount } from "viem/accounts";

const guarded = guardFetch(fetch, { walletClient: account, policy: { version: 1, max_amount: { value: "0.05", asset: "USDC", decimals: 6 }, allowed_pay_to: ["0x…"], allowed_assets: [{ symbol: "USDC", decimals: 6, address: "0x…", network: "eip155:8453" }], allowed_networks: ["eip155:8453"], max_timeout_seconds: 300, unknown_payee: "deny", }, });

const res = await guarded("https://api.example.com/paid"); res.headers.get("x-paystage-verdict"); // "pay" | "review" | "do_not_pay"

What it decides

SituationResult
Not a 402respond normally, verdict pay, reason no_payment_required
Policy allowsdelegate to x402-fetch, sign and pay, verdict pay
Policy deniesreturn the original 402 with verdict do_not_pay — nothing is signed
Challenge unreadableverdict review — refuse rather than guess
Policy itself invalidthrows at construction, not at payment time

A refusal returns the server's real challenge, not a manufactured error, so the caller can log what was actually asked for.

Why not just maxValue

maxValue in x402-fetch is one number. A spend policy is not one number: it is who may be paid, in which asset, on which network, for how long, and what to do when the payee is unknown. The interesting failures are the ones a single ceiling cannot express — the right amount sent to the wrong address is still a drained wallet.

Honest limits

  • It evaluates before signing, using the 402 challenge. It cannot see what the server does after settlement.
  • The receipt is a verdict header (x-paystage-verdict, x-paystage-reason-codes). It is not yet a signed, independently verifiable receipt — that is what @paystage/mcp paystage-verify and the hosted API produce.
  • No evaluation has been run against a live adversary. See docs/why-preflight.md in the repository.

Related

The seller's side: refuse before verification

guardFetch protects an agent that pays. paystageVerifierHook protects a seller that is about to be paid — it plugs into the hooks @x402/core runs before verification, so a payment that violates your policy is aborted before the facilitator is asked to verify or settle it.

import { x402ResourceServer } from "@x402/core/server";

import { paystageVerifierHook } from "@paystage/x402-guard";

const server = new x402ResourceServer(facilitator) .registerExtension(paystageVerifierHook({ policy }));

It cannot be bypassed by a caller who forgot to use our client, which is the failure mode a client-side guard always has.

It fails closed. If policy evaluation throws, the payment is aborted with paystage_evaluation_failed. A hook that failed open would look like protection and behave like consent — there is a test for exactly that.

On the SDK directly: one hook

Two packages, similar names

x402-fetch (unscoped, 1.x) takes a signer and is what guardFetch wraps. @x402/fetch (scoped, 2.x) takes an `x402Client` and is the line this project itself uses elsewhere. They are not interchangeable: passing a v2 client to walletClient raises a named error rather than failing inside the peer with createPaymentPayload is not a function. On v2, register the hook below instead — the policy, verdicts and reason codes are identical.

guardFetch covers anyone paying through x402-fetch. If you drive @x402/core yourself, core exposes onBeforePaymentCreation — which runs before a payment payload exists and can abort with a reason:

import { x402Client } from "@x402/core/client";

import { paystageClientHook } from "@paystage/x402-guard";

const client = x402Client.fromConfig({ schemes: [/* … */] }); client.onBeforePaymentCreation(paystageClientHook({ policy }));

Same policy, same verdicts, same reason codes as every other surface. A refusal aborts payload creation, so nothing is signed and the reason travels with it.

Any facilitator, unchanged

The verifier hook attaches to the resource server, not to the facilitator — so it composes with whatever facilitator you already run: CDP, PayAI (@payai/facilitator), a self-hosted one, or none. Those packages are configuration (a URL and auth headers); there is nothing in them to wrap, which is why this is a hook rather than a per-facilitator package.

const server = new x402ResourceServer(createFacilitatorConfig(PAYAI_URL))

.registerExtension(paystageVerifierHook({ policy }));

A refused payment aborts in beforeVerify, so the facilitator is never asked to verify or settle it. That ordering is the point, and there is a test asserting the facilitator's methods are never called.

Keep the verdict

A refusal that leaves no trace is a refusal nobody can debug. Two opt-in seams:

guardFetch(fetch, {

policy, onVerdict: (v) => log.info(v), // your logger telemetryUrl: "https://api.paystage.xyz/v1/guard-verdict", // or the hosted collector })

The record is { verdict, reasonCodes, payTo, at } — no wallet address, no signature, no request body. Telemetry is fire-and-forget and never on the payment path: a failed POST cannot fail the call, and a throwing logger cannot change whether a payment is allowed.

Circle's batched client

@circle-fin/x402-batching exposes the same onBeforePaymentCreation hook @x402/core does, so this is a registration and not an adapter — its context ({ paymentRequired, selectedRequirements } with { scheme, network, asset, amount, payTo, maxTimeoutSeconds }) is the shape this package already reads:

import { GatewayClient } from "@circle-fin/x402-batching/client";

import { paystageClientHook } from "@paystage/x402-guard";

const client = new GatewayClient({ /* … */ }); client.onBeforePaymentCreation(paystageClientHook({ policy }));

The hook runs before the payment payload exists, so a refusal aborts the batch before anything is signed. Verified against @circle-fin/x402-batching@4.0.0 type definitions in tests/circle-batching.test.ts — if their context shape changes, that test fails here instead of in someone's signing loop.