@guiie/buda-mcp 1.4.2 → 1.5.1

package/dist/tools/deposits.d.ts

@@ -0,0 +1,83 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+export declare const getDepositHistoryToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            currency: {
+                type: string;
+                description: string;
+            };
+            state: {
+                type: string;
+                description: string;
+            };
+            per: {
+                type: string;
+                description: string;
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+type GetDepositHistoryArgs = {
+    currency: string;
+    state?: "pending_info" | "pending" | "confirmed" | "anulled" | "retained";
+    per?: number;
+    page?: number;
+};
+export declare function handleGetDepositHistory(args: GetDepositHistoryArgs, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const createFiatDepositToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            currency: {
+                type: string;
+                description: string;
+            };
+            amount: {
+                type: string;
+                description: string;
+            };
+            bank: {
+                type: string;
+                description: string;
+            };
+            confirmation_token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+type CreateFiatDepositArgs = {
+    currency: string;
+    amount: number;
+    bank?: string;
+    confirmation_token: string;
+};
+export declare function handleCreateFiatDeposit(args: CreateFiatDepositArgs, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function register(server: McpServer, client: BudaClient): void;
+export {};
+//# sourceMappingURL=deposits.d.ts.map

package/dist/tools/deposits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deposits.d.ts","sourceRoot":"","sources":["../../src/tools/deposits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAKxD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;CA6BvC,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAoBF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA+ChF;AAED,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;CAoBvC,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAmDhF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA6BpE"}

package/dist/tools/deposits.js

@@ -0,0 +1,174 @@
+import { z } from "zod";
+import { BudaApiError } from "../client.js";
+import { validateCurrency } from "../validation.js";
+import { flattenAmount } from "../utils.js";
+export const getDepositHistoryToolSchema = {
+    name: "get_deposit_history",
+    description: "Returns deposit history for a currency on the authenticated Buda.com account. " +
+        "Supports state filtering and pagination. All amounts are floats with separate _currency fields. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET. " +
+        "Example: 'Show my last 10 BTC deposits.'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            currency: {
+                type: "string",
+                description: "Currency code (e.g. 'BTC', 'CLP').",
+            },
+            state: {
+                type: "string",
+                description: "Filter by state: 'pending_info', 'pending', 'confirmed', 'anulled', 'retained'.",
+            },
+            per: {
+                type: "number",
+                description: "Results per page (default: 20, max: 300).",
+            },
+            page: {
+                type: "number",
+                description: "Page number (default: 1).",
+            },
+        },
+        required: ["currency"],
+    },
+};
+function normalizeDeposit(d) {
+    const amount = flattenAmount(d.amount);
+    const fee = flattenAmount(d.fee);
+    return {
+        id: d.id,
+        state: d.state,
+        currency: d.currency,
+        amount: amount.value,
+        amount_currency: amount.currency,
+        fee: fee.value,
+        fee_currency: fee.currency,
+        created_at: d.created_at,
+        updated_at: d.updated_at,
+        transfer_account_id: d.transfer_account_id,
+        transaction_hash: d.transaction_hash,
+    };
+}
+export async function handleGetDepositHistory(args, client) {
+    const { currency, state, per, page } = args;
+    const validationError = validateCurrency(currency);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_CURRENCY" }) }],
+            isError: true,
+        };
+    }
+    try {
+        const params = {};
+        if (state)
+            params.state = state;
+        if (per !== undefined)
+            params.per = per;
+        if (page !== undefined)
+            params.page = page;
+        const data = await client.get(`/currencies/${currency.toUpperCase()}/deposits`, Object.keys(params).length > 0 ? params : undefined);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        deposits: data.deposits.map(normalizeDeposit),
+                        meta: data.meta,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof BudaApiError
+            ? { error: err.message, code: err.status, path: err.path }
+            : { error: String(err), code: "UNKNOWN" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(msg) }],
+            isError: true,
+        };
+    }
+}
+export const createFiatDepositToolSchema = {
+    name: "create_fiat_deposit",
+    description: "Record a fiat deposit on Buda.com. " +
+        "IMPORTANT: Calling this twice creates duplicate records — the confirmation guard is critical. " +
+        "Pass confirmation_token='CONFIRM' to execute. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            currency: { type: "string", description: "Fiat currency code (e.g. 'CLP', 'COP', 'PEN')." },
+            amount: { type: "number", description: "Deposit amount." },
+            bank: { type: "string", description: "Bank name or identifier for the deposit source." },
+            confirmation_token: {
+                type: "string",
+                description: "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute.",
+            },
+        },
+        required: ["currency", "amount", "confirmation_token"],
+    },
+};
+export async function handleCreateFiatDeposit(args, client) {
+    const { currency, amount, bank, confirmation_token } = args;
+    if (confirmation_token !== "CONFIRM") {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "Deposit not created. confirmation_token must equal 'CONFIRM' to execute. " +
+                            "Review the details and set confirmation_token='CONFIRM' to proceed.",
+                        code: "CONFIRMATION_REQUIRED",
+                        preview: { currency, amount, bank },
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const validationError = validateCurrency(currency);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_CURRENCY" }) }],
+            isError: true,
+        };
+    }
+    try {
+        const payload = { amount: String(amount) };
+        if (bank)
+            payload.bank = bank;
+        const data = await client.post(`/currencies/${currency.toUpperCase()}/deposits`, payload);
+        return {
+            content: [{ type: "text", text: JSON.stringify(normalizeDeposit(data.deposit), null, 2) }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof BudaApiError
+            ? { error: err.message, code: err.status, path: err.path }
+            : { error: String(err), code: "UNKNOWN" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(msg) }],
+            isError: true,
+        };
+    }
+}
+export function register(server, client) {
+    server.tool(getDepositHistoryToolSchema.name, getDepositHistoryToolSchema.description, {
+        currency: z.string().min(2).max(10).describe("Currency code (e.g. 'BTC', 'CLP')."),
+        state: z
+            .enum(["pending_info", "pending", "confirmed", "anulled", "retained"])
+            .optional()
+            .describe("Filter by state."),
+        per: z.number().int().min(1).max(300).optional().describe("Results per page (default: 20, max: 300)."),
+        page: z.number().int().min(1).optional().describe("Page number (default: 1)."),
+    }, (args) => handleGetDepositHistory(args, client));
+    server.tool(createFiatDepositToolSchema.name, createFiatDepositToolSchema.description, {
+        currency: z.string().min(2).max(10).describe("Fiat currency code (e.g. 'CLP', 'COP', 'PEN')."),
+        amount: z.number().positive().describe("Deposit amount."),
+        bank: z.string().optional().describe("Bank name or identifier for the deposit source."),
+        confirmation_token: z
+            .string()
+            .describe("Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute."),
+    }, (args) => handleCreateFiatDeposit(args, client));
+}
+//# sourceMappingURL=deposits.js.map

