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

MCP x402 - Evidence-Backed Web Verification

von Diogoup26Version 1.2.12i★ 0iLäuft in der CloudRepository ↗
Name in der Registryio.github.Diogoup26/mcp-x402

So installierst du es

What it does

Evidence-backed pre-purchase checks for offer terms, seller trust and policy compliance.

  • Connects Läuft in der Cloud
  • Account or key No key needed
  • Category Recht & Behördendaten

Warum es hier steht

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

Beliebtheit0/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 noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert20/100

Qualität: 4/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (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 MCP x402 - Evidence-Backed Web Verification. Folge https://mcp.popnx.com/i/diogoup26-mcp-x402.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

4/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp-x402-production.up.railway.app) · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

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

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameMCP x402 - Evidence-Backed Web Verification
    Remote MCP server URL · Adressehttps://mcp-x402-production.up.railway.app/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsMCP x402 - Evidence-Backed Web Verification

  4. Ausprobieren

    Nutze MCP x402 - Evidence-Backed Web Verification und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es MCP x402 - Evidence-Backed Web Verification nutzt, oder ein Werkzeug von MCP x402 - Evidence-Backed Web Verification 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 ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameMCP x402 - Evidence-Backed Web Verification
    Connection · Adressehttps://mcp-x402-production.up.railway.app/mcp
  3. MCP x402 - Evidence-Backed Web Verification im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen MCP x402 - Evidence-Backed Web Verification aus deinen Plugins wählen

  4. Ausprobieren

    Nutze MCP x402 - Evidence-Backed Web Verification und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es MCP x402 - Evidence-Backed Web Verification nutzt, oder ein Werkzeug von MCP x402 - Evidence-Backed Web Verification in der Antwort zeigt, bist du verbunden

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

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

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

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

    claude mcp add --transport http --scope user x402 https://mcp-x402-production.up.railway.app/mcp
  3. /mcp in Claude Code eingeben

    MCP x402 - Evidence-Backed Web Verification sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze MCP x402 - Evidence-Backed Web Verification und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es MCP x402 - Evidence-Backed Web Verification nutzt, oder ein Werkzeug von MCP x402 - Evidence-Backed Web Verification 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 · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

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

  3. Ausprobieren

    Nutze MCP x402 - Evidence-Backed Web Verification und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es MCP x402 - Evidence-Backed Web Verification nutzt, oder ein Werkzeug von MCP x402 - Evidence-Backed Web Verification 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 · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

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

  3. Ausprobieren

    Nutze MCP x402 - Evidence-Backed Web Verification und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es MCP x402 - Evidence-Backed Web Verification nutzt, oder ein Werkzeug von MCP x402 - Evidence-Backed Web Verification 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 →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp-x402-production.up.railway.app/mcp

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

Hängst du fest? Frag Leute, die MCP x402 - Evidence-Backed Web Verification nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user x402 https://mcp-x402-production.up.railway.app/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "x402": {
      "url": "https://mcp-x402-production.up.railway.app/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "x402": {
      "type": "http",
      "url": "https://mcp-x402-production.up.railway.app/mcp"
    }
  }
}

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

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Lizenzi
Keine Lizenz angegeben
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
1.2.12
In der Registry veröffentlichti
1. Nov. 2026
Code zuletzt geänderti
14. Nov. 2026
Zuletzt geprüft
17. Nov. 2026
Entwickler
Diogoup26
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.

