@lightning-tools/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,88 @@
+# @lightning-tools/mcp-server
+
+Use Lightning Tools directly inside Claude, Cursor, or any MCP-compatible AI agent.
+
+## Prerequisites
+
+- Node.js 18 or later
+- An MCP-compatible client (Claude, Cursor, etc.)
+- A Lightning wallet to pay for credits
+
+## Quick start
+
+### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "lightning-tools": {
+      "command": "npx",
+      "args": ["@lightning-tools/mcp-server"]
+    }
+  }
+}
+```
+
+If you already have an API key, pass it as an environment variable to skip the payment step:
+
+```json
+{
+  "mcpServers": {
+    "lightning-tools": {
+      "command": "npx",
+      "args": ["@lightning-tools/mcp-server"],
+      "env": {
+        "LIGHTNING_TOOLS_API_KEY": "sk_..."
+      }
+    }
+  }
+}
+```
+
+Your API key can also be set in the environment directly:
+
+```bash
+export LIGHTNING_TOOLS_API_KEY=sk_...
+```
+
+The env var takes priority over any saved config. To persist a key without the payment flow, write it directly to `~/.config/lightning-tools/config.json`:
+
+```json
+{ "apiKey": "sk_..." }
+```
+
+## First use
+
+1. Ask the agent to call `buy_credits` with a quantity (minimum 1000).
+2. It returns a Lightning invoice. Pay it from any Lightning wallet.
+3. Call `verify_payment` with the `invoiceId` and `quantity` from step 1.
+4. Your API key is saved automatically. All service tools are now unlocked.
+
+## Available tools
+
+### Always available
+
+| Tool             | Description                                    |
+| ---------------- | ---------------------------------------------- |
+| `buy_credits`    | Purchase credits via Bitcoin Lightning invoice |
+| `verify_payment` | Confirm payment and unlock all service tools   |
+| `check_balance`  | Check your current credit balance              |
+
+### Unlocked after payment
+
+| Tool               | Description                        | Cost        |
+| ------------------ | ---------------------------------- | ----------- |
+| `validate_email`   | Validate an email address          | 1–5 credits |
+| `calculate`        | Evaluate a mathematical expression | 1 credit    |
+| `generate_qr_code` | Generate a QR code                 | 1 credit    |
+| `validate_phone`   | Validate a phone number            | 1 credit    |
+| `readability`      | Extract article content from a URL | 2 credits   |
+
+Credits are denominated in satoshis — 1 sat = 1 credit.
+
+## Links
+
+- API: https://api.lightningapi.tools
+- Web: https://lightningapi.tools/mcp

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+export declare class ApiError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export interface ApiResult<T = unknown> {
+    data: T;
+    creditsRemaining: number | null;
+}
+export declare function callApi<T = unknown>(path: string, body: unknown, apiKey: string): Promise<ApiResult<T>>;
+//# 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":"AAGA,qBAAa,QAAS,SAAQ,KAAK;aAEf,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,IAAI,EAAE,CAAC,CAAC;IACR,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,wBAAsB,OAAO,CAAC,CAAC,GAAG,OAAO,EACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CA4BvB"}

package/dist/client.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiError = void 0;
+exports.callApi = callApi;
+const crypto_1 = require("crypto");
+const constants_1 = require("./constants");
+class ApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'ApiError';
+    }
+}
+exports.ApiError = ApiError;
+async function callApi(path, body, apiKey) {
+    let res;
+    try {
+        res = await fetch(`${constants_1.API_BASE}${path}`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'Content-Type': 'application/json',
+                'Idempotency-Key': (0, crypto_1.randomUUID)(),
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    catch (err) {
+        throw new ApiError(0, err instanceof Error ? err.message : 'Network error');
+    }
+    const data = await res.json();
+    if (!res.ok) {
+        const message = data.message ?? `HTTP ${res.status}`;
+        throw new ApiError(res.status, message);
+    }
+    const creditsHeader = res.headers.get('X-Credits-Remaining');
+    const parsed = creditsHeader !== null ? parseInt(creditsHeader, 10) : null;
+    const creditsRemaining = parsed !== null && !isNaN(parsed) ? parsed : null;
+    return { data, creditsRemaining };
+}

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+export declare const CONFIG_PATH: string;
+export declare function loadApiKey(): Promise<string | null>;
+export declare function saveApiKey(apiKey: string): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,QAA+D,CAAC;AAGxF,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWzD;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9D"}

package/dist/config.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_PATH = void 0;
+exports.loadApiKey = loadApiKey;
+exports.saveApiKey = saveApiKey;
+const promises_1 = require("fs/promises");
+const os_1 = require("os");
+const path_1 = require("path");
+exports.CONFIG_PATH = (0, path_1.join)((0, os_1.homedir)(), '.config', 'lightning-tools', 'config.json');
+const CONFIG_DIR = (0, path_1.dirname)(exports.CONFIG_PATH);
+async function loadApiKey() {
+    const envKey = process.env.LIGHTNING_TOOLS_API_KEY;
+    if (envKey)
+        return envKey;
+    try {
+        const raw = await (0, promises_1.readFile)(exports.CONFIG_PATH, 'utf8');
+        const config = JSON.parse(raw);
+        return typeof config.apiKey === 'string' ? config.apiKey : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function saveApiKey(apiKey) {
+    await (0, promises_1.mkdir)(CONFIG_DIR, { recursive: true });
+    await (0, promises_1.writeFile)(exports.CONFIG_PATH, JSON.stringify({ apiKey }, null, 2), 'utf8');
+}

package/dist/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const API_BASE = "https://api.lightningapi.tools";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,mCAAmC,CAAC"}

package/dist/constants.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.API_BASE = void 0;
+exports.API_BASE = 'https://api.lightningapi.tools';

package/dist/credits.d.ts

@@ -0,0 +1,13 @@
+import { McpResult } from './types';
+export declare function createBuyCreditsHandler(getApiKey?: () => string | undefined): (args: {
+    quantity: number;
+}) => Promise<McpResult>;
+export declare function createVerifyPaymentHandler(onKeyResolved: (key: string) => void): (args: {
+    invoiceId: string;
+    quantity: number;
+}) => Promise<McpResult>;
+export declare function createSetApiKeyHandler(onKeyResolved: (key: string) => void): (args: {
+    apiKey: string;
+}) => Promise<McpResult>;
+export declare function createCheckBalanceHandler(getApiKey: () => string | null): (_args: Record<string, never>) => Promise<McpResult>;
+//# sourceMappingURL=credits.d.ts.map

package/dist/credits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.d.ts","sourceRoot":"","sources":["../src/credits.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAyB,MAAM,SAAS,CAAC;AAY3D,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,IAC5D,MAAM;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,SAAS,CAAC,CAuB9D;AAED,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,IAC/D,MAAM;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,SAAS,CAAC,CAkCjF;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,IAC3D,MAAM;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,SAAS,CAAC,CAQ5D;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,MAAM,GAAG,IAAI,IACxD,OAAO,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,KAAG,OAAO,CAAC,SAAS,CAAC,CAqBhE"}

package/dist/credits.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBuyCreditsHandler = createBuyCreditsHandler;
+exports.createVerifyPaymentHandler = createVerifyPaymentHandler;
+exports.createSetApiKeyHandler = createSetApiKeyHandler;
+exports.createCheckBalanceHandler = createCheckBalanceHandler;
+const config_1 = require("./config");
+const constants_1 = require("./constants");
+const types_1 = require("./types");
+async function post(path, body, apiKey) {
+    const headers = { 'Content-Type': 'application/json' };
+    if (apiKey)
+        headers['Authorization'] = `Bearer ${apiKey}`;
+    return fetch(`${constants_1.API_BASE}/api/v1${path}`, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(body),
+    });
+}
+function createBuyCreditsHandler(getApiKey) {
+    return async (args) => {
+        try {
+            const body = { quantity: args.quantity };
+            const existingApiKey = getApiKey?.();
+            if (existingApiKey)
+                body.apiKey = existingApiKey;
+            const res = await post('/credits', body);
+            const data = await res.json();
+            if (res.status !== 402) {
+                return (0, types_1.err)(`Failed to create invoice: ${data.message ?? res.status}`);
+            }
+            return (0, types_1.ok)(`Pay this Lightning invoice to receive ${args.quantity} credits:\n\n` +
+                `${data.invoice}\n\n` +
+                `Invoice ID: ${data.invoiceId}\n\n` +
+                `Once paid, call verify_payment with invoiceId="${data.invoiceId}" and quantity=${args.quantity}.`);
+        }
+        catch (e) {
+            return (0, types_1.err)(`Network error: ${(0, types_1.errorMessage)(e)}`);
+        }
+    };
+}
+function createVerifyPaymentHandler(onKeyResolved) {
+    return async (args) => {
+        try {
+            const res = await post('/credits/verify', {
+                invoiceId: args.invoiceId,
+                quantity: args.quantity,
+            });
+            const data = await res.json();
+            if (res.status === 402) {
+                return (0, types_1.err)(`Invoice not yet paid. Pay the invoice then call verify_payment again.`);
+            }
+            if (!res.ok) {
+                return (0, types_1.err)(`Verification failed: ${data.message ?? res.status}`);
+            }
+            const apiKey = data.apiKey;
+            if (typeof apiKey !== 'string') {
+                return (0, types_1.err)('Verification succeeded but no API key was returned.');
+            }
+            await (0, config_1.saveApiKey)(apiKey);
+            onKeyResolved(apiKey);
+            const balance = data.balance?.available ?? args.quantity;
+            return (0, types_1.ok)(`Payment confirmed. Your API key is:\n\n${apiKey}\n\n` +
+                `Credits available: ${balance}\n\n` +
+                `All Lightning Tools are now unlocked. Use the API key with any service tool.`);
+        }
+        catch (e) {
+            return (0, types_1.err)(`Network error: ${(0, types_1.errorMessage)(e)}`);
+        }
+    };
+}
+function createSetApiKeyHandler(onKeyResolved) {
+    return async (args) => {
+        if (!args.apiKey) {
+            return (0, types_1.err)('API key cannot be empty.');
+        }
+        await (0, config_1.saveApiKey)(args.apiKey);
+        onKeyResolved(args.apiKey);
+        return (0, types_1.ok)(`API key saved: ${args.apiKey}\n\nAll Lightning Tools are now unlocked.`);
+    };
+}
+function createCheckBalanceHandler(getApiKey) {
+    return async (_args) => {
+        const apiKey = getApiKey();
+        if (!apiKey) {
+            return (0, types_1.err)('No API key set. Call buy_credits to purchase credits first.');
+        }
+        try {
+            const res = await fetch(`${constants_1.API_BASE}/api/v1/balance`, {
+                headers: { Authorization: `Bearer ${apiKey}` },
+            });
+            const data = await res.json();
+            if (!res.ok) {
+                return (0, types_1.err)('Could not retrieve balance. Your API key may be invalid.');
+            }
+            return (0, types_1.ok)(`Credits available: ${data.available}\nTotal purchased: ${data.total}`);
+        }
+        catch (e) {
+            return (0, types_1.err)(`Network error: ${(0, types_1.errorMessage)(e)}`);
+        }
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const config_1 = require("./config");
+const tools_1 = require("./tools");
+const credits_1 = require("./credits");
+const types_1 = require("./types");
+const client_1 = require("./client");
+// Inline schemas as raw ZodRawShapeCompat (Record<string, ZodType>)
+// to avoid TypeScript deep instantiation errors with z.object()
+const buyCreditsSchema = {
+    quantity: zod_1.z.number().int().min(1000).describe('Number of credits to purchase (minimum 1000)'),
+};
+const verifyPaymentSchema = {
+    invoiceId: zod_1.z.string().describe('Invoice ID returned by buy_credits'),
+    quantity: zod_1.z.number().int().describe('Must match quantity from buy_credits'),
+};
+async function main() {
+    const server = new mcp_js_1.McpServer({
+        name: 'lightning-tools',
+        version: '0.1.0',
+    });
+    let apiKey = await (0, config_1.loadApiKey)();
+    async function registerServiceTools(key) {
+        apiKey = key;
+        try {
+            const tools = await (0, tools_1.fetchServiceTools)();
+            for (const tool of tools) {
+                const toolPath = tool.path;
+                server.registerTool(tool.name, {
+                    description: tool.description,
+                    inputSchema: zod_1.z.object({}).passthrough(), // eslint-disable-line @typescript-eslint/no-explicit-any
+                }, (args) => {
+                    return (0, client_1.callApi)(toolPath, args, key)
+                        .then((result) => {
+                        const text = JSON.stringify(result.data, null, 2) +
+                            (result.creditsRemaining !== null
+                                ? `\n\nCredits remaining: ${result.creditsRemaining}`
+                                : '');
+                        return (0, types_1.ok)(text);
+                    })
+                        .catch((e) => (0, types_1.err)((0, types_1.errorMessage)(e)));
+                });
+            }
+            console.error(`Registered ${tools.length} service tools.`);
+        }
+        catch (e) {
+            console.error('Failed to load service tools:', e);
+        }
+    }
+    // Cast to `any` on inputSchema to avoid TS2589 deep instantiation with zod v3 + MCP SDK generics
+    /* eslint-disable @typescript-eslint/no-explicit-any */
+    const buyHandler = (0, credits_1.createBuyCreditsHandler)(() => apiKey ?? undefined);
+    server.registerTool('buy_credits', {
+        description: 'Purchase Lightning Tools credits via Bitcoin Lightning invoice. Costs N sats = N credits. Also unlocks all service tools once paid.',
+        inputSchema: buyCreditsSchema,
+    }, (args) => buyHandler(args));
+    const verifyHandler = (0, credits_1.createVerifyPaymentHandler)(registerServiceTools);
+    server.registerTool('verify_payment', {
+        description: 'Confirm a Lightning payment and receive your API key. Call after paying the invoice from buy_credits.',
+        inputSchema: verifyPaymentSchema,
+    }, (args) => verifyHandler(args));
+    const setKeyHandler = (0, credits_1.createSetApiKeyHandler)(registerServiceTools);
+    server.registerTool('set_api_key', {
+        description: 'Store an existing Lightning Tools API key. Saves it to config and unlocks all service tools.',
+        inputSchema: {
+            apiKey: zod_1.z.string().describe('Your Lightning Tools API key (starts with sk_)'),
+        }, // eslint-disable-line @typescript-eslint/no-explicit-any
+    }, (args) => setKeyHandler(args));
+    const balanceHandler = (0, credits_1.createCheckBalanceHandler)(() => apiKey);
+    server.registerTool('check_balance', { description: 'Return the current credit balance for your active API key.' }, (extra) => balanceHandler(extra));
+    /* eslint-enable @typescript-eslint/no-explicit-any */
+    if (apiKey) {
+        await registerServiceTools(apiKey);
+    }
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error('Lightning Tools MCP server connected.');
+}
+main().catch((e) => {
+    console.error('Fatal error:', e);
+    process.exit(1);
+});

package/dist/tools.d.ts

@@ -0,0 +1,12 @@
+export interface ServiceTool {
+    name: string;
+    description: string;
+    path: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export declare function fetchServiceTools(): Promise<ServiceTool[]>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAuBD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAsChE"}

package/dist/tools.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchServiceTools = fetchServiceTools;
+const constants_1 = require("./constants");
+function toSnakeCase(str) {
+    return str
+        .replace(/([A-Z])/g, '_$1')
+        .toLowerCase()
+        .replace(/^_/, '')
+        .replace(/[-\s]+/g, '_');
+}
+function formatPrice(price) {
+    if (typeof price === 'number')
+        return `Costs ${price} credit${price === 1 ? '' : 's'} per call.`;
+    if (typeof price === 'object' && price !== null) {
+        const values = Object.values(price);
+        const min = Math.min(...values);
+        const max = Math.max(...values);
+        return min === max
+            ? `Costs ${min} credit${min === 1 ? '' : 's'} per call.`
+            : `Costs ${min}–${max} credits per call (tier-dependent).`;
+    }
+    return '';
+}
+async function fetchServiceTools() {
+    const res = await fetch(`${constants_1.API_BASE}/openapi.json`);
+    if (!res.ok)
+        throw new Error(`Failed to fetch openapi.json: ${res.status}`);
+    const spec = await res.json();
+    const tools = [];
+    for (const [path, pathItem] of Object.entries(spec.paths)) {
+        if (path.startsWith('/api/v1/'))
+            continue;
+        const op = pathItem.post;
+        if (!op)
+            continue;
+        if (!('x-price' in op))
+            continue;
+        const schema = op.requestBody
+            ?.content?.['application/json'];
+        const inputSchema = schema?.schema ?? {
+            type: 'object',
+            properties: {},
+        };
+        const priceNote = formatPrice(op['x-price']);
+        const summary = typeof op.summary === 'string' ? op.summary : '';
+        const description = [summary, priceNote].filter(Boolean).join(' ');
+        const operationId = typeof op.operationId === 'string' ? op.operationId : path.replace(/\//g, '_');
+        tools.push({
+            name: toSnakeCase(operationId),
+            description,
+            path,
+            inputSchema,
+        });
+    }
+    return tools;
+}

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+export interface McpResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare function ok(text: string): McpResult;
+export declare function err(text: string): McpResult;
+export declare function errorMessage(e: unknown): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAE1C;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAE3C;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAE/C"}

package/dist/types.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ok = ok;
+exports.err = err;
+exports.errorMessage = errorMessage;
+function ok(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function err(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function errorMessage(e) {
+    return e instanceof Error ? e.message : 'unknown';
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@lightning-tools/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for Lightning Tools — pay-per-call AI tools via Bitcoin Lightning",
+  "main": "./dist/index.js",
+  "bin": {
+    "lt-mcp": "./dist/index.js"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "lint": "eslint src tests ."
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}