lightning-faucet-mcp 1.0.0

package/README.md

@@ -0,0 +1,168 @@
+# Lightning Faucet MCP Server
+
+MCP (Model Context Protocol) server that gives AI agents the ability to send and receive Bitcoin via the Lightning Network.
+
+## Features
+
+- **check_balance** - Check your agent's current Lightning balance
+- **pay_l402_api** - Pay for L402-protected API access automatically
+- **pay_invoice** - Pay any BOLT11 Lightning invoice
+- **create_invoice** - Generate invoices to receive payments
+- **get_invoice_status** - Check if an invoice has been paid
+- **get_transactions** - View transaction history
+
+## Quick Start
+
+### 1. Get an API Key
+
+Sign up at [https://lightningfaucet.com/ai-agents/](https://lightningfaucet.com/ai-agents/) to create an agent wallet and get your API key.
+
+### 2. Install
+
+```bash
+npm install -g lightning-faucet-mcp
+```
+
+### 3. Configure Claude Code
+
+Add to your `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "lightning-faucet": {
+      "command": "npx",
+      "args": ["lightning-faucet-mcp"],
+      "env": {
+        "LIGHTNING_FAUCET_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+Or for project-specific configuration, add to `.claude/settings.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "lightning-faucet": {
+      "command": "npx",
+      "args": ["lightning-faucet-mcp"],
+      "env": {
+        "LIGHTNING_FAUCET_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+### check_balance
+
+Check your agent's current Lightning balance in satoshis.
+
+```
+No parameters required
+```
+
+### pay_l402_api
+
+Make a request to an L402-protected API. If the API requires payment (HTTP 402), the Lightning invoice is automatically paid and the request completed.
+
+```
+Parameters:
+- url (required): The URL to request
+- method: HTTP method (GET, POST, PUT, DELETE) - default: GET
+- body: Request body for POST/PUT requests
+- max_payment_sats: Maximum amount to pay - default: 1000 sats
+```
+
+Example: Access a paid API that returns a fortune
+```
+pay_l402_api(url: "https://lightningfaucet.com/api/l402/fortune")
+```
+
+### pay_invoice
+
+Pay a BOLT11 Lightning invoice from your agent's balance.
+
+```
+Parameters:
+- bolt11 (required): The BOLT11 invoice string (starts with lnbc...)
+- max_fee_sats: Maximum routing fee in satoshis
+```
+
+Returns the preimage as proof of payment.
+
+### create_invoice
+
+Create a Lightning invoice to receive payment.
+
+```
+Parameters:
+- amount_sats (required): Amount in satoshis to request (minimum: 1)
+- memo: Description/memo for the invoice (max 640 chars)
+```
+
+Use `get_invoice_status` with the returned `payment_hash` to check if it's been paid.
+
+### get_invoice_status
+
+Check if a created invoice has been paid.
+
+```
+Parameters:
+- payment_hash (required): The payment hash from create_invoice
+```
+
+### get_transactions
+
+Get your agent's transaction history.
+
+```
+Parameters:
+- limit: Max transactions to return (1-200, default: 50)
+- offset: Number to skip for pagination (default: 0)
+```
+
+## Example Usage
+
+```typescript
+// Check balance
+await check_balance()
+// Returns: { balance_sats: 5000, message: "Current balance: 5000 sats" }
+
+// Create an invoice to receive 100 sats
+await create_invoice({ amount_sats: 100, memo: "Payment for code review" })
+// Returns: { bolt11: "lnbc1...", payment_hash: "abc123...", expires_at: "..." }
+
+// Check if the invoice was paid
+await get_invoice_status({ payment_hash: "abc123..." })
+// Returns: { paid: true, amount_sats: 100, settled_at: "...", preimage: "..." }
+
+// Pay someone else's invoice
+await pay_invoice({ bolt11: "lnbc500n1..." })
+// Returns: { preimage: "...", amount_sats: 500, fee_sats: 1, payment_hash: "..." }
+
+// Access a paid API
+await pay_l402_api({ url: "https://api.example.com/premium-data" })
+// Returns: { data: {...}, amount_paid: 21, payment_hash: "..." }
+```
+
+## Security
+
+- Your API key should be kept secret
+- Use environment variables, not hardcoded values
+- Each agent has its own isolated wallet
+- Operators can set spending limits per agent
+
+## Support
+
+- Documentation: https://lightningfaucet.com/ai-agents/docs/
+- Issues: https://github.com/lightningfaucet/mcp-server/issues
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * Lightning Faucet MCP Server
+ *
+ * Provides AI agents with Lightning Network payment capabilities via MCP.
+ *
+ * Configuration:
+ *   Set LIGHTNING_FAUCET_API_KEY environment variable with your agent API key.
+ *   Get an API key at: https://lightningfaucet.com/ai-agents/
+ *
+ * Usage with Claude Code:
+ *   Add to .claude/settings.json:
+ *   {
+ *     "mcpServers": {
+ *       "lightning-faucet": {
+ *         "command": "npx",
+ *         "args": ["@anthropic/lightning-faucet-mcp"],
+ *         "env": {
+ *           "LIGHTNING_FAUCET_API_KEY": "your-api-key-here"
+ *         }
+ *       }
+ *     }
+ *   }
+ */
+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":";AACA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/dist/index.js

@@ -0,0 +1,317 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Lightning Faucet MCP Server
+ *
+ * Provides AI agents with Lightning Network payment capabilities via MCP.
+ *
+ * Configuration:
+ *   Set LIGHTNING_FAUCET_API_KEY environment variable with your agent API key.
+ *   Get an API key at: https://lightningfaucet.com/ai-agents/
+ *
+ * Usage with Claude Code:
+ *   Add to .claude/settings.json:
+ *   {
+ *     "mcpServers": {
+ *       "lightning-faucet": {
+ *         "command": "npx",
+ *         "args": ["@anthropic/lightning-faucet-mcp"],
+ *         "env": {
+ *           "LIGHTNING_FAUCET_API_KEY": "your-api-key-here"
+ *         }
+ *       }
+ *     }
+ *   }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const zod_1 = require("zod");
+const lightning_faucet_js_1 = require("./lightning-faucet.js");
+// Get API key from environment
+const API_KEY = process.env.LIGHTNING_FAUCET_API_KEY;
+if (!API_KEY) {
+    console.error('Error: LIGHTNING_FAUCET_API_KEY environment variable is required');
+    console.error('Get your API key at: https://lightningfaucet.com/ai-agents/');
+    process.exit(1);
+}
+const client = new lightning_faucet_js_1.LightningFaucetClient(API_KEY);
+// Create MCP server
+const server = new index_js_1.Server({
+    name: 'lightning-faucet',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Tool schemas
+const CheckBalanceSchema = zod_1.z.object({});
+const PayL402ApiSchema = zod_1.z.object({
+    url: zod_1.z.string().describe('The URL to request'),
+    method: zod_1.z.enum(['GET', 'POST', 'PUT', 'DELETE']).default('GET').describe('HTTP method'),
+    body: zod_1.z.string().optional().describe('Request body for POST/PUT requests'),
+    max_payment_sats: zod_1.z.number().min(1).max(100000).default(1000)
+        .describe('Maximum amount in satoshis to pay for this request'),
+});
+const PayInvoiceSchema = zod_1.z.object({
+    bolt11: zod_1.z.string().describe('BOLT11 invoice string to pay (starts with lnbc...)'),
+    max_fee_sats: zod_1.z.number().min(0).optional()
+        .describe('Maximum routing fee in satoshis (default: 10% of invoice amount)'),
+});
+const CreateInvoiceSchema = zod_1.z.object({
+    amount_sats: zod_1.z.number().min(1).describe('Amount in satoshis to request'),
+    memo: zod_1.z.string().max(640).optional().describe('Description/memo for the invoice'),
+});
+const GetInvoiceStatusSchema = zod_1.z.object({
+    payment_hash: zod_1.z.string().describe('Payment hash of the invoice to check'),
+});
+const GetTransactionsSchema = zod_1.z.object({
+    limit: zod_1.z.number().min(1).max(200).default(50).describe('Max transactions to return'),
+    offset: zod_1.z.number().min(0).default(0).describe('Number to skip for pagination'),
+});
+// List available tools
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: 'check_balance',
+            description: "Check your agent's current Lightning balance in satoshis",
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+        },
+        {
+            name: 'pay_l402_api',
+            description: 'Make a request to an L402-protected API. If payment is required (HTTP 402), automatically pay the Lightning invoice and complete the request.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    url: { type: 'string', description: 'The URL to request' },
+                    method: {
+                        type: 'string',
+                        enum: ['GET', 'POST', 'PUT', 'DELETE'],
+                        default: 'GET',
+                        description: 'HTTP method',
+                    },
+                    body: { type: 'string', description: 'Request body for POST/PUT requests' },
+                    max_payment_sats: {
+                        type: 'integer',
+                        minimum: 1,
+                        maximum: 100000,
+                        default: 1000,
+                        description: 'Maximum amount in satoshis to pay for this request',
+                    },
+                },
+                required: ['url'],
+            },
+        },
+        {
+            name: 'pay_invoice',
+            description: 'Pay a BOLT11 Lightning invoice from the agent balance. Returns preimage as proof of payment.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    bolt11: { type: 'string', description: 'BOLT11 invoice string to pay (starts with lnbc...)' },
+                    max_fee_sats: {
+                        type: 'integer',
+                        minimum: 0,
+                        description: 'Maximum routing fee in satoshis',
+                    },
+                },
+                required: ['bolt11'],
+            },
+        },
+        {
+            name: 'create_invoice',
+            description: 'Create a Lightning invoice to receive payment. Use get_invoice_status to check if paid.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    amount_sats: { type: 'integer', minimum: 1, description: 'Amount in satoshis to request' },
+                    memo: { type: 'string', maxLength: 640, description: 'Description/memo for the invoice' },
+                },
+                required: ['amount_sats'],
+            },
+        },
+        {
+            name: 'get_invoice_status',
+            description: 'Check if a created invoice has been paid. Use the payment_hash from create_invoice.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    payment_hash: { type: 'string', description: 'Payment hash of the invoice to check' },
+                },
+                required: ['payment_hash'],
+            },
+        },
+        {
+            name: 'get_transactions',
+            description: 'Get the agent transaction history. Returns both incoming and outgoing payments.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    limit: { type: 'integer', minimum: 1, maximum: 200, default: 50, description: 'Max transactions to return' },
+                    offset: { type: 'integer', minimum: 0, default: 0, description: 'Number to skip for pagination' },
+                },
+                required: [],
+            },
+        },
+    ],
+}));
+// Handle tool calls
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'check_balance': {
+                CheckBalanceSchema.parse(args);
+                const result = await client.checkBalance();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                balance_sats: result.balanceSats,
+                                message: `Current balance: ${result.balanceSats} sats`,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'pay_l402_api': {
+                const parsed = PayL402ApiSchema.parse(args);
+                const result = await client.l402Pay(parsed.url, parsed.method, parsed.body, parsed.max_payment_sats);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                status_code: result.statusCode,
+                                data: result.data,
+                                payment_hash: result.paymentHash,
+                                amount_paid: result.amountPaid,
+                                fee: result.fee,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'pay_invoice': {
+                const parsed = PayInvoiceSchema.parse(args);
+                const result = await client.payInvoice(parsed.bolt11, parsed.max_fee_sats);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                message: 'Invoice paid successfully',
+                                preimage: result.preimage,
+                                amount_sats: result.amountSats,
+                                fee_sats: result.feeSats,
+                                payment_hash: result.paymentHash,
+                                new_balance: result.newBalance,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'create_invoice': {
+                const parsed = CreateInvoiceSchema.parse(args);
+                const result = await client.createInvoice(parsed.amount_sats, parsed.memo);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                message: `Invoice created for ${parsed.amount_sats} sats`,
+                                bolt11: result.bolt11,
+                                payment_hash: result.paymentHash,
+                                expires_at: result.expiresAt,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'get_invoice_status': {
+                const parsed = GetInvoiceStatusSchema.parse(args);
+                const result = await client.getInvoiceStatus(parsed.payment_hash);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                paid: result.paid,
+                                amount_sats: result.amountSats,
+                                settled_at: result.settledAt,
+                                preimage: result.preimage,
+                                expired: result.expired,
+                                new_balance: result.newBalance,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'get_transactions': {
+                const parsed = GetTransactionsSchema.parse(args);
+                const result = await client.getTransactions(parsed.limit, parsed.offset);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                transactions: result.transactions,
+                                total: result.total,
+                                has_more: result.hasMore,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ success: false, error: `Unknown tool: ${name}` }),
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: false,
+                        error: errorMessage,
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error('Lightning Faucet MCP server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lightning-faucet.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Lightning Faucet API Client
+ *
+ * Handles communication with the Lightning Faucet AI Agent Wallet API.
+ */
+interface ApiResponse {
+    success: boolean;
+    error?: string;
+}
+interface BalanceResponse extends ApiResponse {
+    balance_sats?: number;
+    balance?: number;
+}
+interface L402PayResponse extends ApiResponse {
+    data?: unknown;
+    body?: string;
+    status_code?: number;
+    payment_hash?: string;
+    amount_paid?: number;
+    fee?: number;
+}
+interface PayInvoiceResponse extends ApiResponse {
+    preimage?: string;
+    payment_preimage?: string;
+    amount_sats?: number;
+    amount_paid?: number;
+    fee_sats?: number;
+    fee?: number;
+    payment_hash?: string;
+    total_cost?: number;
+    new_balance?: number;
+}
+interface CreateInvoiceResponse extends ApiResponse {
+    bolt11?: string;
+    invoice?: string;
+    payment_request?: string;
+    payment_hash?: string;
+    amount_sats?: number;
+    memo?: string;
+    expires_at?: string;
+}
+interface InvoiceStatusResponse extends ApiResponse {
+    status?: string;
+    paid?: boolean;
+    settled?: boolean;
+    amount_sats?: number;
+    memo?: string;
+    expires_at?: string;
+    settled_at?: string;
+    preimage?: string;
+    expired?: boolean;
+    new_balance?: number;
+}
+interface Transaction {
+    type: string;
+    amount_sats: number;
+    fee_sats?: number;
+    memo?: string;
+    description?: string;
+    payment_hash?: string;
+    timestamp?: string;
+    created_at?: string;
+    settled_at?: string;
+    destination?: string;
+    balance_after?: number;
+}
+interface GetTransactionsResponse extends ApiResponse {
+    transactions?: Transaction[];
+    total?: number;
+    has_more?: boolean;
+}
+export declare class LightningFaucetClient {
+    private apiKey;
+    constructor(apiKey: string);
+    /**
+     * Make an API request to Lightning Faucet
+     */
+    private request;
+    /**
+     * Check the agent's current balance
+     */
+    checkBalance(): Promise<{
+        balanceSats: number;
+        rawResponse: BalanceResponse;
+    }>;
+    /**
+     * Pay an L402-protected API endpoint
+     */
+    l402Pay(url: string, method?: string, body?: string, maxPaymentSats?: number): Promise<{
+        data: unknown;
+        statusCode: number;
+        paymentHash?: string;
+        amountPaid?: number;
+        fee?: number;
+        rawResponse: L402PayResponse;
+    }>;
+    /**
+     * Pay a BOLT11 Lightning invoice
+     */
+    payInvoice(bolt11: string, maxFeeSats?: number): Promise<{
+        preimage: string;
+        amountSats: number;
+        feeSats: number;
+        paymentHash: string;
+        newBalance: number;
+        rawResponse: PayInvoiceResponse;
+    }>;
+    /**
+     * Create a Lightning invoice to receive payment
+     */
+    createInvoice(amountSats: number, memo?: string): Promise<{
+        bolt11: string;
+        paymentHash: string;
+        expiresAt: string;
+        rawResponse: CreateInvoiceResponse;
+    }>;
+    /**
+     * Check if an invoice has been paid
+     */
+    getInvoiceStatus(paymentHash: string): Promise<{
+        paid: boolean;
+        amountSats: number;
+        settledAt?: string;
+        preimage?: string;
+        expired: boolean;
+        newBalance?: number;
+        rawResponse: InvoiceStatusResponse;
+    }>;
+    /**
+     * Get transaction history
+     */
+    getTransactions(limit?: number, offset?: number): Promise<{
+        transactions: Array<{
+            type: 'incoming' | 'outgoing';
+            amountSats: number;
+            feeSats?: number;
+            memo?: string;
+            paymentHash?: string;
+            timestamp?: string;
+            balanceAfter?: number;
+        }>;
+        total: number;
+        hasMore: boolean;
+        rawResponse: GetTransactionsResponse;
+    }>;
+}
+export {};
+//# sourceMappingURL=lightning-faucet.d.ts.map

package/dist/lightning-faucet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightning-faucet.d.ts","sourceRoot":"","sources":["../src/lightning-faucet.ts"],"names":[],"mappings":"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"}

package/dist/lightning-faucet.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * Lightning Faucet API Client
+ *
+ * Handles communication with the Lightning Faucet AI Agent Wallet API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LightningFaucetClient = void 0;
+const API_BASE_URL = 'https://lightningfaucet.com/ai-agents/api.php';
+class LightningFaucetClient {
+    apiKey;
+    constructor(apiKey) {
+        if (!apiKey) {
+            throw new Error('API key is required');
+        }
+        this.apiKey = apiKey;
+    }
+    /**
+     * Make an API request to Lightning Faucet
+     */
+    async request(action, data = {}) {
+        const payload = {
+            action,
+            api_key: this.apiKey,
+            ...data,
+        };
+        const response = await fetch(API_BASE_URL, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP error: ${response.status} ${response.statusText}`);
+        }
+        const result = await response.json();
+        if (!result.success) {
+            throw new Error(result.error || 'Unknown API error');
+        }
+        return result;
+    }
+    /**
+     * Check the agent's current balance
+     */
+    async checkBalance() {
+        const result = await this.request('get_balance');
+        return {
+            balanceSats: result.balance_sats || result.balance || 0,
+            rawResponse: result,
+        };
+    }
+    /**
+     * Pay an L402-protected API endpoint
+     */
+    async l402Pay(url, method = 'GET', body, maxPaymentSats = 1000) {
+        const requestData = {
+            url,
+            method: method.toUpperCase(),
+            max_payment_sats: maxPaymentSats,
+        };
+        if (body) {
+            requestData.body = body;
+        }
+        const result = await this.request('l402_pay', requestData);
+        let responseData;
+        if (result.body) {
+            try {
+                responseData = JSON.parse(result.body);
+            }
+            catch {
+                responseData = result.body;
+            }
+        }
+        else {
+            responseData = result.data;
+        }
+        return {
+            data: responseData,
+            statusCode: result.status_code || 200,
+            paymentHash: result.payment_hash,
+            amountPaid: result.amount_paid,
+            fee: result.fee,
+            rawResponse: result,
+        };
+    }
+    /**
+     * Pay a BOLT11 Lightning invoice
+     */
+    async payInvoice(bolt11, maxFeeSats) {
+        const data = {
+            invoice: bolt11,
+        };
+        if (maxFeeSats !== undefined) {
+            data.max_fee_sats = maxFeeSats;
+        }
+        const result = await this.request('pay_invoice', data);
+        return {
+            preimage: result.preimage || result.payment_preimage || '',
+            amountSats: result.amount_sats || result.amount_paid || 0,
+            feeSats: result.fee_sats || result.fee || 0,
+            paymentHash: result.payment_hash || '',
+            newBalance: result.new_balance || 0,
+            rawResponse: result,
+        };
+    }
+    /**
+     * Create a Lightning invoice to receive payment
+     */
+    async createInvoice(amountSats, memo) {
+        const data = {
+            amount_sats: amountSats,
+        };
+        if (memo) {
+            data.memo = memo;
+        }
+        const result = await this.request('create_invoice', data);
+        const bolt11 = result.bolt11 || result.invoice || result.payment_request;
+        if (!bolt11) {
+            throw new Error('No invoice returned from API');
+        }
+        return {
+            bolt11,
+            paymentHash: result.payment_hash || '',
+            expiresAt: result.expires_at || '',
+            rawResponse: result,
+        };
+    }
+    /**
+     * Check if an invoice has been paid
+     */
+    async getInvoiceStatus(paymentHash) {
+        const result = await this.request('get_invoice_status', {
+            payment_hash: paymentHash,
+        });
+        const paid = result.paid || result.settled || result.status === 'settled';
+        return {
+            paid,
+            amountSats: result.amount_sats || 0,
+            settledAt: result.settled_at,
+            preimage: result.preimage,
+            expired: result.expired || false,
+            newBalance: result.new_balance,
+            rawResponse: result,
+        };
+    }
+    /**
+     * Get transaction history
+     */
+    async getTransactions(limit = 50, offset = 0) {
+        const result = await this.request('get_transactions', {
+            limit,
+            offset,
+        });
+        const transactions = (result.transactions || []).map(tx => ({
+            type: (tx.type === 'deposit' || tx.type === 'incoming' || tx.amount_sats > 0
+                ? 'incoming' : 'outgoing'),
+            amountSats: Math.abs(tx.amount_sats),
+            feeSats: tx.fee_sats,
+            memo: tx.memo || tx.description,
+            paymentHash: tx.payment_hash,
+            timestamp: tx.timestamp || tx.created_at || tx.settled_at,
+            balanceAfter: tx.balance_after,
+        }));
+        return {
+            transactions,
+            total: result.total || transactions.length,
+            hasMore: result.has_more || false,
+            rawResponse: result,
+        };
+    }
+}
+exports.LightningFaucetClient = LightningFaucetClient;
+//# sourceMappingURL=lightning-faucet.js.map

package/dist/lightning-faucet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightning-faucet.js","sourceRoot":"","sources":["../src/lightning-faucet.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "lightning-faucet-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Lightning Faucet AI Agent Wallet - enables AI agents to send and receive Bitcoin via Lightning Network",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "lightning-faucet-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "lightning",
+    "bitcoin",
+    "ai-agent",
+    "l402",
+    "payments"
+  ],
+  "author": "Lightning Faucet",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lightningfaucet/mcp-server"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}