Skip to main content
Glama

LiveAuth MCP Server

npm version MIT license L402 MCP

Аутентификация, поминутная тарификация и подписанные квитанции для ИИ-агентов и MCP-инструментов: нативно для Bitcoin, на базе Lightning и совместимо с L402.

Этот MCP-сервер позволяет любому ИИ-агенту аутентифицироваться в вашем API с помощью proof-of-work (бесплатно, без аккаунта) или микроплатежей Lightning Network (саты), а затем учитывать и монетизировать последующие вызовы инструментов с оплатой за вызов, идемпотентными событиями дохода и HMAC-подписанными квитанциями, которые аудиторы могут проверять офлайн.

Используйте его, когда хотите:

  • Ограничить доступ к API или MCP-инструменту реальной стоимостью вычислений или реальными сатами (анти-спам по дизайну, а не через CAPTCHA).

  • Взимать плату с ИИ-агентов за каждый вызов без регистрации аккаунта.

  • Выдавать защищённый от подделки аудиторский след (подписанные mcp-call-receipt-v1) для каждого платного вызова инструмента.

  • Предлагать доступ к пакетам L402 на базе Lightning для предоплаченных MCP-сессий.

Попробуйте за 5 секунд — без аккаунта и API-ключа:

npx @liveauth-labs/mcp-server

Без конфигурации сервер использует анонимный демо-проект LiveAuth и реальный поток PoW. Добавляйте LIVEAUTH_API_KEY только когда нужна политика, цены или атрибуция конкретного проекта.


Доступные инструменты (автообнаружение Glama / MCP)

Инструмент

Назначение

liveauth_mcp_start

Начать сессию. Возвращает PoW-задачу, счёт Lightning или подсказку для L402-пакета.

liveauth_mcp_confirm

Отправить решённую PoW-задачу, оплаченный счёт Lightning или L402-макарун → получить JWT.

liveauth_mcp_charge

Учесть использование после вызова. С toolName определяет зарегистрированную цену инструмента и записывает платное событие дохода.

liveauth_mcp_refresh

Обменять refresh-токен на новый JWT — повторная аутентификация не требуется.

liveauth_mcp_status

Проверить статус сессии/платежа (подтверждение Lightning, срок действия).

liveauth_mcp_lnurl

Получить BOLT11-счёт для сессии (совместимо с lnget).

liveauth_mcp_usage

Запросить оставшийся бюджет, использованные вызовы и окна ограничения скорости.

Полные схемы параметров и ответов приведены в Справочнике инструментов ниже.


Related MCP server: Agent Receipts

Быстрый старт за 5 минут

Вариант 1 — PoW без учётных данных (без аккаунта, ключа и кошелька)

npx @liveauth-labs/mcp-server

В MCP-клиенте вызовите liveauth_mcp_start, затем liveauth_mcp_confirm, передав только возвращённый quoteId. Пакет повторно использует свой локальный решатель PoW, а API LiveAuth проверяет подписанную задачу перед выдачей краткосрочного JWT для сессии.

Вариант 2 — Производственный режим

  1. Получите API-ключ на liveauth.app.

  2. Добавьте в claude_desktop_config.json для 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"
      }
    }
  }
}
  1. Перезапустите Claude. Готово.

Вариант 3 — Программный (CLI / SDK)

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

Пакет также является TypeScript SDK — см. Использование SDK ниже. Бинарный файл CLI — liveauth-mcp.

Почему LiveAuth?

Для поставщиков API / разработчиков инструментов:

  • Остановите ботов на уровне протокола. PoW и саты Lightning невоспроизводимы, не поддаются фишингу и не требуют учётных записей пользователей.

  • Взимайте плату за вызов в сатах. Мы подписываем квитанцию, которую вы можете показать аудиторам, клиентам или бухгалтеру.

  • Оберните любой MCP-инструмент одной строкой (createMcpGate) и получите доход по каждому инструменту, минимальную/максимальную цену и идемпотентные повторы.

