402-mcp

Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

👁 MIT-Lizenz
👁 TypeScript
👁 Node
👁 Abdeckung
👁 Nostr
👁 GitHub Sponsors

L402 + x402 Client-MCP, das KI-Agenten wirtschaftliche Handlungsfähigkeit verleiht. Entdecken, bezahlen und konsumieren Sie jede zahlungspflichtige API – ohne menschliche Registrierung, ohne API-Schlüssel, ohne Zwischenhändler.

• Entdecken Sie kostenpflichtige APIs auf Nostr – keine URLs im Voraus erforderlich

• Automatische Bezahlung mit Lightning (NWC), Cashu-E-Cash oder QR-Code-Fallback für Menschen

• Anmeldedaten zwischengespeichert und verschlüsselt im Ruhezustand (AES-256-GCM)

• Funktioniert mit jedem L402-Server – toll-booth, Aperture oder jede zukünftige Implementierung

Schnelleinstieg

1. Installieren

npx 402-mcp

2. Mit Claude Code verbinden

claude mcp add 402-mcp -- npx 402-mcp

3. Ausprobieren

Fragen Sie Claude: "Suche nach kostenpflichtigen Witz-APIs mit l402-search" – kein Wallet erforderlich, nur Entdeckung.

Bereit für kostenpflichtige Aufrufe? Lesen Sie den vollständigen Schnelleinstiegsleitfaden, um ein Wallet einzurichten und Ihrem Agenten bei seiner ersten API-Zahlung zuzusehen.

Related MCP server: ag402-mcp

Funktionsweise

graph LR
 A["1. l402-config()"] --> B["2. l402-discover(url)"]
 B --> C["3. Agent reasons<br/>about pricing"]
 C --> D["4. l402-buy-credits()<br/>or l402-fetch()"]
 D --> E["5. l402-fetch(url)<br/>with credentials"]
 E --> F["6. Data returned<br/>+ balance cached"]

Beispielsitzung:

Agent: "I need routing data from routing.trotters.cc"

1. l402-config()
 -> nwcConfigured: true, maxAutoPaySats: 1000

2. l402-discover("https://routing.trotters.cc/api/route")
 -> 10 sats/request, toll-booth detected, tiers available

3. Agent reasons: "I need ~20 requests. The 500-sat tier
 gives 555 credits. Better value."

4. l402-buy-credits(url, amountSats=500)
 -> Paid 500 sats, received 555 credits

5. l402-fetch("https://routing.trotters.cc/api/route?from=...&to=...")
 -> 200 OK, route data, 545 credits remaining

Für detaillierte Architektur- und Zahlungsflussdiagramme siehe docs/architecture.md.

Konfiguration

Transportauswahl und Fallback

Wenn ein Ereignis vom Typ 31402 mehrere URLs (eine pro Transport) bewirbt, wählt 402-mcp die beste basierend auf Ihrer Konfiguration aus:

1. Präferenz zuerst – wenn TRANSPORT_PREFERENCE=tor und eine .onion-URL verfügbar ist, wird diese zuerst versucht.

2. Verfügbarkeits-Fallback – wenn der bevorzugte Transport nicht erreichbar ist (Proxy nicht konfiguriert, Timeout), greift der Client auf die nächste URL in der Liste zurück.

3. Clearnet-Standard – wenn keine Präferenz festgelegt ist, werden Clearnet-URLs vor .onion- oder HNS-Einträgen versucht.

Dienste können mehrere Endpunkte für denselben Dienst (gleiche Preisgestaltung, gleicher Macaroon-Schlüssel) über verschiedene Transporte ankündigen. Dies dient rein der Zensurresistenz; Sie müssen sich beim Wechsel des Transports nicht erneut authentifizieren. Um Tor- oder HNS-Endpunkte zu erreichen, müssen Sie die entsprechenden Proxy-/Gateway-Umgebungsvariablen oben konfigurieren.

Tools

Core L402 (jeder Server)

toll-booth-Erweiterungen

Zahlungsmethoden

Drei Zahlungswege, versucht in Prioritätsreihenfolge:

1. NWC (Nostr Wallet Connect) – voll autonom; zahlt von Ihrem verbundenen Wallet

2. Cashu – voll autonom; schmilzt E-Cash-Token, um Rechnungen zu bezahlen

3. Menschliche Bestätigung – zeigt QR-Code an, fragt den Status der Abwicklung ab

Der Agent kann die Methode pro Aufruf überschreiben, oder Sie können nur die gewünschten Methoden konfigurieren.

l402-fetch verarbeitet vier HTTP 402-Herausforderungsvarianten transparent:

Sicherheit

MAX_AUTO_PAY_SATS begrenzt jede einzelne autonome Zahlung. Über diesem Limit muss der Agent den Menschen um Genehmigung bitten. Der Agent kann dieses Limit über l402-config lesen und in Kaufentscheidungen einbeziehen.

Datenschutz

402-mcp speichert Anmeldedaten nur lokal auf Ihrem Computer (~/.402-mcp/credentials.json, verschlüsselt im Ruhezustand). Es werden keine Daten an Dritte gesendet. Keine Konten, kein Tracking, keine Analysen. Zahlungen verwenden Lightning oder Cashu – von Natur aus pseudonym.

Ökosystem

Durchsuchen Sie Live-L402-Dienste auf 402.pub – dem dezentralen Marktplatz für zahlungspflichtige APIs.

402-mcp ist die zahlungs-agnostische Alternative zu Lightning Labs' lightning-agent-tools und Coinbases x402 – kein Lightning-Node erforderlich, mehrere Wallets, verschlüsselte Anmeldedaten.

Verwenden Sie die Tools von Lightning Labs, wenn Sie Agenten möchten, die ihren eigenen Lightning-Node betreiben. Verwenden Sie 402-mcp, wenn Sie Agenten möchten, die von jedem Wallet ohne Infrastruktur bezahlen.

Siehe CONTRIBUTING.md für Entwicklungseinrichtung und Richtlinien.

Erstellt von @forgesworn.

• Lightning-Trinkgelder: thedonkey@strike.me

• Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

Teil des ForgeSworn Toolkits

ForgeSworn baut Open-Source-Tools für kryptografische Identität, Zahlungen und Koordination für Nostr.

Lizenz

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers