liqpay-mcp-server 1.0.0

package/dist/tools/payments.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+export function registerPaymentTools(server, client) {
+    server.registerTool("liqpay_create_checkout_url", {
+        title: "Create LiqPay Checkout URL",
+        description: "Generate a hosted checkout URL for a LiqPay payment (PCI DSS safe). " +
+            "Use when initiating a payment without handling card data directly. " +
+            "Do not use for server-to-server card charges — use liqpay_create_hold instead. " +
+            "Returns { checkout_url: string }.",
+        inputSchema: {
+            amount: z.number().positive().describe("Payment amount in currency units (e.g. 99.99 for ₴99.99)"),
+            currency: z.enum(["UAH", "USD", "EUR"]).describe("ISO 4217 currency code"),
+            description: z.string().min(1).max(500).describe("Payment description shown to payer (max 500 chars, e.g. 'Order #42 — iPhone case')"),
+            order_id: z.string().min(1).describe("Unique order ID in your system (e.g. 'order-2026-001')"),
+            result_url: z.string().url().optional().describe("Redirect URL after payment completion"),
+            server_url: z.string().url().optional().describe("Webhook URL for server-to-server notification"),
+            language: z.enum(["uk", "en"]).default("uk").describe("Payment page language"),
+        },
+        outputSchema: {
+            checkout_url: z.string().describe("Direct link to LiqPay hosted payment page"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ amount, currency, description, order_id, result_url, server_url, language }) => {
+        const params = {
+            action: "pay",
+            amount,
+            currency,
+            description,
+            order_id,
+            language,
+        };
+        if (result_url)
+            params["result_url"] = result_url;
+        if (server_url)
+            params["server_url"] = server_url;
+        const checkout_url = client.buildCheckoutUrl(params);
+        const output = { checkout_url };
+        return {
+            content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+            structuredContent: output,
+        };
+    });
+    server.registerTool("liqpay_get_payment_status", {
+        title: "Get LiqPay Payment Status",
+        description: "Fetch the current status of a payment by order ID (action: status). " +
+            "Use when checking whether a payment succeeded, failed, or is still pending. " +
+            "Do not use to list multiple payments — use liqpay_get_payments_list instead. " +
+            "Returns { status, payment_id, amount, currency, description, create_date, end_date, transaction_id }.",
+        inputSchema: {
+            order_id: z.string().min(1).describe("Order ID used when creating the payment (e.g. 'order-2026-001')"),
+        },
+        outputSchema: {
+            status: z.string().describe("Payment status (e.g. success, failure, processing)"),
+            payment_id: z.number().describe("LiqPay internal payment ID"),
+            amount: z.number().describe("Payment amount"),
+            currency: z.string().describe("ISO 4217 currency code"),
+            description: z.string().optional().describe("Payment description"),
+            create_date: z.number().optional().describe("Payment creation timestamp (ms)"),
+            end_date: z.number().optional().describe("Payment completion timestamp (ms)"),
+            transaction_id: z.number().optional().describe("Bank transaction ID"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ order_id }) => {
+        try {
+            const result = await client.request({ action: "status", order_id });
+            const output = {
+                status: result.status,
+                payment_id: result.payment_id,
+                amount: result.amount,
+                currency: result.currency,
+                description: result.description,
+                create_date: result.create_date,
+                end_date: result.end_date,
+                transaction_id: result.transaction_id,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=payments.js.map

package/dist/tools/payments.js.map

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

package/dist/tools/payouts.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LiqPayClient } from "../client.js";
+export declare function registerPayoutTools(server: McpServer, client: LiqPayClient): void;

package/dist/tools/payouts.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+export function registerPayoutTools(server, client) {
+    server.registerTool("liqpay_create_payout", {
+        title: "Create LiqPay Payout",
+        description: "Send money directly to a card — P2P transfer (action: p2p). " +
+            "Use when the merchant needs to pay out funds to a recipient's card. " +
+            "Do not use without payout feature enabled on the merchant account. " +
+            "Returns { payment_id, status, amount, currency }.",
+        inputSchema: {
+            amount: z.number().positive().describe("Payout amount in currency units (e.g. 500.00)"),
+            currency: z.enum(["UAH", "USD", "EUR"]).describe("ISO 4217 currency code"),
+            description: z.string().min(1).max(500).describe("Purpose of payout (e.g. 'Salary payout — May 2026')"),
+            order_id: z.string().min(1).describe("Unique payout ID (e.g. 'payout-2026-001')"),
+            card: z.string().regex(/^\d{16}$/).describe("Recipient card number — exactly 16 digits (e.g. '5168742060221193')"),
+        },
+        outputSchema: {
+            payment_id: z.number().describe("LiqPay internal payment ID"),
+            status: z.string().describe("Payout status (e.g. success, processing)"),
+            amount: z.number().describe("Payout amount"),
+            currency: z.string().describe("ISO 4217 currency code"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ amount, currency, description, order_id, card }) => {
+        try {
+            const result = await client.request({
+                action: "p2p",
+                amount,
+                currency,
+                description,
+                order_id,
+                card,
+            });
+            const output = {
+                payment_id: result.payment_id,
+                status: result.status,
+                amount: result.amount,
+                currency: result.currency,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=payouts.js.map

package/dist/tools/payouts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payouts.js","sourceRoot":"","sources":["../../src/tools/payouts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAoB;IACzE,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,8DAA8D;YAC9D,sEAAsE;YACtE,qEAAqE;YACrE,mDAAmD;QACrD,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;YACvF,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YAC1E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,qDAAqD,CAAC;YACvG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACjF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,qEAAqE,CAAC;SACnH;QACD,YAAY,EAAE;YACZ,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAC7D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;YACvE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YAC5C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SACxD;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;QAC1D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAiB;gBAClD,MAAM,EAAE,KAAK;gBACb,MAAM;gBACN,QAAQ;gBACR,WAAW;gBACX,QAAQ;gBACR,IAAI;aACL,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG;gBACb,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC3E,iBAAiB,EAAE,MAAM;aAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/refunds.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LiqPayClient } from "../client.js";
+export declare function registerRefundTools(server: McpServer, client: LiqPayClient): void;

package/dist/tools/refunds.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+export function registerRefundTools(server, client) {
+    server.registerTool("liqpay_create_refund", {
+        title: "Create LiqPay Refund",
+        description: "Refund a completed payment — full or partial (action: refund). " +
+            "Use when a customer requests a return or when a charge was made in error. " +
+            "Do not use on holds — cancel the hold with liqpay_cancel_hold instead. " +
+            "Returns { payment_id, status, amount }.",
+        inputSchema: {
+            order_id: z.string().min(1).describe("Order ID of the original payment to refund (e.g. 'order-2026-001')"),
+            amount: z.number().positive().optional().describe("Amount to refund in currency units (e.g. 50.00); omit for full refund"),
+        },
+        outputSchema: {
+            payment_id: z.number().describe("LiqPay internal payment ID"),
+            status: z.string().describe("Refund status (e.g. reversed, processing)"),
+            amount: z.number().optional().describe("Refunded amount"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ order_id, amount }) => {
+        try {
+            const params = { action: "refund", order_id };
+            if (amount !== undefined)
+                params["amount"] = amount;
+            const result = await client.request(params);
+            const output = {
+                payment_id: result.payment_id,
+                status: result.status,
+                amount: result.amount,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=refunds.js.map

package/dist/tools/refunds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refunds.js","sourceRoot":"","sources":["../../src/tools/refunds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAoB;IACzE,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,iEAAiE;YACjE,4EAA4E;YAC5E,yEAAyE;YACzE,yCAAyC;QAC3C,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oEAAoE,CAAC;YAC1G,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;SAC3H;QACD,YAAY,EAAE;YACZ,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAC7D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACxE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;SAC1D;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAA4B,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;YACvE,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;YAEpD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAiB,MAAM,CAAC,CAAC;YAE5D,MAAM,MAAM,GAAG;gBACb,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC3E,iBAAiB,EAAE,MAAM;aAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/reports.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LiqPayClient } from "../client.js";
+export declare function registerReportTools(server: McpServer, client: LiqPayClient): void;

package/dist/tools/reports.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { CHARACTER_LIMIT } from "../constants.js";
+export function registerReportTools(server, client) {
+    server.registerTool("liqpay_get_payments_list", {
+        title: "Get LiqPay Payments List",
+        description: "Retrieve a list of payments filtered by date range (action: reports). " +
+            "Use when reviewing transaction history for a specific period (max 31 days). " +
+            "Do not use for a single payment — use liqpay_get_payment_status instead. " +
+            "Returns { count, data: Payment[] }.",
+        inputSchema: {
+            date_from: z.number().int().positive().describe("Start of date range as Unix timestamp in ms (e.g. 1716768000000)"),
+            date_to: z.number().int().positive().describe("End of date range as Unix timestamp in ms (max 31 days from date_from)"),
+            status: z.string().optional().describe("Filter by payment status (e.g. 'success', 'failure', 'reversed')"),
+        },
+        outputSchema: {
+            count: z.number().describe("Total number of payments in the result"),
+            data: z.array(z.record(z.unknown())).describe("Array of payment records"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ date_from, date_to, status }) => {
+        try {
+            const params = { action: "reports", date_from, date_to };
+            if (status)
+                params["status"] = status;
+            const result = await client.request(params);
+            const output = {
+                count: result.count ?? result.data?.length ?? 0,
+                data: result.data ?? [],
+            };
+            let text = JSON.stringify(output, null, 2);
+            if (text.length > CHARACTER_LIMIT) {
+                const truncated = output.data.slice(0, Math.ceil(output.data.length / 2));
+                const truncatedOutput = { count: output.count, data: truncated, truncated: true, truncation_message: `Response truncated from ${output.data.length} to ${truncated.length} records. Narrow the date range or add a status filter.` };
+                text = JSON.stringify(truncatedOutput, null, 2);
+                return {
+                    content: [{ type: "text", text }],
+                    structuredContent: truncatedOutput,
+                };
+            }
+            return {
+                content: [{ type: "text", text }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=reports.js.map

package/dist/tools/reports.js.map

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

package/dist/tools/subscriptions.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LiqPayClient } from "../client.js";
+export declare function registerSubscriptionTools(server: McpServer, client: LiqPayClient): void;

package/dist/tools/subscriptions.js

@@ -0,0 +1,84 @@
+import { z } from "zod";
+export function registerSubscriptionTools(server, client) {
+    server.registerTool("liqpay_create_subscription", {
+        title: "Create LiqPay Subscription",
+        description: "Create a recurring payment subscription via hosted checkout page (action: subscribe). " +
+            "Use when setting up periodic charges (daily, weekly, monthly, yearly). " +
+            "Do not use for one-time payments — use liqpay_create_checkout_url instead. " +
+            "Returns { checkout_url: string }.",
+        inputSchema: {
+            amount: z.number().positive().describe("Amount per billing cycle in currency units (e.g. 299.00)"),
+            currency: z.enum(["UAH", "USD", "EUR"]).describe("ISO 4217 currency code"),
+            description: z.string().min(1).max(500).describe("Subscription description (max 500 chars, e.g. 'Monthly Pro plan')"),
+            order_id: z.string().min(1).describe("Unique subscription ID (e.g. 'sub-2026-001')"),
+            subscribe_date_start: z.string().regex(/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/).describe("First charge date in 'YYYY-MM-DD HH:mm:ss' format (e.g. '2026-06-01 00:00:00')"),
+            subscribe_periodicity: z.enum(["day", "week", "month", "year"]).describe("Billing cycle interval"),
+            result_url: z.string().url().optional().describe("Redirect URL after subscription setup"),
+            server_url: z.string().url().optional().describe("Webhook URL for recurring charge notifications"),
+        },
+        outputSchema: {
+            checkout_url: z.string().describe("Checkout page URL for the subscriber to enter card details"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ amount, currency, description, order_id, subscribe_date_start, subscribe_periodicity, result_url, server_url }) => {
+        const params = {
+            action: "subscribe",
+            amount,
+            currency,
+            description,
+            order_id,
+            subscribe_date_start,
+            subscribe_periodicity,
+        };
+        if (result_url)
+            params["result_url"] = result_url;
+        if (server_url)
+            params["server_url"] = server_url;
+        const checkout_url = client.buildCheckoutUrl(params);
+        const output = { checkout_url };
+        return {
+            content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+            structuredContent: output,
+        };
+    });
+    server.registerTool("liqpay_cancel_subscription", {
+        title: "Cancel LiqPay Subscription",
+        description: "Cancel an active recurring subscription (action: unsubscribe). " +
+            "Use when a subscriber wants to stop recurring charges. " +
+            "Do not use if the subscription is already inactive — check status first with liqpay_get_payment_status. " +
+            "Returns { status: string }.",
+        inputSchema: {
+            order_id: z.string().min(1).describe("Subscription order ID (e.g. 'sub-2026-001')"),
+        },
+        outputSchema: {
+            status: z.string().describe("Cancellation result (e.g. unsubscribed, error)"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ order_id }) => {
+        try {
+            const result = await client.request({ action: "unsubscribe", order_id });
+            const output = { status: result.status };
+            return {
+                content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=subscriptions.js.map

package/dist/tools/subscriptions.js.map

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

package/dist/tools/webhooks.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerWebhookTools(server: McpServer, privateKey: string): void;

package/dist/tools/webhooks.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { createSignature, decodeData } from "../auth.js";
+export function registerWebhookTools(server, privateKey) {
+    server.registerTool("liqpay_verify_callback", {
+        title: "Verify LiqPay Callback",
+        description: "Validate an incoming LiqPay webhook signature to confirm authenticity. " +
+            "Use when processing a callback from LiqPay to verify it was not tampered with. " +
+            "Do not use for outgoing requests — signature is built automatically by the client. " +
+            "Returns { valid: boolean, decoded_data: object }.",
+        inputSchema: {
+            data: z.string().min(1).describe("Raw 'data' field from the webhook POST body (base64-encoded string)"),
+            signature: z.string().min(1).describe("Raw 'signature' field from the webhook POST body (base64-encoded string)"),
+        },
+        outputSchema: {
+            valid: z.boolean().describe("Whether the signature is authentic"),
+            decoded_data: z.record(z.unknown()).optional().describe("Decoded payment data from the callback (only if valid)"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ data, signature }) => {
+        try {
+            const expectedSignature = createSignature(data, privateKey);
+            const valid = expectedSignature === signature;
+            const output = { valid };
+            if (valid) {
+                output.decoded_data = decodeData(data);
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/tools/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/tools/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,UAAkB;IACxE,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,yEAAyE;YACzE,iFAAiF;YACjF,qFAAqF;YACrF,mDAAmD;QACrD,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qEAAqE,CAAC;YACvG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0EAA0E,CAAC;SAClH;QACD,YAAY,EAAE;YACZ,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACjE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;SAClH;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,iBAAiB,GAAG,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,iBAAiB,KAAK,SAAS,CAAC;YAE9C,MAAM,MAAM,GAA+D,EAAE,KAAK,EAAE,CAAC;YAErF,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YACzC,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC3E,iBAAiB,EAAE,MAAM;aAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,91 @@
+import type { LiqPayAction, LiqPayStatus, SupportedCurrency, SubscribePeriodicity } from "./constants.js";
+export interface LiqPayBasePayload {
+    version: number;
+    public_key: string;
+    action: LiqPayAction;
+}
+export interface LiqPayCheckoutPayload extends LiqPayBasePayload {
+    action: "pay";
+    amount: number;
+    currency: SupportedCurrency;
+    description: string;
+    order_id: string;
+    result_url?: string;
+    server_url?: string;
+    language?: "uk" | "en";
+}
+export interface LiqPayStatusPayload extends LiqPayBasePayload {
+    action: "status";
+    order_id: string;
+}
+export interface LiqPayHoldPayload extends LiqPayBasePayload {
+    action: "hold";
+    amount: number;
+    currency: SupportedCurrency;
+    description: string;
+    order_id: string;
+    card: string;
+    card_exp_month: string;
+    card_exp_year: string;
+    card_cvv: string;
+}
+export interface LiqPayHoldCompletionPayload extends LiqPayBasePayload {
+    action: "hold_completion";
+    order_id: string;
+    amount?: number;
+}
+export interface LiqPayRefundPayload extends LiqPayBasePayload {
+    action: "refund";
+    order_id: string;
+    amount?: number;
+}
+export interface LiqPaySubscribePayload extends LiqPayBasePayload {
+    action: "subscribe";
+    amount: number;
+    currency: SupportedCurrency;
+    description: string;
+    order_id: string;
+    subscribe_date_start: string;
+    subscribe_periodicity: SubscribePeriodicity;
+    result_url?: string;
+    server_url?: string;
+}
+export interface LiqPayUnsubscribePayload extends LiqPayBasePayload {
+    action: "unsubscribe";
+    order_id: string;
+}
+export interface LiqPayP2PPayload extends LiqPayBasePayload {
+    action: "p2p";
+    amount: number;
+    currency: SupportedCurrency;
+    description: string;
+    order_id: string;
+    card: string;
+}
+export interface LiqPayReportsPayload extends LiqPayBasePayload {
+    action: "reports";
+    date_from: number;
+    date_to: number;
+    status?: LiqPayStatus;
+}
+export interface LiqPayResponse {
+    result: string;
+    status: LiqPayStatus;
+    payment_id?: number;
+    action?: string;
+    amount?: number;
+    currency?: SupportedCurrency;
+    description?: string;
+    order_id?: string;
+    create_date?: number;
+    end_date?: number;
+    transaction_id?: number;
+    err_code?: string;
+    err_description?: string;
+}
+export interface LiqPayReportsResponse {
+    result: string;
+    count: number;
+    data: LiqPayResponse[];
+}
+export type LiqPayPayload = LiqPayCheckoutPayload | LiqPayStatusPayload | LiqPayHoldPayload | LiqPayHoldCompletionPayload | LiqPayRefundPayload | LiqPaySubscribePayload | LiqPayUnsubscribePayload | LiqPayP2PPayload | LiqPayReportsPayload;

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "liqpay-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for LiqPay payment gateway — payments, holds, refunds, subscriptions, payouts",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "liqpay-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "liqpay",
+    "payment",
+    "ukraine",
+    "privatbank",
+    "ai",
+    "llm",
+    "agent",
+    "payments-gateway",
+    "fintech"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/serhiizghama/liqpay-mcp"
+  },
+  "homepage": "https://github.com/serhiizghama/liqpay-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/serhiizghama/liqpay-mcp/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  }
+}