Для ИИ-агентов / разработчиков агентов:

  • Доступ без разрешений к платным API — решите PoW или оплатите сатами, получите JWT. Без регистрации, email или OAuth-танцев.

  • Используйте PoW, счета Lightning или L402-макаруны для доступа агентов.

  • Проекты могут рассчитываться через собственный Lightning-узел при настройке; в противном случае платежи проходят через узел, настроенный в LiveAuthCore.

Математика, которая имеет значение: если ваш инструмент скрейпит бот, взимание 1 сата за вызов достаточно, чтобы сделать скрейпер нерентабельным. Мы называем это экономикой стоимости атаки, и это причина нашего существования.

Установка

npm install -g @liveauth-labs/mcp-server

Или используйте напрямую через npx:

npx @liveauth-labs/mcp-server

Goose

LiveAuth для Goose использует тот же стандартный stdio MCP-сервер, что и любой другой клиент — нет обёртки Goose, демона или дублирующей среды аутентификации.

Установить в Goose

Или выведите официальную глубокую ссылку и текущие запасные варианты:

npx @liveauth-labs/mcp-server setup goose

Для разовой сессии Goose CLI:

goose session --with-extension "liveauth:npx -y @liveauth-labs/mcp-server"

Ручная настройка stdio для Goose, когда глубокая ссылка недоступна:

extensions:
  liveauth:
    type: stdio
    name: LiveAuth
    enabled: true
    cmd: npx
    args: ["-y", "@liveauth-labs/mcp-server"]
    env_keys: []
    envs: {}
    timeout: 300

Не редактируйте существующую конфигурацию Goose деструктивно. Предпочитайте глубокую ссылку или goose configure; если вы позже добавите конфигурацию проекта, вводите её через настройки секретов расширения Goose, а не через общий открытый текст YAML.

Быстрый тест Goose

Спросите Goose:

Используйте LiveAuth для запуска стандартного потока аутентификации. Подтвердите возвращённую котировку, затем покажите моё использование LiveAuth.

Начальный поток использует PoW-задачу анонимного демо-проекта и не требует кошелька. Публичный ключ проекта необязателен:

Переменная

Когда её устанавливать

LIVEAUTH_API_KEY

Политика, цены и атрибуция конкретного проекта.

LIVEAUTH_API_BASE

Самостоятельно размещённый API LiveAuth вместо https://api.liveauth.app.

LIVEAUTH_DEMO=true

Явно выбрать более старую локально симулированную демонстрацию Lightning.

Когда запрашивается платный поток, результаты инструмента сохраняют существующие поля счёта и также включают переносимые структурированные данные:

{
  "lightning": {
    "invoice": "lnbc...",
    "lightningUri": "lightning:lnbc...",
    "amountSats": 21,
    "expiresAt": "2030-03-17T17:46:40.000Z",
    "status": "pending"
  }
}

Клиенты с поддержкой MCP Apps могут отображать включённый QR-код, действие Open Wallet, срок действия и живое состояние оплачено/ожидает/истекло. Другие клиенты получают JSON и содержимое QR-изображения как обычные результаты MCP.

Устранение неполадок Goose

  • Если ссылка не открывается, выполните npx @liveauth-labs/mcp-server setup goose и используйте его односессионный или ручной запасной вариант.

  • Если npx недоступен, установите актуальную версию Node.js (Node 18 или новее).

  • Если предоставленный ключ проекта отклонён, удалите его, чтобы проверить анонимный поток PoW; недействительные и отозванные ключи намеренно не переключаются на демо.

  • Если счёт Lightning истёк, вызовите liveauth_mcp_start снова, чтобы получить новую котировку.

  • Храните refresh-токены и любые непубличные учётные данные вне журналов и открытых конфигураций.

LiveAuth позволяет агентам получать авторизацию во время выполнения, вместо того чтобы требовать предварительного предоставления постоянных учётных данных для каждого инструмента.

Использование SDK

Пакет также можно импортировать как TypeScript/JavaScript SDK. Импорт пакета не запускает stdio MCP-сервер; CLI находится в бинарном файле liveauth-mcp.

Клиентский помощник аутентификации

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);