Verbinden sich über das Internet in

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

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 17. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • preview_verification

    Use this free static preview before paying for verificar_condicoes. Choose offer_terms to inspect warranty, returns and availability; seller_trust to inspect seller identity and authorization; or policy_compliance to inspect required policy terms. It performs no web request, Open

  • consultar_ia

    Use for general questions that do not require live web retrieval. Returns a concise model answer and does not fetch URLs or verify current facts. Use analisar_url for a source-bounded page report and verificar_condicoes for evidence-backed decisions. PT: Use para perguntas gerais

  • analisar_url

    Use to fetch one public HTTP or HTTPS page and return a source-bounded report with summary, facts, risks and recommended actions. The optional objective controls focus but is never evidence. It does not consult other sources; use verificar_condicoes for condition-by-condition dec

  • verificar_condicoes

    Use before an agent trusts, buys or acts to test 1 to 10 explicit conditions against one public HTTP or HTTPS page. Best fits offer and warranty checks, seller identity or authorization checks, and policy compliance checks. Returns confirmed, rejected or uncertain for every condi

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 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

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

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 5 Tagen

  • ✕ Nicht bestanden

    Hat eine Lizenz

    Keine Lizenzdatei im Repo gefunden

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 247 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 4 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

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/diogoup26-mcp-x402.svg)](https://mcp.popnx.com/en/servers/diogoup26-mcp-x402)

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 Recht & Behördendateni

  • Mehr Sterne als 0 % der anderen 1945 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 68 % der anderen 1945 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 51 % der anderen 1945 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 MCP x402 - Evidence-Backed Web Verification sicher?

Er hat 4 von 5 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 in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 5 Tagen geändert, und die neueste Version (1.2.12) kam vor 18 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

Ä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

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

von lexifinaWeit verbreitet★ 2096Aktualisiert vor 9 Tagen

Läuft in der Cloud✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

von librejusticeAm Anfang★ 36Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

von street1983nkAm Anfang★ 18Aktualisiert vor 5 Monaten

Läuft in der Cloud✓ vom Dienst · infranode.dev

Fedlex Connector

Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.

von JayTheSkierAm Anfang★ 8Aktualisiert vor 7 Monaten

Läuft in der Cloud✓ vom Dienst · fedlex-connector.ch
Im Vergleich mit ähnlichen
Dieser
MCP x402 - Evidence-Backed Web Verification
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
Läuft woLä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 InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen4/54/44/44/44/44/4
Lizenz–NOASSERTIONMITApache-2.0Apache-2.0MIT
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.

MCP x402 — Evidence-Backed Web Verification for AI Agents

Verify a seller, product, offer, policy, or claim before an agent acts

Give an AI agent a public HTTP(S) page and 1 to 10 concrete conditions. The verificar_condicoes tool returns an evidence-based decision for every condition:

  • confirmado — the page clearly supports the condition.
  • rejeitado — the page clearly contradicts the condition.
  • incerto — the available page evidence is insufficient.

Each verification includes the final source URL, page title, timestamp, condition-by-condition explanation, quoted evidence when available, a unique verificationId, and a SHA-256 pageHash.

Designed for
  • AI purchasing and procurement agents;
  • offer, warranty, returns and availability checks;
  • seller identity and authorization checks;
  • policy and terms compliance checks;
  • commercial automation that requires evidence before taking action.
Three buyer decisions
Buyer needSelect this tool when the agent must decide
Offer termsWhether an offer satisfies warranty, returns, price or delivery requirements before purchase
Seller trustWhether the page identifies the seller and supports authorization or registration claims
Policy complianceWhether terms or policies contain required cancellation, privacy or support conditions

Use the free preview_verification MCP tool or the free HTTP endpoint POST /preview/verify-conditions first when the buyer needs to inspect the complete result contract without fetching a page, calling OpenAI or making a payment. Use verificar_condicoes for a fresh verification of a real public URL.

Simple x402 integration
  • Free preflight validation before payment.
  • $0.05 USDC per verification on Base mainnet.
  • No account or subscription required.
  • Available through MCP and HTTP.
  • Ready-to-run buyer included in this repository.
  • Bazaar discovery metadata enabled on the paid HTTP and MCP surfaces.
Free static result demonstration

The following example is fictitious and performs no request, OpenAI call, or payment. It shows the complete result contract an agent receives for 0.05 USDC when using verificar_condicoes.

Example input:

{

"url": "https://shop.example/offers/refurbished-laptop", "condicoes": [ "The offer includes a 12-month warranty.", "The return period is at least 30 days.", "The seller is an authorized manufacturer reseller." ], "contexto": "Pre-purchase seller verification." }

Example result:

{

"source": "https://shop.example/offers/refurbished-laptop", "title": "Refurbished Laptop Offer — Example Seller", "verifiedAt": "2026-01-01T00:00:00.000Z", "decisao": { "decisao": "incerto", "condicoes": [ { "condicao": "The offer includes a 12-month warranty.", "estado": "confirmada", "prova": "Includes a 12-month limited warranty.", "explicacao": "The offer explicitly states the warranty duration." }, { "condicao": "The return period is at least 30 days.", "estado": "rejeitada", "prova": "Returns accepted within 14 days of delivery.", "explicacao": "The stated 14-day return period contradicts the required minimum of 30 days." }, { "condicao": "The seller is an authorized manufacturer reseller.", "estado": "incerta", "prova": null, "explicacao": "The page provides no evidence of manufacturer authorization." } ], "resumo": "The warranty is confirmed, the return-period requirement is rejected, and reseller authorization remains uncertain." }, "verificationId": "00000000-0000-4000-8000-000000000000", "pageHash": "sha256:0000000000000000000000000000000000000000000000000000000000000000" }

This demonstrates the distinction between supporting evidence, contradictory evidence, and absence of evidence. The real paid result uses the fetched page, current timestamp, a unique verificationId, and the SHA-256 hash of the page content.

Screen a shortlisted refurbished laptop

Apply the local decision example to the buyer's original request and the parsed verification response for the same offer. To try it offline, assign the example input and result above to request and verification in a Node.js module in the repository root.

import { decideOffer } from "./examples/offer-decision.mjs";

const decision = decideOffer(request.condicoes, verification); console.log(decision.action, decision.reasons);

The laptop is excluded because its quoted 14-day return period contradicts the required 30 days. A quoted contradiction excludes the offer even if another requirement is unclear. All mandatory terms need quoted support to recommend. Missing, duplicated or inconclusive evidence sends the offer to review when there is no supported contradiction. This local step makes no payment or purchase.

Free MCP preview tool

preview_verification is a free, model-callable MCP tool. It performs no live web request, OpenAI call or payment. Choose one of these values:

  • offer_terms
  • seller_trust
  • policy_compliance

It returns a realistic structured input and result, identifies the paid verificar_condicoes tool and provides the exact next step. Preview calls are logged separately and never counted as paid demand or revenue.

Live endpoints
  • MCP: https://mcp-x402-production.up.railway.app/mcp
  • Free MCP preflight: POST https://mcp-x402-production.up.railway.app/preflight/mcp
  • Free verification preflight: POST https://mcp-x402-production.up.railway.app/preflight/verify-conditions
  • Free static HTTP preview: POST https://mcp-x402-production.up.railway.app/preview/verify-conditions
  • Paid verification: POST https://mcp-x402-production.up.railway.app/verify-conditions
  • Health: GET https://mcp-x402-production.up.railway.app/health

The service also provides paid public URL analysis and general AI consultation through analisar_url and consultar_ia.

Live Service

  • Base URL: https://mcp-x402-production.up.railway.app
  • Health check: GET /health
  • MCP endpoint: POST /mcp
  • Paid URL analysis: POST /analyze
  • Price: $0.05 USDC per paid request
  • Network: Base mainnet (eip155:8453)

Production Status

  • Production deployment active on Railway
  • x402 version 2 payment flow
  • Base mainnet payments (eip155:8453)
  • Paid HTTP endpoints return valid x402 challenges with Bazaar metadata
  • MCP and HTTP payment, execution, settlement, and delivery confirmed on-chain
  • MCP Bazaar metadata advertises the public HTTPS MCP server URL
  • CDP native MCP catalog indexing is not yet claimed as confirmed; upstream tracking: coinbase/cdp-sdk#764

MCP Tools

Decision verification

verificar_condicoes — $0.05 USDC

A paid decision-verification tool for agents.

Give it a public URL and one or more concrete conditions. It returns a decision based only on evidence extracted from that page:

  • confirmado — the page clearly proves the condition.
  • rejeitado — the page clearly contradicts the condition.
  • incerto — the page does not provide enough evidence.

Each result includes the final source URL, page title, verification timestamp, condition-by-condition explanation, and a short quoted proof where available.

Example conditions:

  • “The page identifies the seller.”
  • “The product is available in Portugal.”
  • “The page shows a price in euros.”
  • “The document states that the service supports x402.”

This is designed for agents that need an evidence-based decision before taking the next action.

ToolDescriptionPrice
preview_verificationReturns a static structured example for offer, seller or policy verification. No network retrieval or OpenAI call.Free
consultar_iaSends a prompt to the OpenAI Responses API.$0.02 USDC
analisar_urlFetches and analyzes a public HTTP or HTTPS page.$0.05 USDC
verificar_condicoesVerifies concrete conditions on a public page and returns evidence-based decisions.$0.05 USDC

Technology

  • Node.js and TypeScript
  • Express
  • Model Context Protocol
  • OpenAI Responses API
  • x402 payments
  • viem
  • Cheerio
  • Railway

Security

  • HTTPS provided by Railway
  • Helmet security headers
  • Rate limit of 100 requests per 15 minutes
  • Structured request logs with unique request IDs
  • Host validation and Railway health-check support
  • Restricted OpenAI API key with access only to /v1/responses
  • Environment files and secrets excluded from Git

Environment Variables

Server
VariableRequiredDescription
OPENAI_API_KEYYesOpenAI project API key.
OPENAI_MODELNoOpenAI model. Defaults to gpt-5-mini.
HOSTNoListening host. Defaults to 0.0.0.0.
PORTNoListening port. Defaults to 3000.
RAILWAY_PUBLIC_DOMAINRailwayAutomatically supplied by Railway.
PUBLIC_SERVICE_URLNoCanonical public HTTPS origin used in discovery metadata. Railway derives it automatically from RAILWAY_PUBLIC_DOMAIN; the production URL is the fallback.
OBSERVABILITY_SALTRecommendedStable secret salt used only to pseudonymize source/client fingerprints across restarts.
Local Buyer
VariableRequiredDescription
EVM_PRIVATE_KEYYesPrivate key of the Base mainnet buyer wallet. Never commit this value.
JOURNEY_IDNoExisting correlation ID to reuse; otherwise the buyer generates one.

Example local .env.test file:

EVM_PRIVATE_KEY=your_private_key_here

Local Development

Install dependencies:

npm install

Start the development server:

npm run dev

Build the project:

npm run build

Start the compiled server:

npm start

Health Check

The health endpoint is public and does not require payment:

curl https://mcp-x402-production.up.railway.app/health

Railway Log Diagnostics

Railway currently accepts --since for historical HTTP logs but rejects --until. On Windows PowerShell, export a bounded application and HTTP log window without using the broken flag:

.\scripts\export-railway-window.ps1 `

-StartUtc "2026-08-22T16:31:22.401228537Z" -EndUtc "2026-08-23T06:21:18.045229877Z" -OutputPrefix "railway-diagnostic"

The script retrieves logs from the lower bound and applies the upper UTC bound locally using ordinal ISO-8601 comparison, which preserves Railway's nanosecond timestamps. It writes raw captures plus bounded app and http NDJSON files.

Analyze both bounded files while reading and validating every physical line:

npm run logs:analyze -- \

--since "2026-08-22T16:31:22.401228537Z" \ --pretty \ --out railway-diagnostic-report.json \ railway-diagnostic-app.ndjson railway-diagnostic-http.ndjson

The report includes per-file coverage, empty/valid/invalid line counts, timestamp bounds, separation of Diogo-*, RailwayHealthcheck, known probes or indexers and potentially external traffic, journey reconstruction and funnel stopping points. It joins application railwayRequestId values to Railway HTTP requestId values, understands HTTP clientUa, groups server-generated journey IDs by fingerprint and temporal proximity, and counts only accepted normalized feedback. It deliberately does not treat an isolated 402 as purchase intent and does not infer human identity or motivation from request metadata.

Ready-to-Run x402 Buyer

The r

Nur der Anfang wird gezeigt; den Rest findest du im Repo