Skip to main content
Glama

LiveAuth MCP Server

npm version MIT license L402 MCP

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-server

Ohne 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

liveauth_mcp_start

Eine Sitzung beginnen. Gibt eine PoW-Herausforderung, eine Lightning-Rechnung oder einen L402-Bundle-Hinweis zurück.

liveauth_mcp_confirm

Eine gelöste PoW-Herausforderung, eine bezahlte Lightning-Rechnung oder ein L402-Macaroon einreichen → ein JWT erhalten.

liveauth_mcp_charge

Nutzung nach einem Aufruf messen. Mit toolName wird die registrierte Tool-Preisgestaltung aufgelöst und ein bezahltes Umsatzereignis aufgezeichnet.

liveauth_mcp_refresh

Ein Refresh-Token gegen ein neues JWT austauschen – keine erneute Authentifizierung erforderlich.

liveauth_mcp_status

Sitzungs-/Zahlungsstatus abfragen (Lightning-Bestätigung, Ablauf).

liveauth_mcp_lnurl

Die BOLT11-Rechnung für eine Sitzung abrufen (lnget-kompatibel).

liveauth_mcp_usage

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-server

Rufen 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

  1. Holen Sie sich einen API-Schlüssel unter liveauth.app.

  2. Fügen Sie ihn zur claude_desktop_config.json von 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"
      }
    }
  }
}
  1. Starten Sie Claude neu. Fertig.

Option 3 – Programmatisch (CLI / SDK)

export LIVEAUTH_API_KEY=la_pk_xxx
npx @liveauth-labs/mcp-server

Das 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-server

Oder direkt mit npx verwenden:

npx @liveauth-labs/mcp-server

Goose

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.

In Goose installieren

Oder den offiziellen Deep-Link und aktuelle Fallbacks ausgeben:

npx @liveauth-labs/mcp-server setup goose

Fü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: 300

Bearbeiten 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?

LIVEAUTH_API_KEY

Projektspezifische Richtlinie, Preisgestaltung und Zuordnung.

LIVEAUTH_API_BASE

Eine selbst gehostete LiveAuth-API anstelle von https://api.liveauth.app.

LIVEAUTH_DEMO=true

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 goose aus und verwenden Sie dessen Ein-Sitzungs- oder manuellen Fallback.

  • Wenn npx nicht 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_start erneut 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}/charge

anstatt an den alten generischen Endpunkt:

POST /api/mcp/charge

Sie 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/charge

Tool-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

costSats

Optionale Sats, die für diesen Aufruf belastet werden. Weglassen, um die registrierte Tool-Preisgestaltung oder den globalen Projektpreis zu verwenden.

toolName

Optionaler Tool-Slug/-Name pro Aufruf als Überschreibung bei Verwendung des generischen Endpunkts.

toolMethodName

Methode innerhalb des Tools, z. B. web_fetch oder search.

idempotencyKey

Wiederholungssicherer Schlüssel. Die Wiederverwendung für dasselbe Tool gibt das ursprüngliche Umsatzereignis und die signierte Quittung zurück, anstatt doppelt zu belasten.

agentId

Optionale Kennung des Aufrufers/Agenten für die Berichterstattung.

metadata

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

LIVEAUTH_API_KEY

(nicht gesetzt)

Ihr LiveAuth-Projekt-öffentlicher Schlüssel (la_pk_…).

LIVEAUTH_API_BASE

https://api.liveauth.app

Überschreibung für selbst gehostetes LiveAuth.

LIVEAUTH_DEMO

false

Explizit die alte lokal simulierte Lightning-Demo verwenden.

Andere MCP-Clients

Der Server spricht stdio (JSON-RPC 2.0). Starten Sie ihn mit:

liveauth-mcp

Es 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 anfordern

  • forceL402 (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-Antwort

  • challengeHex (string, optional, nur PoW): Die Challenge-Hex aus der Start-Antwort

  • nonce (number, optional, nur PoW): Die Nonce, die die PoW-Challenge löst

  • hashHex (string, optional, nur PoW): Der resultierende Hash (sha256 von projectPublicKey:challengeHex:nonce)

  • expiresAtUnix (number, optional, nur PoW): Ablaufzeitstempel aus der Challenge

  • difficultyBits (number, optional, nur PoW): Schwierigkeitsbits aus der Challenge

  • signature (string, optional, nur PoW): Signatur aus der Challenge

  • macaroon (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

  1. Rufen Sie liveauth_mcp_start auf, um eine PoW-Challenge und quoteId zu erhalten

  2. Rufen Sie liveauth_mcp_confirm mit der quoteId auf; der MCP-Server löst seine gecachte Challenge mit dem vorhandenen Paket-Solver

  3. Fortgeschrittene Clients können weiterhin eine explizite Lösung einreichen (hash = sha256(projectPublicKey:challengeHex:nonce) wobei hash < targetHex)

  4. Verwenden Sie das JWT im Authorization: Bearer <token>-Header für API-Anfragen

  5. Rufen Sie nach jedem generischen API-Aufruf liveauth_mcp_charge mit einem Aufrufpreis auf, oder lassen Sie es weg, um den globalen MCP-Preis des Projekts zu verwenden

  6. Für monetarisierte MCP-Tools umschließen Sie Handler mit createMcpGate({ toolId }) oder createMcpGate({ toolName }), sodass jeder Aufruf ein Umsatzereignis und eine signierte Quittung erstellt

Lightning-Authentifizierung

  1. Rufen Sie liveauth_mcp_start mit forceLightning: true auf, um eine Lightning-Rechnung zu erhalten

  2. Verwenden Sie liveauth_mcp_lnurl (oder fragen Sie liveauth_mcp_status ab), um die BOLT11-Rechnung zu erhalten

  3. Bezahlen Sie die Rechnung mit Ihrem Lightning-Knoten/-Wallet

  4. Fragen Sie liveauth_mcp_status mit der quoteId ab, bis paymentStatus "paid" ist

  5. Rufen Sie liveauth_mcp_confirm nur mit der quoteId auf, um das JWT zu erhalten

  6. Verwenden 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 result

L402-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.js

Ressourcen

Lizenz

MIT


Kategorien: authentication · payments · lightning · l402 · bitcoin · pay-per-call · metering · agent-tools · anti-abuse · mcp-server · typescript

Available Tools

7 tools
liveauth_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

    A3.8/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP 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.
      17
      9
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      L402 + 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.
      14
      789 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      3
      49 npm
      1
      MIT