Клиент хранит подтверждённые JWT, обновляет их до истечения срока, если возвращён refresh-токен, и предоставляет текущий токен через liveauth.token. Вызовите liveauth.destroy(), когда ваше приложение завершает работу, чтобы очистить состояние токена и таймеры обновления.

Чтобы потребовать реальный платный счёт:

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);

Серверный помощник шлюза

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(...) проверяет JWT, списывает настроенную стоимость в сатах или значение по умолчанию из бэкенд-проекта и передаёт context.liveAuth в ваш обработчик. Старое имя gate.gateTool(...) по-прежнему поддерживается.

Атрибуция платных инструментов

Если ваш MCP-сервер имеет зарегистрированный идентификатор инструмента LiveAuth, передайте toolId при создании шлюза. Тогда платежи направляются на:

POST /api/mcp/tools/{toolId}/charge

вместо устаревшей общей конечной точки:

POST /api/mcp/charge

Вы также можете передать зарегистрированный слаг/имя инструмента как toolName. В этом режиме платежи направляются на общую конечную точку с идентификацией инструмента в теле:

POST /api/mcp/charge

Платежи за инструменты сохраняют те же проверки бюджета сессии, но также записывают неизменяемое событие дохода с валовыми сатами, комиссией платформы LiveAuth, чистыми сатами разработчика, именем метода инструмента, платящим проектом/сессией/токеном, метаданными и ключом идемпотентности. Когда costSats опущен, LiveAuthCore использует зарегистрированную цену инструмента по умолчанию; без toolId или toolName он использует глобальную цену MCP проекта.

Зарегистрированные инструменты также могут иметь URL вебхука для платных вызовов. При каждом успешном новом платном вызове LiveAuthCore ставит в очередь вебхук liveauth.mcp.tool.paid_call с идентификацией инструмента, валовыми/платформенными/чистыми сатами, идентификатором события дохода, метаданными и подписанной квитанцией. Если URL вебхука инструмента пуст, LiveAuthCore использует URL вебхука проекта; идемпотентные повторы не создают дубликатов.

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,
    },
  }
);

Когда заданы toolId или toolName, GateToolOptions поддерживает:

Опция

Назначение

costSats

Необязательные саты для списания за этот вызов. Опустите, чтобы использовать цену зарегистрированного инструмента или глобальную цену проекта.

toolName

Необязательное переопределение слага/имени инструмента для вызова при использовании общей конечной точки.

toolMethodName

Метод внутри инструмента, например web_fetch или search.

idempotencyKey

Ключ, безопасный для повторов. Повторное использование для того же инструмента возвращает исходное событие дохода и подписанную квитанцию вместо двойного списания.

agentId

Необязательный идентификатор вызывающего/агента для отчётности.

metadata

Небольшой JSON-объект для контекста аудита. Не храните здесь приватный вывод инструмента.

Ответы на платежи за инструменты включают обычные счётчики бюджета плюс учёт дохода:

{
  "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"
    }
  }
}

Квитанция — это подписанный аудиторский артефакт для каждого вызова, возвращаемый LiveAuthCore для платных платежей за инструменты. Храните её вместе с результатом инструмента, когда вам нужно доказательство оплаты или последующая сверка.

Если toolId или toolName не настроены, SDK продолжает использовать /api/mcp/charge для обратно совместимого учёта использования.

Конфигурация

Claude Desktop

Добавьте в ваш 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"
      }
    }
  }
}

Режим без учётных данных: Если вы опустите LIVEAUTH_API_KEY, сервер вызывает обычные конечные точки MCP без заголовка проекта. LiveAuth привязывает настроенный анонимный демо-проект, возвращает подписанную PoW-задачу и сохраняет обычные границы проверки, JWT, ограничения скорости и учёта. LIVEAUTH_DEMO=true остаётся явным выбором более старого локально симулированного предпросмотра Lightning.

Другие переменные окружения:

Переменная

По умолчанию

Назначение

LIVEAUTH_API_KEY

(не задано)

Публичный ключ вашего проекта LiveAuth (la_pk_…).

LIVEAUTH_API_BASE