package/dist/tools/fees.d.ts

@@ -0,0 +1,34 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            currency: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+type GetNetworkFeesArgs = {
+    currency: string;
+    type: "deposit" | "withdrawal";
+};
+export declare function handleGetNetworkFees(args: GetNetworkFeesArgs, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function register(server: McpServer, client: BudaClient): void;
+export {};
+//# sourceMappingURL=fees.d.ts.map

package/dist/tools/fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fees.d.ts","sourceRoot":"","sources":["../../src/tools/fees.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAKxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;CAqBtB,CAAC;AAEF,KAAK,kBAAkB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,YAAY,CAAA;CAAE,CAAC;AAE/E,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA2ChF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAUpE"}

package/dist/tools/fees.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { BudaApiError } from "../client.js";
+import { validateCurrency } from "../validation.js";
+import { flattenAmount } from "../utils.js";
+export const toolSchema = {
+    name: "get_network_fees",
+    description: "Returns the deposit or withdrawal network fee schedule for a currency on Buda.com. " +
+        "Useful before initiating a transfer to preview costs. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET. " +
+        "Example: 'What are the withdrawal fees for BTC?'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            currency: {
+                type: "string",
+                description: "Currency code (e.g. 'BTC', 'ETH', 'CLP').",
+            },
+            type: {
+                type: "string",
+                description: "Fee direction: 'deposit' or 'withdrawal'.",
+            },
+        },
+        required: ["currency", "type"],
+    },
+};
+export async function handleGetNetworkFees(args, client) {
+    const { currency, type } = args;
+    const validationError = validateCurrency(currency);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_CURRENCY" }) }],
+            isError: true,
+        };
+    }
+    try {
+        const data = await client.get(`/currencies/${currency.toUpperCase()}/fees/${type}`);
+        const fees = data.fees.map((f) => {
+            const baseFee = flattenAmount(f.base_fee);
+            return {
+                name: f.name,
+                fee_type: f.fee_type,
+                base_fee: baseFee.value,
+                base_fee_currency: baseFee.currency,
+                percent: f.percent !== null ? parseFloat(f.percent) : null,
+            };
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ currency: currency.toUpperCase(), type, fees }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof BudaApiError
+            ? { error: err.message, code: err.status, path: err.path }
+            : { error: String(err), code: "UNKNOWN" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(msg) }],
+            isError: true,
+        };
+    }
+}
+export function register(server, client) {
+    server.tool(toolSchema.name, toolSchema.description, {
+        currency: z.string().min(2).max(10).describe("Currency code (e.g. 'BTC', 'ETH', 'CLP')."),
+        type: z.enum(["deposit", "withdrawal"]).describe("Fee direction: 'deposit' or 'withdrawal'."),
+    }, (args) => handleGetNetworkFees(args, client));
+}
+//# sourceMappingURL=fees.js.map

