Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

PayStage x402 Guard — payment safety before the wallet signs

von base-buzzVersion 0.4.9i★ 5 (Sterne des ganzen Repos)iLäuft auf deinem ComputerOffizielle Website ↗
Name in der Registryio.github.base-buzz/x402-guard

So installierst du es

What it does

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

  • Connects Läuft auf deinem Computer
  • Account or key No key needed
  • Category Onlineshops & Zahlungen

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit28/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert40/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: 207 (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte PayStage x402 Guard — payment safety before the wallet signs. Folge https://mcp.popnx.com/i/base-buzz-x402-guard.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 18. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server PayStage x402 Guard — payment safety before the wallet signs für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "x402-guard": { "command": "npx", "args": [ "-y", "@paystage/x402-guard" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von PayStage x402 Guard — payment safety before the wallet signs wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  3. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "x402-guard": {
          "command": "npx",
          "args": [
            "-y",
            "@paystage/x402-guard"
          ]
        }
      }
    }
  4. Claude beenden und neu öffnen

  5. Ausprobieren

    Nutze PayStage x402 Guard — payment safety before the wallet signs und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es PayStage x402 Guard — payment safety before the wallet signs nutzt, oder ein Werkzeug von PayStage x402 Guard — payment safety before the wallet signs in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann PayStage x402 Guard — payment safety before the wallet signs noch nicht verbinden

PayStage x402 Guard — payment safety before the wallet signs läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die PayStage x402 Guard — payment safety before the wallet signs verbinden kann

  • Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Installiere zuerst Node.js auf deinem Computer (nur einmal)

B · Andere in Onlineshops & Zahlungen, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server PayStage x402 Guard — payment safety before the wallet signs für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user x402-guard -- npx -y @paystage/x402-guard 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von PayStage x402 Guard — payment safety before the wallet signs wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

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

    PayStage x402 Guard — payment safety before the wallet signs sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze PayStage x402 Guard — payment safety before the wallet signs und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es PayStage x402 Guard — payment safety before the wallet signs nutzt, oder ein Werkzeug von PayStage x402 Guard — payment safety before the wallet signs in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server PayStage x402 Guard — payment safety before the wallet signs für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "x402-guard": { "command": "npx", "args": [ "-y", "@paystage/x402-guard" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von PayStage x402 Guard — payment safety before the wallet signs wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  3. KI-Chat in Cursor im Agent-Modus öffnen

  4. Ausprobieren

    Nutze PayStage x402 Guard — payment safety before the wallet signs und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es PayStage x402 Guard — payment safety before the wallet signs nutzt, oder ein Werkzeug von PayStage x402 Guard — payment safety before the wallet signs in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server PayStage x402 Guard — payment safety before the wallet signs für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "x402-guard": { "type": "stdio", "command": "npx", "args": [ "-y", "@paystage/x402-guard" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von PayStage x402 Guard — payment safety before the wallet signs wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  3. KI-Chat in VS Code im Agent-Modus öffnen

  4. Ausprobieren

    Nutze PayStage x402 Guard — payment safety before the wallet signs und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es PayStage x402 Guard — payment safety before the wallet signs nutzt, oder ein Werkzeug von PayStage x402 Guard — payment safety before the wallet signs in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die PayStage x402 Guard — payment safety before the wallet signs nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

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"
      ]
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

GitHub-Sternei
5 (Sterne des ganzen Repos)
Dieses Repo enthält mehrere MCP-Einträge; die Sterne zählen in Ranglisten nur einmal
Downloads pro Wochei
2.371/Wo.
Verbindung
Läuft auf deinem Computer
Neueste Versioni
0.4.9
In der Registry veröffentlichti
18. Nov. 2026
Code zuletzt geänderti
18. Nov. 2026
Entwickler
base-buzz
Pakete
npm: @paystage/x402-guard
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

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

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 18. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto base-buzz bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: heute

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für @paystage/x402-guard@0.4.9

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 18. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

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

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Onlineshops & Zahlungeni

  • Mehr Sterne als 0 % der anderen 2903 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 99 % der anderen 2903 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 2903 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist PayStage x402 Guard — payment safety before the wallet signs sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt heute geändert, und die neueste Version (0.4.9) kam heute in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Stripe MCP

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

von stripeWeit verbreitet★ 2072Aktualisiert vor 13 Monaten

Läuft in der Cloud✓ vom Dienst · stripe.com

flightclaw

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

von flightclawWachsend★ 86Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · flightclaw.com

Trade It

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

von trade-it-incAm Anfang★ 62Aktualisiert vor 33 Tagen

Läuft in der Cloud✓ vom Dienst · tradeit.app

idealo MCP Server

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

von idealoAm Anfang★ 28Aktualisiert vor 6 Monaten

Läuft in der Cloud✓ vom Dienst · mcp.idealo.com
Im Vergleich mit ähnlichen
Dieser
PayStage x402 Guard — payment safety before the wallet signs
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
Läuft woWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinJaNeinNeinNeinNein
Basisprüfungen3/34/44/44/44/44/4
LizenzMITMITMITCC0-1.0MITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

@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.