https://api.liveauth.app

Переопределение для самостоятельно размещённого LiveAuth.

LIVEAUTH_DEMO

false

Явно использовать устаревшую локально симулированную демонстрацию Lightning.

Другие MCP-клиенты

Сервер говорит на stdio (JSON-RPC 2.0). Запустите его с помощью:

liveauth-mcp

Он также работает с любым MCP-совместимым клиентом: Cursor, VS Code, ChatGPT, Windsurf, Continue, Cline.

Справочник инструментов

Полные схемы для каждого MCP-инструмента. Каждый инструмент совместим с JSON-RPC 2.0 и протестирован в src/index.test.ts и src/cli.test.ts.

liveauth_mcp_start

Запускает новую сессию LiveAuth MCP. По умолчанию возвращает PoW-задачу или Lightning-инвойс, если forceLightning=true.

Параметры:

  • forceLightning (boolean, optional): Если true, запросить Lightning-инвойс вместо PoW-задачи

  • forceL402 (boolean, optional): Если true, запустить сессию, которая должна быть подтверждена макаруном L402-бандла

Возвращает (PoW):

{
  "quoteId": "uuid-of-session",
  "powChallenge": {
    "projectId": "guid",
    "projectPublicKey": "la_pk_...",
    "challengeHex": "a1b2c3...",
    "targetHex": "0000ffff...",
    "difficultyBits": 18,
    "expiresAtUnix": 1234567890,
    "signature": "sig..."
  },
  "invoice": null
}

Возвращает (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"
  }
}

Возвращает (L402 bundle):

{
  "quoteId": "uuid-of-session",
  "powChallenge": null,
  "invoice": null,
  "authHint": "l402_bundle"
}

liveauth_mcp_confirm

Отправьте решённую задачу доказательства работы, позвольте пакету решить его кэшированную задачу, опросите Lightning-платёж или предъявите L402-макарун, чтобы получить JWT-токен аутентификации.

Параметры:

  • quoteId (string): quoteId из ответа start

  • challengeHex (string, optional, только PoW): hex-значение задачи из ответа start

  • nonce (number, optional, только PoW): nonce, решающий PoW-задачу

  • hashHex (string, optional, только PoW): результирующий хэш (sha256 от projectPublicKey:challengeHex:nonce)

  • expiresAtUnix (number, optional, только PoW): временная метка истечения из задачи

  • difficultyBits (number, optional, только PoW): биты сложности из задачи

  • signature (string, optional, только PoW): подпись из задачи

  • macaroon (string, только L402): макарун бандла, возвращённый из процесса получения L402-бандла

Если задача пришла с этого MCP-сервера, вызов confirm с одним quoteId повторно использует существующий PoW-решатель пакета. Явные поля решения по-прежнему поддерживаются для совместимости.

Возвращает:

{
  "jwt": "eyJhbGc...",
  "expiresIn": 600,
  "remainingBudgetSats": 10000,
  "refreshToken": "abc123def456..."
}

Примечание: Храните refreshToken в безопасности. Он возвращается в данных MCP-инструмента, но никогда не записывается в stderr или журналы приложения. Используйте liveauth_mcp_refresh, чтобы получить новый JWT без повторной аутентификации.

liveauth_mcp_charge

Учитывайте использование API после выполнения аутентифицированного вызова. Встроенный MCP-сервер вызывает общий эндпоинт /api/mcp/charge. Указание toolName позволяет LiveAuth найти зарегистрированный инструмент, применить его настроенную цену и создать событие дохода от платного инструмента; опускание toolName сохраняет обратно совместимый общий учёт.

Параметры:

  • callCostSats (number, optional): Стоимость вызова API в сатах. Опустите, чтобы использовать ценообразование бэкенда.

  • toolName (string, optional): Зарегистрированный slug/имя MCP-инструмента для ценообразования и атрибуции по каждому инструменту.

Возвращает:

{
  "status": "ok",
  "callsUsed": 5,
  "satsUsed": 15
}

Если бюджет превышен:

