MCP x402 — evidenzbasierte Web-Verifizierung für KI-Agenten

Verifizieren Sie einen Verkäufer, ein Produkt, ein Angebot, eine Richtlinie oder eine Behauptung, bevor ein Agent handelt

Geben Sie einem KI-Agenten eine öffentliche HTTP(S)-Seite und 1 bis 10 konkrete Bedingungen. Das Tool verificar_condicoes liefert für jede Bedingung eine evidenzbasierte Entscheidung:

• confirmado — die Seite unterstützt die Bedingung eindeutig.

• rejeitado — die Seite widerspricht der Bedingung eindeutig.

• incerto — die verfügbaren Seitenbeweise sind unzureichend.

Jede Verifizierung enthält die endgültige Quell-URL, den Seitentitel, den Zeitstempel, eine Erklärung für jede Bedingung, zitierte Beweise, sofern verfügbar, eine eindeutige verificationId und einen SHA-256-pageHash.

Entwickelt für

• KI-Einkaufs- und Beschaffungsagenten;

• Verkäufer-, Produkt- und Angebotsverifizierung;

• Due-Diligence-Prüfung vor dem Kauf;

• Prüfung von Richtlinien und Bedingungen;

• kommerzielle Automatisierung, die Beweise erfordert, bevor sie handelt.

Einfache x402-Integration

• Kostenlose Preflight-Validierung vor der Zahlung.

• $0.05 USDC pro Verifizierung auf Base-Mainnet.

• Kein Konto oder Abonnement erforderlich.

• Verfügbar über MCP und HTTP.

• Ein einsatzbereiter Buyer ist in diesem Repository enthalten.

• Coinbase-x402-Validierung bestanden und Bazaar-Erkennung aktiviert.

Live-Endpunkte

• MCP: https://mcp-x402-production.up.railway.app/mcp

• Kostenlose Verifizierungs-Preflight: POST https://mcp-x402-production.up.railway.app/preflight/verify-conditions

• Bezahlte Verifizierung: POST https://mcp-x402-production.up.railway.app/verify-conditions

• Health: GET https://mcp-x402-production.up.railway.app/health

Der Dienst bietet außerdem kostenpflichtige öffentliche URL-Analyse und allgemeine KI-Beratung über analisar_url und consultar_ia.

Related MCP server: Pylon MCP Server

Live-Dienst

• Basis-URL: https://mcp-x402-production.up.railway.app

• Health-Check: GET /health

• MCP-Endpunkt: POST /mcp

• Kostenpflichtige URL-Analyse: POST /analyze

• Preis: $0.05 USDC pro kostenpflichtiger Anfrage

• Netzwerk: Base-Mainnet (eip155:8453)

Produktionsstatus

• Produktionsbereitstellung aktiv auf Railway

• x402 Version 2 Zahlungsablauf

• Base-Mainnet-Zahlungen (eip155:8453)

• Coinbase-x402-Validierung bestanden

• Simulation mit HTTP 402 akzeptiert

• Bazaar-Erkennungsmetadaten aktiviert

• Coinbase-Index aktiv

MCP-Tools

Entscheidungsverifizierung

verificar_condicoes — $0.05 USDC

Ein kostenpflichtiges Entscheidungsverifizierungstool für Agenten.

Geben Sie ihm eine öffentliche URL und eine oder mehrere konkrete Bedingungen. Es liefert eine Entscheidung, die ausschließlich auf Beweisen basiert, die von dieser Seite extrahiert wurden:

• confirmado — die Seite beweist die Bedingung eindeutig.

• rejeitado — die Seite widerspricht der Bedingung eindeutig.

• incerto — die Seite liefert nicht genügend Beweise.

Jedes Ergebnis enthält die endgültige Quell-URL, den Seitentitel, den Verifizierungszeitstempel, eine Erklärung für jede Bedingung und einen kurzen zitierten Beweis, sofern verfügbar.

Beispielbedingungen:

