@lavapayments/mcp 0.1.0

package/README.md

@@ -0,0 +1,215 @@
+# Lava MCP Server
+
+An [MCP](https://modelcontextprotocol.io/) server that lets AI agents use **Lava** for merchant operations and gateway traffic. You can authenticate a fresh session with `lava_login`, create billing config, generate forward tokens, and execute real `/v1/chat/completions`, `/v1/messages`, `/v1/forward`, and `/v1/rewrite` requests through Lava.
+
+## Two Different Flows
+
+### MCP flow
+
+Use this package when your host is already running an MCP client such as Claude Code, Claude Desktop, or Cursor.
+
+1. Start the MCP server.
+2. Call `lava_login` from the agent if no keys are preconfigured.
+3. Use MCP tools like `lava_create_meter`, `lava_generate_forward_token`, `lava_chat_completions`, or `lava_forward`.
+
+### SDK flow
+
+Use `@lavapayments/nodejs` directly when you are writing application code.
+
+```typescript
+import { Lava } from '@lavapayments/nodejs';
+
+const credentials = await Lava.login();
+const lava = new Lava(credentials.secret_key);
+```
+
+The SDK flow is documented separately in `/sdk/nodejs`. This MCP package is only for the MCP flow.
+
+## Quick start
+
+### 1. Install and run the MCP server
+
+From this repo (monorepo root or `packages/lava-mcp`):
+
+```bash
+cd packages/lava-mcp
+npm install
+npm run build
+node dist/index.js
+```
+
+Or with `npx` (after publishing):
+
+```bash
+npx @lavapayments/mcp
+```
+
+`LAVA_SECRET_KEY` and `LAVA_WALLET_KEY` are optional now. If you omit them, call `lava_login` once the MCP is running and the server will keep the returned credentials in memory for the current session.
+
+### 2. Connect from Claude Code
+
+Add to your project's `.claude/settings.json` (or `~/.claude/settings.json` for global):
+
+```json
+{
+  "mcpServers": {
+    "lava": {
+      "command": "node",
+      "args": ["/absolute/path/to/packages/lava-mcp/dist/index.js"],
+      "env": {
+        "LAVA_API_URL": "https://api.lava.so",
+        "LAVA_APP_URL": "https://www.lava.so"
+      }
+    }
+  }
+}
+```
+
+Or if published to npm:
+
+```json
+{
+  "mcpServers": {
+    "lava": {
+      "command": "npx",
+      "args": ["-y", "@lavapayments/mcp"],
+      "env": {
+        "LAVA_API_URL": "https://api.lava.so",
+        "LAVA_APP_URL": "https://www.lava.so"
+      }
+    }
+  }
+}
+```
+
+You can still pre-provision `LAVA_SECRET_KEY` and `LAVA_WALLET_KEY` if you want a non-interactive setup.
+
+### 3. First-run authentication
+
+Once the MCP is connected, call:
+
+- `lava_login` to open the existing Lava browser auth flow and bootstrap both merchant and wallet credentials into the MCP session
+- `lava_generate_forward_token` when you need a forward token for customer billing or unmanaged forwarding
+
+### 4. Connect from Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or the equivalent on your platform:
+
+```json
+{
+  "mcpServers": {
+    "lava": {
+      "command": "node",
+      "args": ["/absolute/path/to/packages/lava-mcp/dist/index.js"],
+      "env": {
+        "LAVA_API_URL": "https://api.lava.so",
+        "LAVA_APP_URL": "https://www.lava.so"
+      }
+    }
+  }
+}
+```
+
+### 5. Connect from Cursor
+
+Edit `~/.cursor/mcp.json` or your project's `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "lava": {
+      "command": "node",
+      "args": ["/absolute/path/to/packages/lava-mcp/dist/index.js"],
+      "env": {
+        "LAVA_API_URL": "https://api.lava.so",
+        "LAVA_APP_URL": "https://www.lava.so"
+      }
+    }
+  }
+}
+```
+
+`LAVA_API_URL` defaults to `https://api.lava.so`. `LAVA_APP_URL` defaults to `https://www.lava.so`.
+
+## Environment variables
+
+| Variable           | Required | Default                         | Description                                                   |
+|--------------------|----------|---------------------------------|---------------------------------------------------------------|
+| `LAVA_API_URL`     | No       | `https://api.lava.so`           | API base URL. Override only for debugging against a sandbox.  |
+| `LAVA_APP_URL`     | No       | `https://www.lava.so`           | Browser app URL used by `lava_login`.                         |
+| `LAVA_SECRET_KEY`  | No       | —                               | Merchant secret key (`lava_sk_*`). Optional if you will use `lava_login`. |
+| `LAVA_WALLET_KEY`  | No       | —                               | Wallet API key (`lava_wk_*`). Optional if you will use `lava_login`. |
+
+The server uses **stdio** transport: it reads/writes JSON-RPC on stdin/stdout, so the host (Claude Code, Claude Desktop, Cursor, etc.) must spawn it with the env vars above.
+
+## What the agent can do
+
+All operations are scoped to the currently active merchant session, which comes from either preconfigured env keys or `lava_login`.
+
+### Tools
+
+The MCP exposes the same operations as the merchant-authenticated REST API (`Authorization: Bearer <secret_key>`).
+
+- **Models**: `lava_list_models` — list all AI models and services; no API key required
+- **Auth**: `lava_login` — bootstrap merchant and wallet credentials into the current MCP session
+- **Meters**: `lava_list_meters`, `lava_create_meter`, `lava_get_meter`, `lava_update_meter`, `lava_delete_meter`
+- **Secret keys**: `lava_list_secret_keys`, `lava_create_secret_key`, `lava_revoke_secret_key`
+- **Customers**: `lava_list_customers`, `lava_get_customer`, `lava_get_customer_subscription`, `lava_delete_customer`
+- **Usage**: `lava_get_usage` — aggregated usage with optional `metadata_filters`
+- **Plans**: `lava_list_plans`, `lava_get_plan`, `lava_create_plan`, `lava_update_plan`, `lava_delete_plan`
+- **Subscriptions**: `lava_list_subscriptions` (filterable by `customer_id` and `status`), `lava_update_subscription`, `lava_cancel_subscription`
+- **Webhooks**: `lava_list_webhooks`, `lava_create_webhook`, `lava_get_webhook`, `lava_update_webhook`, `lava_delete_webhook`
+- **Credit bundles**: `lava_list_credit_bundles`, `lava_get_credit_bundle`
+- **Checkout**: `lava_create_checkout_session`
+- **Requests**: `lava_list_requests` (filterable by `metadata_filters`), `lava_get_request`, `lava_track_request` — track usage from outside the proxy for billing
+- **Gateway auth**: `lava_generate_forward_token`
+- **Gateway execution**: `lava_chat_completions`, `lava_messages`, `lava_forward`, `lava_rewrite`
+- **Spend keys** *(requires an active wallet key from env or `lava_login`)*: `lava_list_spend_keys`, `lava_create_spend_key`, `lava_get_spend_key`, `lava_update_spend_key`, `lava_delete_spend_key`, `lava_rotate_spend_key`
+
+### Resources
+
+- **lava://models-guide** – How to use Lava's models (proxy URL, auth, POST /v1/chat/completions). Use when the user or agent asks how to call the gateway or integrate the models.
+- **lava://overview** – Short account overview (counts and first few meters/customers). Use when the user asks "what do I have set up?".
+- **lava://openapi** – Full OpenAPI spec for the Lava REST API. Use when you need exact request/response schemas or want to discover additional endpoints.
+- **lava://webhook-events** – Reference for all webhook event types (`customer.created`, `customer.wallet.balance.updated`, `customer.deleted`) with payload shapes and verification notes.
+
+### Prompts
+
+- **lava_sign_up_user** – Step-by-step for signing up an end-user (onboarding checkout URL). Use when the user asks how to sign up a user for Lava.
+- **lava_get_started** – Concrete zero-to-charging-users flow (meter → plan → onboard user → proxy). Use when the user asks how to set up Lava or what they can do.
+- **lava_integrate** – Copy-paste code examples for pointing OpenAI/Anthropic SDKs at Lava's proxy. Use when the user wants to add Lava billing to an existing app.
+
+## Example prompts (for the user)
+
+- "List my Lava meters."
+- "Create a meter named Chat API, tiered, $0.01 per 1K tokens."
+- "Show me my Lava customers."
+- "What's my usage this month?"
+- "Create a plan with an optional monthly fee, 50 credits, and a linked meter."
+- "Add a webhook for https://myapp.com/webhooks/lava."
+- "Create a checkout link so a customer can subscribe to my $10 plan."
+- "Track a usage event: 500 input tokens, 200 output tokens for customer cus_xxx on meter chat-api."
+
+The agent will pick the right tools and parameters.
+
+## API coverage
+
+The MCP covers merchant-authenticated REST API operations, wallet-scoped spend key operations, session bootstrap via `lava_login`, forward-token generation, and direct gateway execution helpers. Wallet key management endpoints (`/v1/wallet_keys`) are still not exposed as MCP tools.
+
+## Security
+
+- **Never** commit or share `LAVA_SECRET_KEY`. Keep it in env or a local config that's not in version control.
+- The secret key has full access to your merchant's Lava resources (keys, meters, webhooks, etc.). Prefer a dedicated key for the MCP server if possible.
+
+## Development
+
+```bash
+cd packages/lava-mcp
+npm install
+npm run build
+npm run typecheck
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Minimal Lava REST API client for the MCP server.
+ * All /v1/* endpoints use Authorization: Bearer <secret_key>.
+ */
+export type LavaClientConfig = {
+    baseUrl: string;
+    secretKey: string;
+};
+export type LavaGatewayRequest = {
+    baseUrl: string;
+    method: string;
+    path: string;
+    secretKey: string;
+    headers?: Record<string, string>;
+    body?: BodyInit;
+};
+export type LavaGatewayResponse = {
+    ok: boolean;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    contentType: string | null;
+    body: {
+        kind: 'json';
+        value: unknown;
+    } | {
+        kind: 'text';
+        value: string;
+    } | {
+        kind: 'base64';
+        value: string;
+        bytes: number;
+    };
+};
+export declare const API_TIMEOUT_MS = 30000;
+export declare const RESERVED_GATEWAY_HEADERS: Set<string>;
+export declare class LavaApiError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    constructor(message: string, status: number, code?: string, details?: unknown);
+}
+export declare function trimTrailingSlash(url: string): string;
+export declare function parseJsonText(text: string): unknown;
+export declare function throwIfNotOk(res: Response, json: unknown): void;
+export declare function gatewayRequest(args: LavaGatewayRequest): Promise<LavaGatewayResponse>;
+export declare function createLavaClient(config: LavaClientConfig): {
+    get: <T>(path: string, searchParams?: Record<string, string>) => Promise<T>;
+    post: <T>(path: string, body: unknown) => Promise<T>;
+    patch: <T>(path: string, body: unknown) => Promise<T>;
+    put: <T>(path: string, body: unknown) => Promise<T>;
+    delete: <T>(path: string) => Promise<T>;
+    list<T>(path: string, opts?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<{
+        data: T[];
+        has_more: boolean;
+        next_cursor: string | null;
+    }>;
+};
+export type LavaClient = ReturnType<typeof createLavaClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EACA;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAChC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAC/B;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD,CAAC;AAIF,eAAO,MAAM,cAAc,QAAS,CAAC;AAGrC,eAAO,MAAM,wBAAwB,aAYnC,CAAC;AAWH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAGzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO;CAQpB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASnD;AAcD,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAkB/D;AAgID,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAqB9B;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB;UAqB/C,CAAC,QAAQ,MAAM,iBAAiB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;WAGrD,CAAC,QAAQ,MAAM,QAAQ,OAAO;YAG7B,CAAC,QAAQ,MAAM,QAAQ,OAAO;UAGhC,CAAC,QAAQ,MAAM,QAAQ,OAAO;aAE3B,CAAC,QAAQ,MAAM;SAEnB,CAAC,QACE,MAAM,SACL;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;EAe3E;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/client.js

@@ -0,0 +1,206 @@
+/**
+ * Minimal Lava REST API client for the MCP server.
+ * All /v1/* endpoints use Authorization: Bearer <secret_key>.
+ */
+const TRAILING_SLASH_REGEX = /\/+$/;
+const HEADER_VALUE_NEWLINE_REGEX = /[\r\n]/;
+export const API_TIMEOUT_MS = 30_000;
+const GATEWAY_TIMEOUT_MS = 120_000;
+const MAX_GATEWAY_RESPONSE_BYTES = 10 * 1024 * 1024;
+export const RESERVED_GATEWAY_HEADERS = new Set([
+    'authorization',
+    'connection',
+    'content-length',
+    'host',
+    'keep-alive',
+    'proxy-authenticate',
+    'proxy-authorization',
+    'te',
+    'trailer',
+    'transfer-encoding',
+    'upgrade',
+]);
+const FILTERED_RESPONSE_HEADERS = new Set([
+    'authorization',
+    'cookie',
+    'proxy-authenticate',
+    'proxy-authorization',
+    'set-cookie',
+    'set-cookie2',
+    'www-authenticate',
+]);
+export class LavaApiError extends Error {
+    status;
+    code;
+    details;
+    constructor(message, status, code, details) {
+        super(message);
+        this.name = 'LavaApiError';
+        this.status = status;
+        this.code = code;
+        this.details = details;
+    }
+}
+export function trimTrailingSlash(url) {
+    return url.replace(TRAILING_SLASH_REGEX, '');
+}
+export function parseJsonText(text) {
+    if (text.length === 0) {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+function buildBearerAuthHeader(secretKey) {
+    const normalized = secretKey.trim();
+    if (normalized.length === 0 || HEADER_VALUE_NEWLINE_REGEX.test(normalized)) {
+        throw new LavaApiError('Auth token is invalid or empty.', 400, 'invalid_request');
+    }
+    return `Bearer ${normalized}`;
+}
+export function throwIfNotOk(res, json) {
+    if (res.ok) {
+        return;
+    }
+    const err = json && typeof json === 'object' && 'message' in json
+        ? json.message
+        : res.statusText;
+    const code = json && typeof json === 'object' && 'code' in json
+        ? json.code
+        : undefined;
+    throw new LavaApiError(typeof err === 'string' ? err : 'Request failed', res.status, code, json);
+}
+function buildRequestUrl(base, path, searchParams) {
+    const url = new URL(path.startsWith('/') ? path : `/${path}`, base);
+    if (searchParams) {
+        for (const [k, v] of Object.entries(searchParams)) {
+            if (v !== undefined && v !== '') {
+                url.searchParams.set(k, v);
+            }
+        }
+    }
+    return url.toString();
+}
+function buildFetchInit(method, authHeader, body) {
+    const hasBody = body !== undefined;
+    return {
+        method,
+        headers: {
+            Authorization: authHeader,
+            ...(hasBody ? { 'Content-Type': 'application/json' } : {}),
+        },
+        body: hasBody ? JSON.stringify(body) : undefined,
+    };
+}
+function buildGatewayFetchInit(args) {
+    const headers = Object.fromEntries(Object.entries(args.headers ?? {}).filter(([key]) => !RESERVED_GATEWAY_HEADERS.has(key.toLowerCase())));
+    return {
+        method: args.method,
+        headers: {
+            ...headers,
+            Authorization: args.authHeader,
+        },
+        body: args.body,
+        signal: AbortSignal.timeout(GATEWAY_TIMEOUT_MS),
+    };
+}
+function responseHeadersToObject(headers) {
+    return Object.fromEntries([...headers.entries()].filter(([key]) => !FILTERED_RESPONSE_HEADERS.has(key.toLowerCase())));
+}
+async function parseGatewayResponseBody(res) {
+    const contentType = res.headers.get('content-type');
+    const contentLength = Number(res.headers.get('content-length'));
+    if (Number.isFinite(contentLength) &&
+        contentLength > MAX_GATEWAY_RESPONSE_BYTES) {
+        throw new LavaApiError(`Gateway response exceeds the MCP size limit (${contentLength} bytes). Use the SDK or direct proxy for large responses.`, 413, 'response_too_large');
+    }
+    const chunks = [];
+    let totalBytes = 0;
+    for await (const chunk of res.body ?? []) {
+        const buffer = Buffer.from(chunk);
+        totalBytes += buffer.byteLength;
+        if (totalBytes > MAX_GATEWAY_RESPONSE_BYTES) {
+            throw new LavaApiError(`Gateway response exceeds the MCP size limit (${MAX_GATEWAY_RESPONSE_BYTES} bytes). Use the SDK or direct proxy for large responses.`, 413, 'response_too_large');
+        }
+        chunks.push(buffer);
+    }
+    const bytes = Buffer.concat(chunks, totalBytes);
+    if (contentType?.includes('application/json') ||
+        contentType?.includes('+json')) {
+        const text = bytes.toString('utf8');
+        const json = parseJsonText(text);
+        if (json !== null) {
+            return { kind: 'json', value: json };
+        }
+        return { kind: 'text', value: text };
+    }
+    if (contentType?.startsWith('text/') ||
+        contentType?.includes('application/xml') ||
+        contentType?.includes('application/javascript') ||
+        contentType?.includes('application/x-www-form-urlencoded') ||
+        contentType?.includes('event-stream') ||
+        contentType === null) {
+        const text = bytes.toString('utf8');
+        return { kind: 'text', value: text };
+    }
+    return {
+        kind: 'base64',
+        value: bytes.toString('base64'),
+        bytes: bytes.byteLength,
+    };
+}
+export async function gatewayRequest(args) {
+    const base = trimTrailingSlash(args.baseUrl);
+    const url = buildRequestUrl(base, args.path);
+    const res = await fetch(url, buildGatewayFetchInit({
+        method: args.method,
+        authHeader: buildBearerAuthHeader(args.secretKey),
+        headers: args.headers,
+        body: args.body,
+    }));
+    return {
+        ok: res.ok,
+        status: res.status,
+        statusText: res.statusText,
+        headers: responseHeadersToObject(res.headers),
+        contentType: res.headers.get('content-type'),
+        body: await parseGatewayResponseBody(res),
+    };
+}
+export function createLavaClient(config) {
+    const base = trimTrailingSlash(config.baseUrl);
+    const authHeader = buildBearerAuthHeader(config.secretKey);
+    async function request(method, path, options) {
+        const url = buildRequestUrl(base, path, options?.searchParams);
+        const res = await fetch(url, {
+            ...buildFetchInit(method, authHeader, options?.body),
+            signal: AbortSignal.timeout(API_TIMEOUT_MS),
+        });
+        const text = await res.text();
+        const json = parseJsonText(text);
+        throwIfNotOk(res, json);
+        return json;
+    }
+    return {
+        get: (path, searchParams) => request('GET', path, { searchParams }),
+        post: (path, body) => request('POST', path, { body }),
+        patch: (path, body) => request('PATCH', path, { body }),
+        put: (path, body) => request('PUT', path, { body }),
+        delete: (path) => request('DELETE', path),
+        list(path, opts) {
+            const searchParams = {};
+            if (opts?.cursor) {
+                searchParams.cursor = opts.cursor;
+            }
+            if (opts?.limit !== undefined) {
+                searchParams.limit = String(opts.limit);
+            }
+            return request('GET', path, { searchParams });
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4BH,MAAM,oBAAoB,GAAG,MAAM,CAAC;AACpC,MAAM,0BAA0B,GAAG,QAAQ,CAAC;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACrC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AACnC,MAAM,0BAA0B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IAC9C,eAAe;IACf,YAAY;IACZ,gBAAgB;IAChB,MAAM;IACN,YAAY;IACZ,oBAAoB;IACpB,qBAAqB;IACrB,IAAI;IACJ,SAAS;IACT,mBAAmB;IACnB,SAAS;CACV,CAAC,CAAC;AACH,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACxC,eAAe;IACf,QAAQ;IACR,oBAAoB;IACpB,qBAAqB;IACrB,YAAY;IACZ,aAAa;IACb,kBAAkB;CACnB,CAAC,CAAC;AAEH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,MAAM,CAAS;IACf,IAAI,CAAU;IACd,OAAO,CAAW;IAE3B,YACE,OAAe,EACf,MAAc,EACd,IAAa,EACb,OAAiB;QAEjB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,GAAG,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,SAAiB;IAC9C,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,0BAA0B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,YAAY,CACpB,iCAAiC,EACjC,GAAG,EACH,iBAAiB,CAClB,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,UAAU,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAa,EAAE,IAAa;IACvD,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GACP,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,SAAS,IAAI,IAAI;QACnD,CAAC,CAAE,IAA6B,CAAC,OAAO;QACxC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;IACrB,MAAM,IAAI,GACR,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI;QAChD,CAAC,CAAE,IAA0B,CAAC,IAAI;QAClC,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,IAAI,YAAY,CACpB,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,EAChD,GAAG,CAAC,MAAM,EACV,IAAI,EACJ,IAAI,CACL,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,IAAY,EACZ,IAAY,EACZ,YAAqC;IAErC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IACpE,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBAChC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,cAAc,CACrB,MAAc,EACd,UAAkB,EAClB,IAAc;IAEd,MAAM,OAAO,GAAG,IAAI,KAAK,SAAS,CAAC;IACnC,OAAO;QACL,MAAM;QACN,OAAO,EAAE;YACP,aAAa,EAAE,UAAU;YACzB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3D;QACD,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KACjD,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,IAK9B;IACC,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAChC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CACvC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAC5D,CACF,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE;YACP,GAAG,OAAO;YACV,aAAa,EAAE,IAAI,CAAC,UAAU;SAC/B;QACD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,kBAAkB,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAgB;IAC/C,OAAO,MAAM,CAAC,WAAW,CACvB,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAC3B,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,yBAAyB,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAC7D,CACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,GAAa;IAEb,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAChE,IACE,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC9B,aAAa,GAAG,0BAA0B,EAC1C,CAAC;QACD,MAAM,IAAI,YAAY,CACpB,gDAAgD,aAAa,2DAA2D,EACxH,GAAG,EACH,oBAAoB,CACrB,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;QAChC,IAAI,UAAU,GAAG,0BAA0B,EAAE,CAAC;YAC5C,MAAM,IAAI,YAAY,CACpB,gDAAgD,0BAA0B,2DAA2D,EACrI,GAAG,EACH,oBAAoB,CACrB,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEhD,IACE,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC;QACzC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC9B,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACvC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,IACE,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC;QAChC,WAAW,EAAE,QAAQ,CAAC,iBAAiB,CAAC;QACxC,WAAW,EAAE,QAAQ,CAAC,wBAAwB,CAAC;QAC/C,WAAW,EAAE,QAAQ,CAAC,mCAAmC,CAAC;QAC1D,WAAW,EAAE,QAAQ,CAAC,cAAc,CAAC;QACrC,WAAW,KAAK,IAAI,EACpB,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC/B,KAAK,EAAE,KAAK,CAAC,UAAU;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAwB;IAExB,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,EACH,qBAAqB,CAAC;QACpB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC;QACjD,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC,CACH,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC;QAC7C,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC5C,IAAI,EAAE,MAAM,wBAAwB,CAAC,GAAG,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAE3D,KAAK,UAAU,OAAO,CACpB,MAAc,EACd,IAAY,EACZ,OAAmE;QAEnE,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,GAAG,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;YACpD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,cAAc,CAAC;SAC5C,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxB,OAAO,IAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,GAAG,EAAE,CAAI,IAAY,EAAE,YAAqC,EAAE,EAAE,CAC9D,OAAO,CAAI,KAAK,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC;QAE3C,IAAI,EAAE,CAAI,IAAY,EAAE,IAAa,EAAE,EAAE,CACvC,OAAO,CAAI,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;QAEpC,KAAK,EAAE,CAAI,IAAY,EAAE,IAAa,EAAE,EAAE,CACxC,OAAO,CAAI,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;QAErC,GAAG,EAAE,CAAI,IAAY,EAAE,IAAa,EAAE,EAAE,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;QAE1E,MAAM,EAAE,CAAI,IAAY,EAAE,EAAE,CAAC,OAAO,CAAI,QAAQ,EAAE,IAAI,CAAC;QAEvD,IAAI,CACF,IAAY,EACZ,IAA0C;YAE1C,MAAM,YAAY,GAA2B,EAAE,CAAC;YAChD,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;gBACjB,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YACpC,CAAC;YACD,IAAI,IAAI,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC9B,YAAY,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,OAAO,CAIX,KAAK,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Lava MCP Server
+ *
+ * Lets an AI agent use Lava (meters, keys, customers, usage, webhooks, checkout, gateway traffic, etc.)
+ * without opening the dashboard. Configure with LAVA_API_URL and optionally LAVA_SECRET_KEY,
+ * or authenticate interactively via lava_login.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG"}