LiveAuth MCP Server
LiveAuth MCP Server
Authentifizierung, Pay-per-Call-Metering und signierte Quittungen für KI-Agenten und MCP-Tools: Bitcoin-nativ, Lightning-gestützt und L402-kompatibel.
Dieser MCP-Server ermöglicht es jedem KI-Agenten, sich über Proof-of-Work (kostenlos, ohne Konto) oder Lightning-Netzwerk-Mikrozahlungen (Sats) bei Ihrer API zu authentifizieren und anschließend nachfolgende Tool-Aufrufe mit Preis pro Aufruf, idempotenten Umsatzereignissen und HMAC-signierten Quittungen zu messen und zu monetarisieren, die Prüfer offline verifizieren können.
Verwenden Sie ihn, wenn Sie:
Eine API oder ein MCP-Tool hinter echte Rechenkosten oder echte Sats stellen möchten (Anti-Spam durch Design, nicht durch CAPTCHA).
KI-Agenten pro Aufruf belasten möchten, ohne sie für ein Konto anzumelden.
Eine manipulationssichere Prüfspur (signierte
mcp-call-receipt-v1) für jeden bezahlten Tool-Aufruf ausstellen möchten.Lightning-gestützten L402-Bundle-Zugang für vorausbezahlte MCP-Sitzungen anbieten möchten.
In 5 Sekunden ausprobieren – kein Konto, kein API-Schlüssel:
npx @liveauth-labs/mcp-serverOhne Konfiguration verwendet der Server das anonyme Demo-Projekt von LiveAuth und den echten PoW-Ablauf. Fügen Sie LIVEAUTH_API_KEY nur hinzu, wenn Sie die Richtlinie, Preisgestaltung oder Zuordnung eines bestimmten Projekts benötigen.
Verfügbare Tools (Glama / MCP automatisch erkannt)
Tool | Zweck |
| Eine Sitzung beginnen. Gibt eine PoW-Herausforderung, eine Lightning-Rechnung oder einen L402-Bundle-Hinweis zurück. |
| Eine gelöste PoW-Herausforderung, eine bezahlte Lightning-Rechnung oder ein L402-Macaroon einreichen → ein JWT erhalten. |
| Nutzung nach einem Aufruf messen. Mit |
| Ein Refresh-Token gegen ein neues JWT austauschen – keine erneute Authentifizierung erforderlich. |
| Sitzungs-/Zahlungsstatus abfragen (Lightning-Bestätigung, Ablauf). |
| Die BOLT11-Rechnung für eine Sitzung abrufen (lnget-kompatibel). |
| Verbleibendes Budget, verwendete Aufrufe und Rate-Limit-Fenster abfragen. |
Vollständige Parameter- und Antwortschemata finden Sie in der Tool-Referenz unten.
Related MCP server: Agent Receipts
5-Minuten-Schnellstart
Option 1 – Ohne Anmeldedaten PoW (kein Konto, kein Schlüssel, keine Wallet)
npx @liveauth-labs/mcp-serverRufen Sie in einem MCP-Client liveauth_mcp_start auf, dann liveauth_mcp_confirm mit nur der zurückgegebenen quoteId. Das Paket verwendet seinen vorhandenen PoW-Löser lokal erneut und die LiveAuth-API verifiziert die signierte Herausforderung, bevor sie ein kurzlebiges Sitzungs-JWT ausstellt.
Option 2 – Produktionsmodus
Holen Sie sich einen API-Schlüssel unter liveauth.app.
Fügen Sie ihn zur
claude_desktop_config.jsonvon Claude Desktop hinzu:
{
"mcpServers": {
"liveauth": {
"command": "npx",
"args": ["-y", "@liveauth-labs/mcp-server"],
"env": {
"LIVEAUTH_API_BASE": "https://api.liveauth.app",
"LIVEAUTH_API_KEY": "la_pk_your_public_key"
}
}
}
}Starten Sie Claude neu. Fertig.
Option 3 – Programmatisch (CLI / SDK)
export LIVEAUTH_API_KEY=la_pk_xxx
npx @liveauth-labs/mcp-serverDas Paket ist auch ein TypeScript-SDK – siehe SDK-Nutzung unten. Das CLI-Bin ist liveauth-mcp.
Warum LiveAuth?
Für API-Anbieter / Tool-Entwickler:
Stoppen Sie Bots auf der Protokollebene. PoW und Lightning-Sats sind nicht wiederverwendbar, nicht phishbar und erfordern keine Benutzerkonten.
Berechnen Sie pro Aufruf in Sats. Wir signieren eine Quittung, die Sie Prüfern, Kunden oder Ihrem Buchhalter zeigen können.
Wickeln Sie jedes MCP-Tool mit einer Zeile (
createMcpGate) und Sie erhalten Umsatz pro Tool, Mindest-/Höchstpreise pro Tool und idempotente Wiederholungen.
Für KI-Agenten / Agent-Entwickler:
Erlaubnisfreier Zugriff auf kostenpflichtige APIs – PoW lösen oder Sats zahlen, ein JWT erhalten. Keine Anmeldung, keine E-Mail, kein OAuth-Tanz.
Verwenden Sie PoW, Lightning-Rechnungen oder L402-Bundle-Macarons für den Agentenzugriff.
Projekte können bei Konfiguration über einen eigenen Lightning-Knoten abrechnen; andernfalls verwenden Zahlungen den von LiveAuthCore konfigurierten Knoten.
Die Mathematik, die zählt: Wenn Ihr Tool von einem Bot abgegriffen wird, reicht eine Gebühr von 1 Sat pro Aufruf aus, um den Scraper unrentabel zu machen. Wir nennen das Kosten-des-Angriffs-Ökonomie, und das ist der eigentliche Grund, warum wir existieren.
Installation
npm install -g @liveauth-labs/mcp-serverOder direkt mit npx verwenden:
npx @liveauth-labs/mcp-serverGoose
LiveAuth für Goose verwendet denselben standardbasierten stdio-MCP-Server wie jeder andere Client – es gibt keinen Goose-Wrapper, keinen Daemon und keine doppelte Authentifizierungslaufzeit.
Oder den offiziellen Deep-Link und aktuelle Fallbacks ausgeben:
npx @liveauth-labs/mcp-server setup gooseFür eine einmalige Goose-CLI-Sitzung:
goose session --with-extension "liveauth:npx -y @liveauth-labs/mcp-server"Manuelle Goose-stdio-Konfiguration, wenn der Deep-Link nicht verfügbar ist:
extensions:
liveauth:
type: stdio
name: LiveAuth
enabled: true
cmd: npx
args: ["-y", "@liveauth-labs/mcp-server"]
env_keys: []
envs: {}
timeout: 300Bearbeiten Sie eine vorhandene Goose-Konfiguration nicht destruktiv. Bevorzugen Sie den Deep-Link oder goose configure; wenn Sie später Projektkonfiguration hinzufügen, geben Sie sie über die Erweiterungs-Geheimniseinstellungen von Goose ein, nicht über gemeinsames Klartext-YAML.
Goose-Schnelltest
Fragen Sie Goose:
Verwenden Sie LiveAuth, um den Standard-Authentifizierungsablauf zu starten. Bestätigen Sie das zurückgegebene Angebot und zeigen Sie dann meine LiveAuth-Nutzung.
Der anfängliche Ablauf verwendet die PoW-Herausforderung des anonymen Demo-Projekts und erfordert keine Wallet. Ein Projekt-öffentlicher Schlüssel ist optional:
Variable | Wann setzen? |
| Projektspezifische Richtlinie, Preisgestaltung und Zuordnung. |
| Eine selbst gehostete LiveAuth-API anstelle von |
| Explizit für die ältere lokal simulierte Lightning-Demo entscheiden. |
Wenn ein bezahlter Ablauf angefordert wird, behalten die Tool-Ergebnisse die vorhandenen Rechnungsfelder bei und enthalten auch portable strukturierte Daten:
{
"lightning": {
"invoice": "lnbc...",
"lightningUri": "lightning:lnbc...",
"amountSats": 21,
"expiresAt": "2030-03-17T17:46:40.000Z",
"status": "pending"
}
}Clients mit MCP-Apps-Unterstützung können den enthaltenen QR-Code, die Open-Wallet-Aktion, den Ablauf und den Live-Status bezahlt/ausstehend/abgelaufen rendern. Andere Clients erhalten die JSON- und QR-Bildinhalte als normale MCP-Ergebnisse.
Goose-Fehlerbehebung
Wenn der Link nicht geöffnet wird, führen Sie
npx @liveauth-labs/mcp-server setup gooseaus und verwenden Sie dessen Ein-Sitzungs- oder manuellen Fallback.Wenn
npxnicht verfügbar ist, installieren Sie eine aktuelle Node.js-Version (Node 18 oder neuer).Wenn ein bereitgestellter Projektschlüssel abgelehnt wird, entfernen Sie ihn, um den anonymen PoW-Ablauf zu verifizieren; ungültige und widerrufene Schlüssel fallen absichtlich nicht auf die Demo zurück.
Wenn eine Lightning-Rechnung abläuft, rufen Sie
liveauth_mcp_starterneut auf, um ein frisches Angebot zu erhalten.Bewahren Sie Refresh-Tokens und alle nicht öffentlichen Anmeldedaten von Protokollen und Klartextkonfiguration fern.
LiveAuth ermöglicht es Agenten, Autorisierung zur Laufzeit zu erwerben, anstatt dass jedes Tool im Voraus mit dauerhaften Anmeldedaten ausgestattet werden muss.
SDK-Nutzung
Das Paket kann auch als TypeScript/JavaScript-SDK importiert werden. Das Importieren des Pakets startet nicht den stdio-MCP-Server; die CLI befindet sich im liveauth-mcp-Bin.
Client-Auth-Helfer
import { createMcpClient } from '@liveauth-labs/mcp-server';
const liveauth = createMcpClient({
publicKey: 'la_pk_xxx',
baseUrl: 'https://api.liveauth.app',
onInvoice(invoice) {
// Render invoice.bolt11 as a QR code for a paid Lightning test.
console.log(invoice.bolt11);
},
});
const session = await liveauth.start();
const token = await liveauth.confirm(session);
console.log(token.jwt);Der Client speichert bestätigte JWTs, erneuert sie vor Ablauf, wenn ein Refresh-Token zurückgegeben wird, und stellt das aktuelle Token über liveauth.token bereit. Rufen Sie liveauth.destroy() auf, wenn Ihre Anwendung heruntergefahren wird, um Token-Zustand und Erneuerungs-Timer zu löschen.
Um eine echte bezahlte Rechnung zu verlangen:
const session = await liveauth.start({ forceLightning: true });
console.log(session.invoice?.bolt11);
// Poll this after the invoice is paid.
const token = await liveauth.confirmLightning(session);Server-Gate-Helfer
import { createMcpGate } from '@liveauth-labs/mcp-server';
const gate = createMcpGate({
publicKey: 'la_pk_xxx',
baseUrl: 'https://api.liveauth.app',
});
const result = await gate.invoke(
jwtFromYourTransport,
{ message: 'hello' },
async (input, context) => ({
content: [{ type: 'text', text: input.message }],
charge: context.liveAuth.charge,
}),
{}
);gate.invoke(...) validiert das JWT, belastet die konfigurierten Sats-Kosten oder den Backend-Projektstandard und übergibt context.liveAuth an Ihren Handler. Der ältere Name gate.gateTool(...) wird weiterhin unterstützt.
Bezahlte Tool-Zuordnung
Wenn Ihr MCP-Server eine registrierte LiveAuth-Tool-ID hat, übergeben Sie toolId beim Erstellen des Gates. Belastungen gehen dann an:
POST /api/mcp/tools/{toolId}/chargeanstatt an den alten generischen Endpunkt:
POST /api/mcp/chargeSie können auch einen registrierten Tool-Slug/-Namen als toolName übergeben. In diesem Modus gehen Belastungen an den generischen Endpunkt mit Tool-Identität im Body:
POST /api/mcp/chargeTool-Belastungen behalten dieselben Sitzungsbudgetprüfungen bei, zeichnen aber auch ein unveränderliches Umsatzereignis mit Brutto-Sats, LiveAuth-Plattformgebühr, Entwickler-Netto-Sats, Tool-Methodennamen, zahlendem Projekt/Sitzung/Token, Metadaten und Idempotenzschlüssel auf. Wenn costSats weggelassen wird, verwendet LiveAuthCore den registrierten Standardpreis des Tools; ohne toolId oder toolName fällt es auf den globalen MCP-Preis des Projekts zurück.
Registrierte Tools können auch eine Webhook-URL für bezahlte Aufrufe haben. Bei jedem erfolgreichen neuen bezahlten Aufruf stellt LiveAuthCore einen liveauth.mcp.tool.paid_call-Webhook mit Tool-Identität, Brutto-/Plattform-/Netto-Sats, Umsatzereignis-ID, Metadaten und der signierten Quittung in die Warteschlange. Wenn die Tool-Webhook-URL leer ist, fällt LiveAuthCore auf die Webhook-URL des Projekts zurück; idempotente Wiederholungen erzeugen keine Duplikate.
import { createMcpGate } from '@liveauth-labs/mcp-server';
const gate = createMcpGate({
publicKey: process.env.LIVEAUTH_PUBLIC_KEY!,
baseUrl: process.env.LIVEAUTH_API_URL ?? 'https://api.liveauth.app',
toolName: 'paid-research-tool',
});
const result = await gate.invoke(
jwtFromYourTransport,
{ url: 'https://example.com' },
async (input, context) => {
const page = await fetch(input.url).then(r => r.text());
return {
text: page,
revenueEventId: context.liveAuth.charge.revenueEventId,
receipt: context.liveAuth.charge.receipt,
netSats: context.liveAuth.charge.netSats,
};
},
{ requestId: 'req_123' },
{
toolMethodName: 'web_fetch',
idempotencyKey: 'req_123',
agentId: 'agent_abc',
metadata: {
urlHost: new URL('https://example.com').hostname,
},
}
);Wenn toolId oder toolName gesetzt ist, unterstützt GateToolOptions:
Option | Zweck |
| Optionale Sats, die für diesen Aufruf belastet werden. Weglassen, um die registrierte Tool-Preisgestaltung oder den globalen Projektpreis zu verwenden. |
| Optionaler Tool-Slug/-Name pro Aufruf als Überschreibung bei Verwendung des generischen Endpunkts. |
| Methode innerhalb des Tools, z. B. |
| Wiederholungssicherer Schlüssel. Die Wiederverwendung für dasselbe Tool gibt das ursprüngliche Umsatzereignis und die signierte Quittung zurück, anstatt doppelt zu belasten. |
| Optionale Kennung des Aufrufers/Agenten für die Berichterstattung. |
| Kleines JSON-Objekt für Prüfkontext. Speichern Sie hier keine privaten Tool-Ausgaben. |
Tool-Belastungsantworten enthalten die normalen Budgetzähler plus Umsatzbuchhaltung:
{
"status": "ok",
"callsUsed": 3,
"satsUsed": 15,
"grossSats": 5,
"platformFeeSats": 1,
"netSats": 4,
"feeBasisPoints": 500,
"revenueEventId": "event-guid",
"toolId": "tool-guid",
"toolName": "Paid Research Tool",
"toolSlug": "paid-research-tool",
"receipt": {
"version": "mcp-call-receipt-v1",
"payload": "base64url-canonical-json",
"signature": "base64url-hmac-sha256",
"signatureAlgorithm": "HMAC-SHA256",
"keyId": "liveauth-mcp-receipt-v1",
"body": {
"receiptId": "mcp_receipt_eventguid",
"revenueEventId": "event-guid",
"mcpToolId": "tool-guid",
"toolName": "Paid Research Tool",
"toolSlug": "paid-research-tool",
"toolMethodName": "web_fetch",
"grossSats": 5,
"platformFeeSats": 1,
"netSats": 4,
"idempotencyKey": "req_123"
}
}
}Die Quittung ist ein signiertes Prüfartefakt pro Aufruf, das von LiveAuthCore für bezahlte Tool-Belastungen zurückgegeben wird. Speichern Sie sie zusammen mit Ihrem Tool-Ergebnis, wenn Sie einen Nachweis der Belastung oder eine spätere Abstimmung benötigen.
Wenn keine toolId oder toolName konfiguriert ist, verwendet das SDK weiterhin /api/mcp/charge für abwärtskompatible Nutzungsmessung.
Konfiguration
Claude Desktop
Fügen Sie zu Ihrer claude_desktop_config.json hinzu:
{
"mcpServers": {
"liveauth": {
"command": "npx",
"args": ["-y", "@liveauth-labs/mcp-server"],
"env": {
"LIVEAUTH_API_BASE": "https://api.liveauth.app",
"LIVEAUTH_API_KEY": "la_pk_your_public_key"
}
}
}
}Modus ohne Anmeldedaten: Wenn Sie LIVEAUTH_API_KEY weglassen, ruft der Server die normalen MCP-Endpunkte ohne Projekt-Header auf. LiveAuth bindet sein konfiguriertes anonymes Demo-Projekt, gibt eine signierte PoW-Herausforderung zurück und bewahrt normale Verifizierungs-, JWT-, Rate-Limit- und Messungsgrenzen. LIVEAUTH_DEMO=true bleibt eine explizite Opt-in für die ältere lokal simulierte Lightning-Vorschau.
Andere Umgebungsvariablen:
Variable | Standard | Zweck |
| (nicht gesetzt) | Ihr LiveAuth-Projekt-öffentlicher Schlüssel ( |
|
| Überschreibung für selbst gehostetes LiveAuth. |
|
| Explizit die alte lokal simulierte Lightning-Demo verwenden. |
Andere MCP-Clients
Der Server spricht stdio (JSON-RPC 2.0). Starten Sie ihn mit:
liveauth-mcpEs funktioniert auch mit jedem MCP-kompatiblen Client: Cursor, VS Code, ChatGPT, Windsurf, Continue, Cline.
Tool-Referenz
Vollständige Schemas für jedes MCP-Tool. Jedes Tool ist JSON-RPC-2.0-kompatibel und unter src/index.test.ts und src/cli.test.ts getestet.
liveauth_mcp_start
Startet eine neue LiveAuth-MCP-Sitzung. Gibt standardmäßig eine PoW-Challenge zurück, oder eine Lightning-Rechnung, wenn forceLightning=true ist.
Parameter:
forceLightning(boolean, optional): Wenn true, Lightning-Rechnung statt PoW-Challenge anfordernforceL402(boolean, optional): Wenn true, eine Sitzung starten, die mit einem L402-Bundle-Macaroon bestätigt werden soll
Rückgabe (PoW):
{
"quoteId": "uuid-of-session",
"powChallenge": {
"projectId": "guid",
"projectPublicKey": "la_pk_...",
"challengeHex": "a1b2c3...",
"targetHex": "0000ffff...",
"difficultyBits": 18,
"expiresAtUnix": 1234567890,
"signature": "sig..."
},
"invoice": null
}Rückgabe (Lightning):
{
"quoteId": "uuid-of-session",
"powChallenge": null,
"invoice": {
"bolt11": "lnbc...",
"amountSats": 50,
"expiresAtUnix": 1234567890,
"paymentHash": "abc123..."
},
"lightning": {
"invoice": "lnbc...",
"lightningUri": "lightning:lnbc...",
"amountSats": 50,
"expiresAt": "2009-02-13T23:31:30.000Z",
"expiresAtUnix": 1234567890,
"status": "pending"
}
}Rückgabe (L402-Bundle):
{
"quoteId": "uuid-of-session",
"powChallenge": null,
"invoice": null,
"authHint": "l402_bundle"
}liveauth_mcp_confirm
Eine gelöste Proof-of-Work-Challenge einreichen, das Paket seine gecachte Challenge lösen lassen, eine Lightning-Zahlung abfragen oder ein L402-Macaroon präsentieren, um ein JWT-Authentifizierungstoken zu erhalten.
Parameter:
quoteId(string): Die quoteId aus der Start-AntwortchallengeHex(string, optional, nur PoW): Die Challenge-Hex aus der Start-Antwortnonce(number, optional, nur PoW): Die Nonce, die die PoW-Challenge lösthashHex(string, optional, nur PoW): Der resultierende Hash (sha256 vonprojectPublicKey:challengeHex:nonce)expiresAtUnix(number, optional, nur PoW): Ablaufzeitstempel aus der ChallengedifficultyBits(number, optional, nur PoW): Schwierigkeitsbits aus der Challengesignature(string, optional, nur PoW): Signatur aus der Challengemacaroon(string, nur L402): Bundle-Macaroon, das aus dem L402-Bundle-Claim-Ablauf zurückgegeben wurde
Wenn die Challenge von diesem MCP-Server stammt, verwendet der Aufruf von confirm mit quoteId allein den vorhandenen PoW-Solver des Pakets. Explizite Lösungsfelder bleiben aus Kompatibilitätsgründen unterstützt.
Rückgabe:
{
"jwt": "eyJhbGc...",
"expiresIn": 600,
"remainingBudgetSats": 10000,
"refreshToken": "abc123def456..."
}Hinweis: Bewahren Sie das refreshToken sicher auf. Es wird in den MCP-Tool-Daten zurückgegeben, aber niemals in stderr oder Anwendungsprotokolle geschrieben. Verwenden Sie liveauth_mcp_refresh, um ein neues JWT ohne erneute Authentifizierung zu erhalten.
liveauth_mcp_charge
API-Nutzung nach einem authentifizierten Aufruf messen. Der gebündelte MCP-Server ruft den generischen Endpunkt /api/mcp/charge auf. Durch die Angabe von toolName kann LiveAuth ein registriertes Tool auflösen, dessen konfigurierten Preis anwenden und ein Umsatzereignis für bezahlte Tools erstellen; das Weglassen von toolName behält die abwärtskompatible generische Messung bei.
Parameter:
callCostSats(number, optional): Kosten des API-Aufrufs in Sats. Weglassen, um die Backend-Preisgestaltung zu verwenden.toolName(string, optional): Registrierter MCP-Tool-Slug/-Name für die Preisgestaltung und Zuordnung pro Tool.
Rückgabe:
{
"status": "ok",
"callsUsed": 5,
"satsUsed": 15
}Wenn das Budget überschritten wird:
{
"status": "deny",
"callsUsed": 100,
"satsUsed": 1000,
"reason": "budget_exceeded"
}liveauth_mcp_status
Status einer MCP-Sitzung prüfen. Verwenden Sie dies, um auf die Bestätigung der Lightning-Zahlung zu warten.
Parameter:
quoteId(string): Die quoteId aus der Start-Antwort
Rückgabe:
{
"quoteId": "uuid-of-session",
"status": "pending",
"paymentStatus": "pending",
"expiresAt": "2026-02-17T12:00:00Z"
}Wenn paymentStatus "paid" ist, ist die Sitzung bestätigt. Rufen Sie liveauth_mcp_confirm erneut auf, um das JWT zu erhalten.
liveauth_mcp_lnurl
Die Lightning-Rechnung für eine Sitzung abrufen (lnget-kompatibel). Verwenden Sie dies, um die BOLT11-Rechnung für die Zahlung mit einer beliebigen Lightning-Wallet abzurufen.
Parameter:
quoteId(string): Die quoteId aus der Start-Antwort
Rückgabe:
{
"pr": "lnbc2100n1...",
"routes": []
}Hinweis: Dies ist kompatibel mit lnget und anderen Lightning-Zahlungstools. Verwenden Sie dies, um auf die Rechnung zu warten, wenn liveauth_mcp_confirm "payment pending" zurückgibt.
liveauth_mcp_usage
Aktuelle Nutzung und verbleibendes Budget abfragen, ohne eine Belastung vorzunehmen. Verwenden Sie dies, um den Status vor API-Aufrufen zu prüfen.
Parameter: (keine erforderlich)
Rückgabe:
{
"status": "active",
"callsUsed": 5,
"satsUsed": 15,
"maxSatsPerDay": 10000,
"remainingBudgetSats": 9985,
"maxCallsPerMinute": 60,
"expiresAt": "2026-02-17T12:00:00Z",
"dayWindowStart": "2026-02-17T00:00:00Z"
}liveauth_mcp_refresh
Das JWT-Token ohne erneute Authentifizierung aktualisieren. Verwenden Sie das refreshToken aus der confirm-Antwort, um ein neues JWT zu erhalten, wenn das aktuelle abläuft.
Parameter:
refreshToken(string): Das refreshToken aus der confirm-Antwort
Rückgabe:
{
"jwt": "eyJhbGc...",
"expiresIn": 600,
"remainingBudgetSats": 9985
}Hinweis: Speichern Sie das refreshToken sicher. Sie benötigen es, um die Sitzung zu verlängern, ohne eine neue PoW zu lösen oder eine weitere Lightning-Zahlung vorzunehmen.
Verwendungsbeispiel
PoW-Authentifizierung
Rufen Sie
liveauth_mcp_startauf, um eine PoW-Challenge und quoteId zu erhaltenRufen Sie
liveauth_mcp_confirmmit der quoteId auf; der MCP-Server löst seine gecachte Challenge mit dem vorhandenen Paket-SolverFortgeschrittene Clients können weiterhin eine explizite Lösung einreichen (
hash = sha256(projectPublicKey:challengeHex:nonce)wobeihash < targetHex)Verwenden Sie das JWT im
Authorization: Bearer <token>-Header für API-AnfragenRufen Sie nach jedem generischen API-Aufruf
liveauth_mcp_chargemit einem Aufrufpreis auf, oder lassen Sie es weg, um den globalen MCP-Preis des Projekts zu verwendenFür monetarisierte MCP-Tools umschließen Sie Handler mit
createMcpGate({ toolId })odercreateMcpGate({ toolName }), sodass jeder Aufruf ein Umsatzereignis und eine signierte Quittung erstellt
Lightning-Authentifizierung
Rufen Sie
liveauth_mcp_startmitforceLightning: trueauf, um eine Lightning-Rechnung zu erhaltenVerwenden Sie
liveauth_mcp_lnurl(oder fragen Sieliveauth_mcp_statusab), um die BOLT11-Rechnung zu erhaltenBezahlen Sie die Rechnung mit Ihrem Lightning-Knoten/-Wallet
Fragen Sie
liveauth_mcp_statusmit der quoteId ab, bis paymentStatus "paid" istRufen Sie
liveauth_mcp_confirmnur mit der quoteId auf, um das JWT zu erhaltenVerwenden Sie das JWT entweder mit generischer
liveauth_mcp_charge-Messung oder mit der SDK-Zuordnung für bezahlte Tools
Authentifizierungsablauf
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ AI Agent │────▶│ MCP Server │────▶│ LiveAuth API │
│ │ │ │ │ │
│ 1. Start │ │ /api/mcp/start │ │ Returns PoW │
│ 2. Solve PoW │ │ │ │ challenge │
│ 3. Confirm │ │ /api/mcp/confirm│ │ Returns JWT │
│ 4. API calls │ │ │ │ │
│ 5. Charge │ │ /api/mcp/charge │ │ Meter usage │
└─────────────────┘ └─────────────────┘ └─────────────────┘Server für bezahlte Tools verwenden dasselbe JWT, belasten aber über einen zugeordneten Endpunkt:
Agent calls MCP tool
→ Tool server calls POST /api/mcp/tools/{toolId}/charge
or POST /api/mcp/charge with toolName
→ LiveAuth validates JWT and budget
→ LiveAuth records gross / platform fee / net revenue and returns a signed receipt
→ Tool handler runs and returns the resultL402-Bundle-Ablauf
LiveAuthCore unterstützt Lightning-gestützte L402-Bundles für den Prepaid-MCP-Zugriff. Kaufen Sie ein Bundle, beanspruchen Sie das Macaroon nach der Zahlung, starten Sie dann eine MCP-Sitzung im L402-Modus und bestätigen Sie sie mit diesem Macaroon.
# 1. Create a bundle invoice.
curl -X POST https://api.liveauth.app/api/public/l402/bundle/invoice \
-H "Content-Type: application/json" \
-d '{"publicKey":"la_pk_xxx","tier":"starter","agentId":"agent_abc"}'
# 2. After the invoice is paid, claim a macaroon.
curl -X POST https://api.liveauth.app/api/public/l402/bundle/claim \
-H "Content-Type: application/json" \
-d '{"publicKey":"la_pk_xxx","paymentHash":"payment_hash_from_step_1"}'
# 3. Start and confirm an MCP session with the macaroon.
curl -X POST https://api.liveauth.app/api/mcp/start \
-H "X-LW-Public: la_pk_xxx" \
-H "Content-Type: application/json" \
-d '{"forceL402":true}'
curl -X POST https://api.liveauth.app/api/mcp/confirm \
-H "X-LW-Public: la_pk_xxx" \
-H "Content-Type: application/json" \
-d '{"quoteId":"quote_id_from_step_3","macaroon":"macaroon_from_step_2"}'Entwicklung
# Install dependencies
npm install
# Build
npm run build
# Run locally
node dist/cli.jsRessourcen
Lizenz
MIT
Kategorien: authentication · payments · lightning · l402 · bitcoin · pay-per-call · metering · agent-tools · anti-abuse · mcp-server · typescript
Available Tools
7 toolsliveauth_mcp_chargeA
Meter API usage after making an authenticated call. Call this with the cost in sats for each API request made using the JWT.
Inputs: toolName, callCostSats.
liveauth_mcp_confirmA
Submit the solved proof-of-work challenge (or poll for Lightning payment) to receive a JWT. For Lightning, call with just quoteId to check/poll payment status.
Inputs: quoteId (required), nonce, hashHex, macaroon, +4 more.
liveauth_mcp_lnurlB
Get the Lightning invoice for a session (lnget-compatible). Use this to retrieve the BOLT11 invoice for payment.
Inputs: quoteId (required).
liveauth_mcp_refreshA
Refresh the JWT token without re-authenticating. Use the refreshToken returned from confirm to get a new JWT.
Inputs: refreshToken (required).
liveauth_mcp_startA
Start a new LiveAuth MCP session. Returns a PoW challenge (default), Lightning invoice, or L402 bundle auth hint.
Inputs: forceL402, forceLightning.
liveauth_mcp_statusA
Check the status of an MCP session. Use to poll for Lightning payment confirmation. Also returns the invoice via lnurl compatibility.
Inputs: quoteId (required).
liveauth_mcp_usageA
Query current usage and remaining budget for the MCP session. Use this to check how many sats and calls have been used without making a charge.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool maps to a distinct auth lifecycle step: start initiates, lnurl fetches invoice, confirm resolves auth, refresh renews token, charge/usage handle metering, and status reports state. Slight overlap exists between status and confirm when polling payment, but descriptions clarify their primary roles.
All tools share the consistent liveauth_mcp_ prefix and snake_case format. Most use verbs (start, confirm, refresh, charge), but status, usage, and lnurl are noun-based, creating minor deviations from a strict verb pattern.
With 7 tools, the set is well-scoped for the server's purpose. Each tool covers a specific function without redundancy, fitting comfortably in the ideal 3-15 tool range.
The toolset provides full lifecycle coverage: starting a session, retrieving invoices, confirming authentication, refreshing tokens, and tracking/metering usage. No significant operational gaps are apparent for the stated authentication and payment domain.
Related MCP Connectors
Pay-per-action access to APIs and MCP tools over Lightning L402 and Base USDC x402.
Give AI agents a Bitcoin wallet with Lightning Network payments and L402 support.
Pay-per-call APIs and MCP services for agents, no accounts or keys, with verifiable receipts.
External counterparty-risk checks and signed receipts for autonomous agents and machine payments.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server that enables AI agents to make autonomous Bitcoin Lightning Network payments using the L402 protocol. Agents can pay for API access, purchase resources, and complete transactions without human intervention — invoice comes in, sats go out, done.179MIT
- AlicenseAqualityBmaintenanceCryptographic accountability for AI agents. Ed25519-signed receipts for every MCP tool call. Constraints, chains, AI judgment, invoicing, and local dashboard included.241MIT
- AlicenseAqualityBmaintenanceL402 + x402 client MCP. AI agents discover, pay for, and consume any payment-gated API autonomously. Supports Lightning (NWC), Cashu ecash, stablecoins, and human-in-the-loop payments.14789 npmMIT
- AlicenseAqualityDmaintenanceMCP server that gates API calls to AI agents using proof-of-work (free) or Lightning payment (3 sats), providing challenge, verify, and status tools for per-call authentication without accounts.349 npm1MIT