LiveAuth MCP Server
Servidor MCP de LiveAuth
Autenticación, medición de pago por llamada y recibos firmados para agentes de IA y herramientas MCP: nativo de Bitcoin, respaldado por Lightning y compatible con L402.
Este servidor MCP permite que cualquier agente de IA se autentique contra tu API mediante prueba de trabajo (gratis, sin cuenta) o micropagos de Lightning Network (sats), y luego mida y monetice las llamadas posteriores a herramientas con precios por llamada, eventos de ingresos idempotentes y recibos firmados con HMAC que los auditores pueden verificar sin conexión.
Úsalo cuando quieras:
Proteger una API o herramienta MCP detrás de un costo real de cómputo o sats reales (anti-spam por diseño, no por CAPTCHA).
Cobrar a los agentes de IA por llamada sin necesidad de que creen una cuenta.
Emitir un rastro de auditoría a prueba de manipulaciones (recibo firmado
mcp-call-receipt-v1) por cada invocación de herramienta de pago.Ofrecer acceso a paquetes L402 respaldados por Lightning para sesiones MCP prepagadas.
Pruébalo en 5 segundos: sin cuenta, sin clave de API:
npx @liveauth-labs/mcp-serverSin configuración, el servidor utiliza el proyecto de demostración anónimo de LiveAuth y el flujo real de PoW. Añade LIVEAUTH_API_KEY solo cuando necesites la política, los precios o la atribución de un proyecto específico.
Herramientas disponibles (detección automática de Glama / MCP)
Herramienta | Propósito |
| Iniciar una sesión. Devuelve un desafío PoW, una factura Lightning o una pista de paquete L402. |
| Enviar un desafío PoW resuelto, una factura Lightning pagada o un macarrón L402 → recibir un JWT. |
| Medir el uso después de una llamada. Con |
| Intercambiar un token de actualización por un nuevo JWT: sin necesidad de reautenticación. |
| Consultar el estado de la sesión/pago (confirmación de Lightning, caducidad). |
| Obtener la factura BOLT11 de una sesión (compatible con lnget). |
| Consultar el presupuesto restante, las llamadas utilizadas y las ventanas de límite de velocidad. |
Los esquemas completos de parámetros y respuestas están en la Referencia de herramientas a continuación.
Related MCP server: Agent Receipts
Inicio rápido en 5 minutos
Opción 1 — PoW sin credenciales (sin cuenta, sin clave, sin cartera)
npx @liveauth-labs/mcp-serverEn un cliente MCP, llama a liveauth_mcp_start y luego a liveauth_mcp_confirm solo con el quoteId devuelto. El paquete reutiliza su solucionador de PoW existente localmente y la API de LiveAuth verifica el desafío firmado antes de emitir un JWT de sesión de corta duración.
Opción 2 — Modo de producción
Obtén una clave de API en liveauth.app.
Añádela al
claude_desktop_config.jsonde Claude Desktop:
{
"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"
}
}
}
}Reinicia Claude. Listo.
Opción 3 — Programático (CLI / SDK)
export LIVEAUTH_API_KEY=la_pk_xxx
npx @liveauth-labs/mcp-serverEl paquete también es un SDK de TypeScript: consulta Uso del SDK a continuación. El binario CLI es liveauth-mcp.
¿Por qué LiveAuth?
Para proveedores de API / desarrolladores de herramientas:
Detén bots en la capa de protocolo. PoW y los sats de Lightning no son reproducibles, no son suplantables y no requieren cuentas de usuario.
Cobra por llamada en sats. Firmamos un recibo que puedes mostrar a auditores, clientes o tu contable.
Envuelve cualquier herramienta MCP con una línea (
createMcpGate) y obtienes ingresos por herramienta, precios mín/máx por herramienta y reintentos idempotentes.
Para agentes de IA / creadores de agentes:
Acceso sin permisos a APIs de pago: resuelve un PoW o paga sats, obtén un JWT. Sin registro, sin correo electrónico, sin baile de OAuth.
Usa PoW, facturas Lightning o macarrones de paquete L402 para el acceso de agentes.
Los proyectos pueden liquidar a través de un nodo Lightning personalizado cuando se configura; de lo contrario, los pagos usan el nodo configurado por LiveAuthCore.
Las matemáticas que importan: si tu herramienta está siendo extraída por un bot, cobrar 1 sat por llamada es suficiente para que el raspador no sea rentable. Llamamos a esto economía del costo del ataque, y es la razón de nuestra existencia.
Instalación
npm install -g @liveauth-labs/mcp-serverO úsalo directamente con npx:
npx @liveauth-labs/mcp-serverGoose
LiveAuth para Goose usa el mismo servidor MCP stdio basado en estándares que cualquier otro cliente: no hay envoltorio de Goose, demonio ni tiempo de ejecución de autenticación duplicado.
O imprime el enlace profundo oficial y los respaldos actuales:
npx @liveauth-labs/mcp-server setup goosePara una sesión CLI de Goose única:
goose session --with-extension "liveauth:npx -y @liveauth-labs/mcp-server"Configuración manual de stdio de Goose, cuando el enlace profundo no esté disponible:
extensions:
liveauth:
type: stdio
name: LiveAuth
enabled: true
cmd: npx
args: ["-y", "@liveauth-labs/mcp-server"]
env_keys: []
envs: {}
timeout: 300No edites una configuración existente de Goose de forma destructiva. Prefiere el enlace profundo o goose configure; si añades configuración de proyecto más adelante, introdúcela a través de la configuración de secretos de la extensión de Goose en lugar de YAML de texto plano compartido.
Prueba rápida de Goose
Pregunta a Goose:
Usa LiveAuth para iniciar el flujo de autenticación predeterminado. Confirma la cotización devuelta y luego muestra mi uso de LiveAuth.
El flujo inicial usa el desafío PoW del proyecto de demostración anónimo y no requiere cartera. Una clave pública de proyecto es opcional:
Variable | Cuándo configurarla |
| Política, precios y atribución específicos del proyecto. |
| Una API de LiveAuth autoalojada en lugar de |
| Optar explícitamente por la demostración Lightning simulada localmente más antigua. |
Cuando se solicita un flujo de pago, los resultados de la herramienta conservan los campos de factura existentes y también incluyen datos estructurados portátiles:
{
"lightning": {
"invoice": "lnbc...",
"lightningUri": "lightning:lnbc...",
"amountSats": 21,
"expiresAt": "2030-03-17T17:46:40.000Z",
"status": "pending"
}
}Los clientes con soporte de MCP Apps pueden renderizar el QR incluido, la acción de abrir cartera, la caducidad y el estado en vivo pagado/pendiente/caducado. Otros clientes reciben el JSON y el contenido de la imagen QR como resultados MCP ordinarios.
Solución de problemas de Goose
Si el enlace no se abre, ejecuta
npx @liveauth-labs/mcp-server setup goosey usa su respaldo de una sesión o manual.Si
npxno está disponible, instala una versión actual de Node.js (Node 18 o posterior).Si una clave de proyecto proporcionada es rechazada, elimínala para verificar el flujo PoW anónimo; las claves inválidas y revocadas intencionalmente no recurren a la demostración.
Si una factura Lightning caduca, llama a
liveauth_mcp_startde nuevo para obtener una cotización nueva.Mantén los tokens de actualización y cualquier credencial no pública fuera de los registros y de la configuración en texto plano.
LiveAuth permite que los agentes adquieran autorización en tiempo de ejecución en lugar de requerir que cada herramienta se aprovisione con credenciales permanentes de antemano.
Uso del SDK
El paquete también se puede importar como SDK de TypeScript/JavaScript. Importar el paquete no inicia el servidor MCP stdio; el CLI se encuentra en el binario liveauth-mcp.
Helper de autenticación de cliente
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);El cliente almacena los JWT confirmados, los actualiza antes de la caducidad cuando se devuelve un token de actualización y expone el token actual a través de liveauth.token. Llama a liveauth.destroy() cuando tu aplicación se esté cerrando para limpiar el estado del token y los temporizadores de actualización.
Para requerir una factura de pago real:
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);Helper de puerta de servidor
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(...) valida el JWT, cobra el costo configurado en sats o el predeterminado del proyecto backend, y pasa context.liveAuth a tu manejador. El nombre más antiguo gate.gateTool(...) todavía es compatible.
Atribución de herramientas de pago
Si tu servidor MCP tiene un ID de herramienta LiveAuth registrado, pasa toolId al crear la puerta. Los cargos entonces van a:
POST /api/mcp/tools/{toolId}/chargeen lugar del endpoint genérico heredado:
POST /api/mcp/chargeTambién puedes pasar un slug/nombre de herramienta registrado como toolName. En ese modo, los cargos van al endpoint genérico con la identidad de la herramienta en el cuerpo:
POST /api/mcp/chargeLos cargos de herramientas conservan las mismas comprobaciones de presupuesto de sesión, pero también registran un evento de ingresos inmutable con sats brutos, tarifa de plataforma de LiveAuth, sats netos para el desarrollador, nombre del método de la herramienta, proyecto/sesión/token de pago, metadatos y clave de idempotencia. Cuando se omite costSats, LiveAuthCore usa el precio predeterminado de la herramienta registrada; sin toolId o toolName, recurre al precio MCP global del proyecto.
Las herramientas registradas también pueden tener una URL de webhook de llamada de pago. En cada nueva llamada de pago exitosa, LiveAuthCore pone en cola un webhook liveauth.mcp.tool.paid_call con la identidad de la herramienta, sats brutos/plataforma/netos, ID del evento de ingresos, metadatos y el recibo firmado. Si la URL del webhook de la herramienta está en blanco, LiveAuthCore recurre a la URL del webhook del proyecto; los reintentos idempotentes no ponen en cola duplicados.
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,
},
}
);Cuando se establece toolId o toolName, GateToolOptions admite:
Opción | Propósito |
| Sats opcionales a cobrar por esta llamada. Omítelo para usar el precio de la herramienta registrada o el precio global del proyecto. |
| Sobrescritura opcional del slug/nombre de la herramienta por llamada al usar el endpoint genérico. |
| Método dentro de la herramienta, como |
| Clave segura para reintentos. Reutilizarla para la misma herramienta devuelve el evento de ingresos original y el recibo firmado en lugar de cobrar dos veces. |
| Identificador opcional de llamante/agente para informes. |
| Objeto JSON pequeño para contexto de auditoría. No almacenes salida privada de la herramienta aquí. |
Las respuestas de cargos de herramientas incluyen los contadores de presupuesto normales más la contabilidad de ingresos:
{
"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"
}
}
}El recibo es un artefacto de auditoría firmado por llamada devuelto por LiveAuthCore para cargos de herramientas de pago. Guárdalo con el resultado de tu herramienta cuando necesites prueba de cargo o conciliación posterior.
Si no se configura toolId ni toolName, el SDK sigue usando /api/mcp/charge para la medición de uso compatible con versiones anteriores.
Configuración
Claude Desktop
Añade a tu claude_desktop_config.json:
{
"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"
}
}
}
}Modo sin credenciales: si omites LIVEAUTH_API_KEY, el servidor llama a los endpoints MCP normales sin un encabezado de proyecto. LiveAuth vincula su proyecto de demostración anónimo configurado, devuelve un desafío PoW firmado y preserva los límites normales de verificación, JWT, límite de velocidad y medición. LIVEAUTH_DEMO=true sigue siendo una opción explícita para la vista previa Lightning simulada localmente más antigua.
Otras variables de entorno:
Variable | Predeterminado | Propósito |
| (sin establecer) | Tu clave pública de proyecto LiveAuth ( |
|
| Sobrescritura para LiveAuth autoalojado. |
|
| Usar explícitamente la demostración Lightning simulada localmente heredada. |
Otros clientes MCP
El servidor habla stdio (JSON-RPC 2.0). Inícialo con:
liveauth-mcpTambién funciona con cualquier cliente compatible con MCP: Cursor, VS Code, ChatGPT, Windsurf, Continue, Cline.
Referencia de herramientas
Esquemas completos para cada herramienta MCP. Cada herramienta es compatible con JSON-RPC 2.0 y está probada en src/index.test.ts y src/cli.test.ts.
liveauth_mcp_start
Inicia una nueva sesión de LiveAuth MCP. Devuelve un desafío PoW por defecto, o una factura Lightning si forceLightning=true.
Parámetros:
forceLightning(booleano, opcional): Si es true, solicita una factura Lightning en lugar del desafío PoWforceL402(booleano, opcional): Si es true, inicia una sesión que debe confirmarse con un macarrón de paquete L402
Devuelve (PoW):
{
"quoteId": "uuid-of-session",
"powChallenge": {
"projectId": "guid",
"projectPublicKey": "la_pk_...",
"challengeHex": "a1b2c3...",
"targetHex": "0000ffff...",
"difficultyBits": 18,
"expiresAtUnix": 1234567890,
"signature": "sig..."
},
"invoice": null
}Devuelve (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"
}
}Devuelve (paquete L402):
{
"quoteId": "uuid-of-session",
"powChallenge": null,
"invoice": null,
"authHint": "l402_bundle"
}liveauth_mcp_confirm
Envía un desafío de prueba de trabajo resuelto, permite que el paquete resuelva su desafío en caché, consulta un pago Lightning o presenta un macarrón L402 para recibir un token de autenticación JWT.
Parámetros:
quoteId(cadena): El quoteId de la respuesta de iniciochallengeHex(cadena, opcional, solo PoW): El challengeHex de la respuesta de iniciononce(número, opcional, solo PoW): El nonce que resuelve el desafío PoWhashHex(cadena, opcional, solo PoW): El hash resultante (sha256 deprojectPublicKey:challengeHex:nonce)expiresAtUnix(número, opcional, solo PoW): Marca de tiempo de expiración del desafíodifficultyBits(número, opcional, solo PoW): Bits de dificultad del desafíosignature(cadena, opcional, solo PoW): Firma del desafíomacaroon(cadena, solo L402): Macarrón de paquete devuelto por el flujo de reclamación del paquete L402
Cuando el desafío proviene de este servidor MCP, llamar a confirm con quoteId solo reutiliza el solucionador PoW existente del paquete. Los campos de solución explícitos siguen siendo compatibles por compatibilidad.
Devuelve:
{
"jwt": "eyJhbGc...",
"expiresIn": 600,
"remainingBudgetSats": 10000,
"refreshToken": "abc123def456..."
}Nota: Almacena el refreshToken de forma segura. Se devuelve en los datos de la herramienta MCP pero nunca se escribe en stderr ni en los registros de la aplicación. Usa liveauth_mcp_refresh para obtener un nuevo JWT sin volver a autenticarte.
liveauth_mcp_charge
Mide el uso de la API después de realizar una llamada autenticada. El servidor MCP incluido llama al endpoint genérico /api/mcp/charge. Proporcionar toolName permite que LiveAuth resuelva una herramienta registrada, aplique su precio configurado y cree un evento de ingresos de herramienta de pago; omitir toolName mantiene la medición genérica compatible con versiones anteriores.
Parámetros:
callCostSats(número, opcional): Coste de la llamada a la API en sats. Omítelo para usar el precio del backend.toolName(cadena, opcional): Slug/nombre de la herramienta MCP registrada para precios y atribución por herramienta.
Devuelve:
{
"status": "ok",
"callsUsed": 5,
"satsUsed": 15
}Si se supera el presupuesto:
{
"status": "deny",
"callsUsed": 100,
"satsUsed": 1000,
"reason": "budget_exceeded"
}liveauth_mcp_status
Comprueba el estado de una sesión MCP. Úsalo para consultar la confirmación del pago Lightning.
Parámetros:
quoteId(cadena): El quoteId de la respuesta de inicio
Devuelve:
{
"quoteId": "uuid-of-session",
"status": "pending",
"paymentStatus": "pending",
"expiresAt": "2026-02-17T12:00:00Z"
}Cuando paymentStatus es "paid", la sesión está confirmada. Llama a liveauth_mcp_confirm de nuevo para obtener el JWT.
liveauth_mcp_lnurl
Obtiene la factura Lightning de una sesión (compatible con lnget). Úsalo para recuperar la factura BOLT11 para el pago con cualquier monedero Lightning.
Parámetros:
quoteId(cadena): El quoteId de la respuesta de inicio
Devuelve:
{
"pr": "lnbc2100n1...",
"routes": []
}Nota: Esto es compatible con lnget y otras herramientas de pago Lightning. Úsalo para consultar la factura cuando liveauth_mcp_confirm devuelva "payment pending".
liveauth_mcp_usage
Consulta el uso actual y el presupuesto restante sin realizar un cargo. Úsalo para comprobar el estado antes de hacer llamadas a la API.
Parámetros: (ninguno requerido)
Devuelve:
{
"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
Renueva el token JWT sin volver a autenticarte. Usa el refreshToken devuelto por confirm para obtener un nuevo JWT cuando el actual expire.
Parámetros:
refreshToken(cadena): El refreshToken de la respuesta de confirm
Devuelve:
{
"jwt": "eyJhbGc...",
"expiresIn": 600,
"remainingBudgetSats": 9985
}Nota: Guarda el refreshToken de forma segura. Lo necesitarás para extender la sesión sin resolver un nuevo PoW ni realizar otro pago Lightning.
Ejemplo de uso
Autenticación PoW
Llama a
liveauth_mcp_startpara obtener un desafío PoW y un quoteIdLlama a
liveauth_mcp_confirmcon el quoteId; el servidor MCP resuelve su desafío en caché con el solucionador de paquetes existenteLos clientes avanzados pueden enviar una solución explícita (
hash = sha256(projectPublicKey:challengeHex:nonce)dondehash < targetHex)Usa el JWT en el encabezado
Authorization: Bearer <token>para las solicitudes de APIDespués de cada llamada genérica a la API, llama a
liveauth_mcp_chargecon un coste de llamada, u omítelo para usar el precio MCP global del proyectoPara herramientas MCP monetizadas, envuelve los manejadores con
createMcpGate({ toolId })ocreateMcpGate({ toolName })para que cada llamada cree un evento de ingresos y un recibo firmado
Autenticación Lightning
Llama a
liveauth_mcp_startconforceLightning: truepara obtener una factura LightningUsa
liveauth_mcp_lnurl(o consultaliveauth_mcp_status) para obtener la factura BOLT11Paga la factura usando tu nodo/monedero Lightning
Consulta
liveauth_mcp_statuscon el quoteId hasta que paymentStatus sea "paid"Llama a
liveauth_mcp_confirmsolo con el quoteId para recibir el JWTUsa el JWT con la medición genérica de
liveauth_mcp_chargeo con la atribución de herramientas de pago del SDK
Flujo de autenticación
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 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 │
└─────────────────┘ └─────────────────┘ └─────────────────┘Los servidores de herramientas de pago usan el mismo JWT pero cobran a través de un endpoint atribuido:
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 resultFlujo de paquete L402
LiveAuthCore admite paquetes L402 respaldados por Lightning para acceso MCP prepagado. Compra un paquete, reclama el macarrón después del pago, luego inicia una sesión MCP en modo L402 y confírmala con ese macarrón.
# 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"}'Desarrollo
# Install dependencies
npm install
# Build
npm run build
# Run locally
node dist/cli.jsRecursos
Licencia
MIT
Categorías: 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