• „Die Seite identifiziert den Verkäufer.“

• „Das Produkt ist in Portugal erhältlich.“

• „Die Seite zeigt einen Preis in Euro.“

• „Das Dokument besagt, dass der Dienst x402 unterstützt.“

Dies ist für Agenten gedacht, die eine evidenzbasierte Entscheidung benötigen, bevor sie den nächsten Schritt unternehmen.

Technologie

• Node.js und TypeScript

• Express

• Model Context Protocol

• OpenAI Responses API

• x402-Zahlungen

• viem

• Cheerio

• Railway

Sicherheit

• HTTPS von Railway bereitgestellt

• Helmet-Sicherheitsheader

• Ratenbegrenzung von 100 Anfragen pro 15 Minuten

• Strukturierte Anforderungsprotokolle mit eindeutigen Anforderungs-IDs

• Host-Validierung und Unterstützung für Railway-Health-Checks

• Eingeschränkter OpenAI-API-Schlüssel mit Zugriff nur auf /v1/responses

• Umgebungsdateien und Geheimnisse von Git ausgeschlossen

Umgebungsvariablen

Server

Lokaler Buyer

Beispiel für eine lokale .env.test-Datei:

EVM_PRIVATE_KEY=your_private_key_here

Lokale Entwicklung

Abhängigkeiten installieren:

npm install

Starten Sie den Entwicklungsserver:

npm run dev

Projekt erstellen:

npm run build

Starten Sie den kompilierten Server:

npm start

Health-Check

Der Health-Endpunkt ist öffentlich und erfordert keine Zahlung:

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

Einsatzbereiter x402-Buyer

Das Repository enthält einsatzbereite Buyer für Anwendungen und KI-Agenten. Der MCP-Buyer verbindet sich mit dem Live-Dienst, validiert die x402-Zahlungsanforderungen gegen Base-Mainnet-USDC und eine maximale Zahlung von $0.05, signiert die Zahlung, wiederholt denselben Tool-Aufruf und gibt die Abrechnungsquittung und das Ergebnis aus.

Klonen und vorbereiten des Buyers:

git clone https://github.com/Diogoup26/mcp-x402.git
cd mcp-x402
npm install

Erstellen Sie eine lokale .env.test-Datei im Projektstamm:

EVM_PRIVATE_KEY=0xYOUR_64_HEX_CHARACTER_PRIVATE_KEY

Committen Sie niemals .env.test und legen Sie den privaten Schlüssel nicht offen.

Projekt erstellen:

npm run build

Die folgenden Befehle autorisieren echte x402-Zahlungen auf Base-Mainnet:

• consultar_ia: $0.02 USDC

• analisar_url: $0.05 USDC

• verificar_condicoes: $0.05 USDC

HTTP-URL-Analyse

npm run analyze -- "https://example.com" "Summarize this page."

HTTP-Entscheidungsverifizierung

npm run verify -- "https://example.com" "The page identifies the seller."

MCP-URL-Analyse

npm run mcp:analyze -- "https://example.com" "Summarize this page."

MCP-KI-Beratung

npm run mcp:consult -- "Reply only with: MCP OK"

MCP-Entscheidungsverifizierung

npm run mcp:verify -- "https://example.com" "The page identifies the seller."

Eine erfolgreiche MCP-Zahlung gibt Folgendes aus:

• PAGAMENTO MCP: success

• die Abrechnungsquittung

• die Tool-Antwort

Der MCP-Buyer gibt niemals den privaten Schlüssel aus und lehnt jede Zahlung ab, die:

• nicht auf Base-Mainnet ist;

• nicht den konfigurierten Base-USDC-Vertrag verwendet;

• $0.05 USDC überschreitet.

Bereitstellung

Der main-Zweig ist mit Railway verbunden. Jeder erfolgreiche Push löst eine neue Bereitstellung aus. Railway verwendet:

npm run build
npm start

Der Health-Check-Pfad der Bereitstellung ist /health.

Lizenz

ISC