{
  "status": "deny",
  "callsUsed": 100,
  "satsUsed": 1000,
  "reason": "budget_exceeded"
}

liveauth_mcp_status

Проверьте статус MCP-сессии. Используйте для опроса подтверждения Lightning-платежа.

Параметры:

  • quoteId (string): quoteId из ответа start

Возвращает:

{
  "quoteId": "uuid-of-session",
  "status": "pending",
  "paymentStatus": "pending",
  "expiresAt": "2026-02-17T12:00:00Z"
}

Когда paymentStatus равен "paid", сессия подтверждена. Вызовите liveauth_mcp_confirm ещё раз, чтобы получить JWT.

liveauth_mcp_lnurl

Получите Lightning-инвойс для сессии (совместимо с lnget). Используйте это для получения BOLT11-инвойса для оплаты любым Lightning-кошельком.

Параметры:

  • quoteId (string): quoteId из ответа start

Возвращает:

{
  "pr": "lnbc2100n1...",
  "routes": []
}

Примечание: Это совместимо с lnget и другими инструментами Lightning-платежей. Используйте это для опроса инвойса, когда liveauth_mcp_confirm возвращает "payment pending".

liveauth_mcp_usage

Запросите текущее использование и оставшийся бюджет без списания. Используйте это для проверки статуса перед выполнением API-вызовов.

Параметры: (не требуется)

Возвращает:

{
  "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

Обновите JWT-токен без повторной аутентификации. Используйте refreshToken, возвращённый из confirm, чтобы получить новый JWT, когда текущий истечёт.

Параметры:

  • refreshToken (string): refreshToken из ответа confirm

Возвращает:

{
  "jwt": "eyJhbGc...",
  "expiresIn": 600,
  "remainingBudgetSats": 9985
}

Примечание: Сохраните refreshToken в безопасности. Он понадобится вам для продления сессии без решения новой PoW-задачи или совершения ещё одного Lightning-платежа.

Пример использования

Аутентификация PoW

  1. Вызовите liveauth_mcp_start, чтобы получить PoW-задачу и quoteId

  2. Вызовите liveauth_mcp_confirm с quoteId; MCP-сервер решает свою кэшированную задачу с помощью существующего решателя пакета

  3. Продвинутые клиенты могут по-прежнему отправлять явное решение (hash = sha256(projectPublicKey:challengeHex:nonce), где hash < targetHex)

  4. Используйте JWT в заголовке Authorization: Bearer <token> для API-запросов

  5. После каждого обычного API-вызова вызывайте liveauth_mcp_charge со стоимостью вызова или опустите её, чтобы использовать глобальную MCP-цену проекта

  6. Для монетизированных MCP-инструментов оборачивайте обработчики с помощью createMcpGate({ toolId }) или createMcpGate({ toolName }), чтобы каждый вызов создавал событие дохода и подписанную квитанцию

Аутентификация Lightning

  1. Вызовите liveauth_mcp_start с forceLightning: true, чтобы получить Lightning-инвойс

  2. Используйте liveauth_mcp_lnurl (или опрашивайте liveauth_mcp_status), чтобы получить BOLT11-инвойс

  3. Оплатите инвойс с помощью вашего Lightning-узла/кошелька

  4. Опрашивайте liveauth_mcp_status с quoteId, пока paymentStatus не станет "paid"

  5. Вызовите liveauth_mcp_confirm только с quoteId, чтобы получить JWT

  6. Используйте JWT либо с общим учётом liveauth_mcp_charge, либо с атрибуцией платных инструментов SDK

Процесс аутентификации

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  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    │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Серверы платных инструментов используют тот же JWT, но списывают средства через атрибутированный эндпоинт:

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-бандла

LiveAuthCore поддерживает L402-бандлы на основе Lightning для предоплаченного доступа к MCP. Купите бандл, получите макарун после оплаты, затем запустите MCP-сессию в режиме L402 и подтвердите её этим макаруном.

# 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"}'

Разработка

# Install dependencies
npm install

# Build
npm run build

# Run locally
node dist/cli.js

Ресурсы

Лицензия

MIT


Категории: 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