package/dist/tools/lightning.d.ts

@@ -0,0 +1,68 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+export declare const lightningWithdrawalToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            invoice: {
+                type: string;
+                description: string;
+            };
+            confirmation_token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const createLightningInvoiceToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            amount_satoshis: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            expiry_seconds: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+type LightningWithdrawalArgs = {
+    invoice: string;
+    confirmation_token: string;
+};
+type CreateLightningInvoiceArgs = {
+    amount_satoshis: number;
+    description?: string;
+    expiry_seconds?: number;
+};
+export declare function handleLightningWithdrawal(args: LightningWithdrawalArgs, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function handleCreateLightningInvoice(args: CreateLightningInvoiceArgs, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function register(server: McpServer, client: BudaClient): void;
+export {};
+//# sourceMappingURL=lightning.d.ts.map

package/dist/tools/lightning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightning.d.ts","sourceRoot":"","sources":["../../src/tools/lightning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAIxD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;CAuBzC,CAAC;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;CAwB5C,CAAC;AAEF,KAAK,uBAAuB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,EAC7B,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA+EhF;AAED,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,0BAA0B,EAChC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA8ChF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA2CpE"}

package/dist/tools/lightning.js

@@ -0,0 +1,185 @@
+import { z } from "zod";
+import { BudaApiError } from "../client.js";
+import { flattenAmount } from "../utils.js";
+export const lightningWithdrawalToolSchema = {
+    name: "lightning_withdrawal",
+    description: "Pay a Bitcoin Lightning Network invoice from your Buda.com LN-BTC reserve. " +
+        "IMPORTANT: Funds leave the account immediately on success. " +
+        "Pass confirmation_token='CONFIRM' to execute. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            invoice: {
+                type: "string",
+                description: "BOLT-11 Lightning invoice string (starts with 'lnbc', 'lntb', etc.).",
+            },
+            confirmation_token: {
+                type: "string",
+                description: "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute. " +
+                    "Any other value will reject the request without paying.",
+            },
+        },
+        required: ["invoice", "confirmation_token"],
+    },
+};
+export const createLightningInvoiceToolSchema = {
+    name: "create_lightning_invoice",
+    description: "Create a Bitcoin Lightning Network invoice on Buda.com to receive a payment. " +
+        "No funds leave the account — no confirmation required. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            amount_satoshis: {
+                type: "number",
+                description: "Invoice amount in satoshis (positive integer).",
+            },
+            description: {
+                type: "string",
+                description: "Optional payment description (max 140 characters).",
+            },
+            expiry_seconds: {
+                type: "number",
+                description: "Invoice expiry in seconds (60–86400, default: 3600).",
+            },
+        },
+        required: ["amount_satoshis"],
+    },
+};
+export async function handleLightningWithdrawal(args, client) {
+    const { invoice, confirmation_token } = args;
+    if (confirmation_token !== "CONFIRM") {
+        const preview = invoice.length > 20 ? invoice.substring(0, 20) + "..." : invoice;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "Lightning withdrawal not executed. confirmation_token must equal 'CONFIRM' to execute. " +
+                            "Review the invoice and set confirmation_token='CONFIRM' to proceed.",
+                        code: "CONFIRMATION_REQUIRED",
+                        preview: { invoice_preview: preview },
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const BOLT11_RE = /^ln(bc|tb|bcrt)\d/i;
+    if (!BOLT11_RE.test(invoice)) {
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "Invalid Lightning invoice format. " +
+                            "Expected a BOLT-11 string starting with 'lnbc', 'lntb', or 'lnbcrt'.",
+                        code: "INVALID_INVOICE",
+                    }),
+                }],
+            isError: true,
+        };
+    }
+    try {
+        const data = await client.post(`/reserves/ln-btc/withdrawals`, { invoice });
+        const lw = data.lightning_withdrawal;
+        const amount = flattenAmount(lw.amount);
+        const fee = flattenAmount(lw.fee);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: lw.id,
+                        state: lw.state,
+                        amount: amount.value,
+                        amount_currency: amount.currency,
+                        fee: fee.value,
+                        fee_currency: fee.currency,
+                        payment_hash: lw.payment_hash,
+                        created_at: lw.created_at,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof BudaApiError
+            ? { error: err.message, code: err.status, path: err.path }
+            : { error: String(err), code: "UNKNOWN" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(msg) }],
+            isError: true,
+        };
+    }
+}
+export async function handleCreateLightningInvoice(args, client) {
+    const { amount_satoshis, description, expiry_seconds } = args;
+    try {
+        const invoicePayload = { amount: amount_satoshis };
+        if (description !== undefined)
+            invoicePayload.description = description;
+        if (expiry_seconds !== undefined)
+            invoicePayload.expiry = expiry_seconds;
+        const data = await client.post(`/lightning_network_invoices`, { lightning_network_invoice: invoicePayload });
+        const inv = data.lightning_network_invoice;
+        const amount = flattenAmount(inv.amount);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: inv.id,
+                        payment_request: inv.payment_request,
+                        amount_satoshis: amount.value,
+                        description: inv.description,
+                        expires_at: inv.expires_at,
+                        state: inv.state,
+                        created_at: inv.created_at,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof BudaApiError
+            ? { error: err.message, code: err.status, path: err.path }
+            : { error: String(err), code: "UNKNOWN" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(msg) }],
+            isError: true,
+        };
+    }
+}
+export function register(server, client) {
+    server.tool(lightningWithdrawalToolSchema.name, lightningWithdrawalToolSchema.description, {
+        invoice: z
+            .string()
+            .min(50)
+            .describe("BOLT-11 Lightning invoice string (starts with 'lnbc', 'lntb', etc.)."),
+        confirmation_token: z
+            .string()
+            .describe("Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute. " +
+            "Any other value will reject the request without paying."),
+    }, (args) => handleLightningWithdrawal(args, client));
+    server.tool(createLightningInvoiceToolSchema.name, createLightningInvoiceToolSchema.description, {
+        amount_satoshis: z
+            .number()
+            .int()
+            .positive()
+            .describe("Invoice amount in satoshis (positive integer)."),
+        description: z
+            .string()
+            .max(140)
+            .optional()
+            .describe("Optional payment description (max 140 characters)."),
+        expiry_seconds: z
+            .number()
+            .int()
+            .min(60)
+            .max(86400)
+            .optional()
+            .describe("Invoice expiry in seconds (60–86400, default: 3600)."),
+    }, (args) => handleCreateLightningInvoice(args, client));
+}
+//# sourceMappingURL=lightning.js.map

package/dist/tools/order_lookup.d.ts

@@ -0,0 +1,50 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+export declare const getOrderToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            order_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const getOrderByClientIdToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            client_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleGetOrder(args: {
+    order_id: number;
+}, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function handleGetOrderByClientId(args: {
+    client_id: string;
+}, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function register(server: McpServer, client: BudaClient): void;
+//# sourceMappingURL=order_lookup.d.ts.map

package/dist/tools/order_lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order_lookup.d.ts","sourceRoot":"","sources":["../../src/tools/order_lookup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAIxD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;CAkB9B,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;CAiBxC,CAAC;AAmCF,wBAAsB,cAAc,CAClC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC1B,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAgBhF;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3B,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAgBhF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAkBpE"}