liqpay-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 serhiizghama
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,189 @@
+<p align="center">
+  <img src="https://www.liqpay.ua/logo_liqpay.svg" alt="LiqPay" width="200" />
+</p>
+
+<h1 align="center">liqpay-mcp-server</h1>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/liqpay-mcp-server"><img src="https://img.shields.io/npm/v/liqpay-mcp-server" alt="npm version" /></a>
+  <a href="https://github.com/serhiizghama/liqpay-mcp/actions/workflows/ci.yml"><img src="https://github.com/serhiizghama/liqpay-mcp/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/liqpay-mcp-server" alt="Node version" /></a>
+  <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-blue" alt="MCP compatible" /></a>
+  <a href="https://github.com/serhiizghama/liqpay-mcp"><img src="https://img.shields.io/github/stars/serhiizghama/liqpay-mcp?style=social" alt="GitHub stars" /></a>
+</p>
+
+MCP server for the [LiqPay](https://www.liqpay.ua/) payment gateway — Ukraine's dominant payment platform operated by PrivatBank.
+
+Exposes 11 tools for payments, holds, refunds, subscriptions, payouts, and webhook verification to AI agents and LLM workflows via the [Model Context Protocol](https://modelcontextprotocol.io/).
+
+## Features
+
+- **11 tools** covering the full LiqPay API: payments, holds, refunds, subscriptions, P2P payouts, webhooks
+- **PCI DSS safe** — hosted checkout keeps card data on LiqPay's side
+- **2-step hold flow** — freeze funds first, capture or cancel later
+- **Recurring subscriptions** — daily, weekly, monthly, yearly billing cycles
+- **Webhook verification** — SHA-1 signature validation for incoming callbacks
+- **Truncation protection** — large report responses are automatically truncated with guidance
+- **TypeScript** — full type safety, strict mode, zero `any`
+- **Zero extra dependencies** — uses Node.js built-in `crypto` and native `fetch`
+
+## Quick Start
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`  
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "liqpay": {
+      "command": "npx",
+      "args": ["-y", "liqpay-mcp-server"],
+      "env": {
+        "LIQPAY_PUBLIC_KEY": "your_public_key",
+        "LIQPAY_PRIVATE_KEY": "your_private_key"
+      }
+    }
+  }
+}
+```
+
+### VS Code / Cursor
+
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0078d4?logo=visualstudiocode)](https://insiders.vscode.dev/redirect/mcp/install?name=liqpay&inputs=%5B%7B%22id%22%3A%22publicKey%22%2C%22description%22%3A%22LiqPay%20Public%20Key%22%2C%22type%22%3A%22promptString%22%7D%2C%7B%22id%22%3A%22privateKey%22%2C%22description%22%3A%22LiqPay%20Private%20Key%22%2C%22type%22%3A%22promptString%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22liqpay-mcp-server%22%5D%2C%22env%22%3A%7B%22LIQPAY_PUBLIC_KEY%22%3A%22%24%7Binput%3ApublicKey%7D%22%2C%22LIQPAY_PRIVATE_KEY%22%3A%22%24%7Binput%3AprivateKey%7D%22%7D%7D)
+
+Or add to `.vscode/mcp.json` / `.cursor/mcp.json` manually:
+
+```json
+{
+  "servers": {
+    "liqpay": {
+      "command": "npx",
+      "args": ["-y", "liqpay-mcp-server"],
+      "env": {
+        "LIQPAY_PUBLIC_KEY": "your_public_key",
+        "LIQPAY_PRIVATE_KEY": "your_private_key"
+      }
+    }
+  }
+}
+```
+
+### Claude Code (CLI)
+
+Add to `~/.claude/settings.json` (global) or `.claude/settings.json` (project):
+
+```json
+{
+  "mcpServers": {
+    "liqpay": {
+      "command": "npx",
+      "args": ["-y", "liqpay-mcp-server"],
+      "env": {
+        "LIQPAY_PUBLIC_KEY": "your_public_key",
+        "LIQPAY_PRIVATE_KEY": "your_private_key"
+      }
+    }
+  }
+}
+```
+
+## Prerequisites
+
+- Node.js >= 18
+- LiqPay merchant account — get your keys at [liqpay.ua/en/adminbusiness](https://www.liqpay.ua/en/adminbusiness)
+
+## Tools
+
+| Tool | Description | Annotations |
+|------|-------------|-------------|
+| `liqpay_create_checkout_url` | Generate a hosted checkout URL (PCI DSS safe) | `idempotent` `open-world` |
+| `liqpay_get_payment_status` | Fetch payment status by order ID | `read-only` `idempotent` `open-world` |
+| `liqpay_get_payments_list` | List payments by date range (max 31 days) | `read-only` `idempotent` `open-world` |
+| `liqpay_create_hold` | Pre-authorize funds on a card (2-step) | `open-world` |
+| `liqpay_complete_hold` | Capture previously held funds | `destructive` `open-world` |
+| `liqpay_cancel_hold` | Release held funds back to payer | `destructive` `idempotent` `open-world` |
+| `liqpay_create_refund` | Refund a completed payment (full/partial) | `destructive` `open-world` |
+| `liqpay_create_subscription` | Create recurring subscription via checkout | `idempotent` `open-world` |
+| `liqpay_cancel_subscription` | Cancel an active subscription | `destructive` `idempotent` `open-world` |
+| `liqpay_create_payout` | P2P transfer to a card | `destructive` `open-world` |
+| `liqpay_verify_callback` | Validate incoming webhook signature | `read-only` `idempotent` |
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `LIQPAY_PUBLIC_KEY` | Yes | Merchant public key from LiqPay dashboard |
+| `LIQPAY_PRIVATE_KEY` | Yes | Merchant private key from LiqPay dashboard |
+
+## Rate Limits
+
+| Scope | Limit |
+|-------|-------|
+| All API requests | ~100 req/min per merchant account |
+| Reports (`liqpay_get_payments_list`) | Max 31-day date range per request |
+| Checkout URL generation | No limit — computed locally, no API call |
+| Webhook verification | No limit — computed locally, no API call |
+
+## Docker
+
+```bash
+docker build -t liqpay-mcp-server .
+docker run -e LIQPAY_PUBLIC_KEY=your_key -e LIQPAY_PRIVATE_KEY=your_secret liqpay-mcp-server
+```
+
+Or with docker-compose:
+
+```yaml
+services:
+  liqpay-mcp:
+    build: .
+    environment:
+      LIQPAY_PUBLIC_KEY: your_key
+      LIQPAY_PRIVATE_KEY: your_secret
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in dev mode (auto-reload)
+npm run dev
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Test with MCP Inspector
+LIQPAY_PUBLIC_KEY=test LIQPAY_PRIVATE_KEY=test \
+  npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+See [docs/SANDBOX_TESTING.md](./docs/SANDBOX_TESTING.md) for testing without real money.
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [docs/AGENT_SETUP.md](./docs/AGENT_SETUP.md) | Instructions for AI agents to install and configure this server |
+| [docs/API_REFERENCE.md](./docs/API_REFERENCE.md) | Complete tool reference with request/response examples |
+| [docs/SANDBOX_TESTING.md](./docs/SANDBOX_TESTING.md) | How to test with LiqPay sandbox (no real money) |
+
+## Security
+
+- LiqPay API signature uses SHA-1: `base64(sha1(private_key + data + private_key))`
+- Private keys are never logged or included in tool responses
+- `liqpay_create_hold` and `liqpay_create_payout` accept raw card numbers — ensure PCI DSS compliance
+- For most payment use cases, prefer `liqpay_create_checkout_url` which handles card data on LiqPay's side
+
+## License
+
+[MIT](./LICENSE)

package/dist/auth.d.ts

@@ -0,0 +1,3 @@
+export declare function createSignature(data: string, privateKey: string): string;
+export declare function encodeData(payload: Record<string, unknown>): string;
+export declare function decodeData(data: string): Record<string, unknown>;

package/dist/auth.js

@@ -0,0 +1,13 @@
+import { createHash } from "node:crypto";
+export function createSignature(data, privateKey) {
+    return createHash("sha1")
+        .update(privateKey + data + privateKey)
+        .digest("base64");
+}
+export function encodeData(payload) {
+    return Buffer.from(JSON.stringify(payload)).toString("base64");
+}
+export function decodeData(data) {
+    return JSON.parse(Buffer.from(data, "base64").toString("utf-8"));
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,UAAkB;IAC9D,OAAO,UAAU,CAAC,MAAM,CAAC;SACtB,MAAM,CAAC,UAAU,GAAG,IAAI,GAAG,UAAU,CAAC;SACtC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAgC;IACzD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA4B,CAAC;AAC9F,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+import type { LiqPayResponse } from "./types.js";
+export declare class LiqPayClient {
+    private readonly publicKey;
+    private readonly privateKey;
+    constructor(publicKey: string, privateKey: string);
+    request<T = LiqPayResponse>(params: Record<string, unknown>): Promise<T>;
+    buildCheckoutUrl(params: Record<string, unknown>): string;
+}

package/dist/client.js

@@ -0,0 +1,44 @@
+import { createSignature, encodeData } from "./auth.js";
+import { LIQPAY_API_URL, LIQPAY_API_VERSION, LIQPAY_CHECKOUT_URL } from "./constants.js";
+import { formatHttpError, formatLiqPayError } from "./errors.js";
+export class LiqPayClient {
+    publicKey;
+    privateKey;
+    constructor(publicKey, privateKey) {
+        this.publicKey = publicKey;
+        this.privateKey = privateKey;
+    }
+    async request(params) {
+        const payload = {
+            ...params,
+            version: LIQPAY_API_VERSION,
+            public_key: this.publicKey,
+        };
+        const data = encodeData(payload);
+        const signature = createSignature(data, this.privateKey);
+        const response = await fetch(LIQPAY_API_URL, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: new URLSearchParams({ data, signature }).toString(),
+        });
+        if (!response.ok) {
+            throw new Error(formatHttpError(response.status));
+        }
+        const result = (await response.json());
+        if (result.status === "error" || result.err_code) {
+            throw new Error(formatLiqPayError(result.err_code, result.err_description));
+        }
+        return result;
+    }
+    buildCheckoutUrl(params) {
+        const payload = {
+            ...params,
+            version: LIQPAY_API_VERSION,
+            public_key: this.publicKey,
+        };
+        const data = encodeData(payload);
+        const signature = createSignature(data, this.privateKey);
+        return `${LIQPAY_CHECKOUT_URL}?data=${encodeURIComponent(data)}&signature=${encodeURIComponent(signature)}`;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGjE,MAAM,OAAO,YAAY;IAEJ;IACA;IAFnB,YACmB,SAAiB,EACjB,UAAkB;QADlB,cAAS,GAAT,SAAS,CAAQ;QACjB,eAAU,GAAV,UAAU,CAAQ;IAClC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAqB,MAA+B;QAC/D,MAAM,OAAO,GAAG;YACd,GAAG,MAAM;YACT,OAAO,EAAE,kBAAkB;YAC3B,UAAU,EAAE,IAAI,CAAC,SAAS;SAC3B,CAAC;QAEF,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEzD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE;YAC3C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;YAChE,IAAI,EAAE,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE;SAC1D,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyE,CAAC;QAE/G,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,gBAAgB,CAAC,MAA+B;QAC9C,MAAM,OAAO,GAAG;YACd,GAAG,MAAM;YACT,OAAO,EAAE,kBAAkB;YAC3B,UAAU,EAAE,IAAI,CAAC,SAAS;SAC3B,CAAC;QAEF,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEzD,OAAO,GAAG,mBAAmB,SAAS,kBAAkB,CAAC,IAAI,CAAC,cAAc,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;IAC9G,CAAC;CACF"}

package/dist/constants.d.ts

@@ -0,0 +1,22 @@
+export declare const LIQPAY_API_URL = "https://www.liqpay.ua/api/request";
+export declare const LIQPAY_CHECKOUT_URL = "https://www.liqpay.ua/api/3/checkout";
+export declare const LIQPAY_API_VERSION = 3;
+export declare const CHARACTER_LIMIT = 25000;
+export declare const SUPPORTED_CURRENCIES: readonly ["UAH", "USD", "EUR"];
+export type SupportedCurrency = (typeof SUPPORTED_CURRENCIES)[number];
+export declare const LIQPAY_STATUSES: readonly ["success", "failure", "error", "wait_accept", "processing", "reversed", "hold_wait", "sandbox", "subscribed", "unsubscribed"];
+export type LiqPayStatus = (typeof LIQPAY_STATUSES)[number];
+export declare const LIQPAY_ACTIONS: {
+    readonly PAY: "pay";
+    readonly HOLD: "hold";
+    readonly HOLD_COMPLETION: "hold_completion";
+    readonly SUBSCRIBE: "subscribe";
+    readonly UNSUBSCRIBE: "unsubscribe";
+    readonly REFUND: "refund";
+    readonly STATUS: "status";
+    readonly REPORTS: "reports";
+    readonly P2P: "p2p";
+};
+export type LiqPayAction = (typeof LIQPAY_ACTIONS)[keyof typeof LIQPAY_ACTIONS];
+export declare const SUBSCRIBE_PERIODICITIES: readonly ["day", "week", "month", "year"];
+export type SubscribePeriodicity = (typeof SUBSCRIBE_PERIODICITIES)[number];

package/dist/constants.js

@@ -0,0 +1,30 @@
+export const LIQPAY_API_URL = "https://www.liqpay.ua/api/request";
+export const LIQPAY_CHECKOUT_URL = "https://www.liqpay.ua/api/3/checkout";
+export const LIQPAY_API_VERSION = 3;
+export const CHARACTER_LIMIT = 25000;
+export const SUPPORTED_CURRENCIES = ["UAH", "USD", "EUR"];
+export const LIQPAY_STATUSES = [
+    "success",
+    "failure",
+    "error",
+    "wait_accept",
+    "processing",
+    "reversed",
+    "hold_wait",
+    "sandbox",
+    "subscribed",
+    "unsubscribed",
+];
+export const LIQPAY_ACTIONS = {
+    PAY: "pay",
+    HOLD: "hold",
+    HOLD_COMPLETION: "hold_completion",
+    SUBSCRIBE: "subscribe",
+    UNSUBSCRIBE: "unsubscribe",
+    REFUND: "refund",
+    STATUS: "status",
+    REPORTS: "reports",
+    P2P: "p2p",
+};
+export const SUBSCRIBE_PERIODICITIES = ["day", "week", "month", "year"];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,mCAAmC,CAAC;AAClE,MAAM,CAAC,MAAM,mBAAmB,GAAG,sCAAsC,CAAC;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAGnE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,SAAS;IACT,SAAS;IACT,OAAO;IACP,aAAa;IACb,YAAY;IACZ,UAAU;IACV,WAAW;IACX,SAAS;IACT,YAAY;IACZ,cAAc;CACN,CAAC;AAGX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,eAAe,EAAE,iBAAiB;IAClC,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,GAAG,EAAE,KAAK;CACF,CAAC;AAGX,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function formatLiqPayError(errCode: string | undefined, errDescription: string | undefined): string;
+export declare function formatHttpError(status: number): string;

package/dist/errors.js

@@ -0,0 +1,41 @@
+export function formatLiqPayError(errCode, errDescription) {
+    if (!errCode) {
+        return "Error: LiqPay returned an unexpected error. Retry the request or check the order_id.";
+    }
+    const base = `Error [${errCode}]: ${errDescription ?? "Unknown error"}`;
+    switch (errCode) {
+        case "err_auth":
+            return `${base}. Check that LIQPAY_PUBLIC_KEY and LIQPAY_PRIVATE_KEY are correct.`;
+        case "err_payment":
+            return `${base}. The payment could not be processed — verify amount, currency, and card details.`;
+        case "err_limit":
+            return `${base}. Transaction limit exceeded — try a smaller amount or contact LiqPay support.`;
+        case "err_signature":
+            return `${base}. Signature mismatch — this usually means the private key is wrong.`;
+        case "err_shop_not_active":
+            return `${base}. The merchant account is not active — check your LiqPay dashboard.`;
+        case "err_order_id":
+            return `${base}. Invalid or duplicate order_id — use a unique identifier for each transaction.`;
+        case "err_refund":
+            return `${base}. Refund failed — ensure the original payment status is 'success' and the amount does not exceed the original.`;
+        default:
+            return `${base}. See LiqPay documentation for error code '${errCode}'.`;
+    }
+}
+export function formatHttpError(status) {
+    switch (status) {
+        case 401:
+            return "Error: Authentication failed. Check LIQPAY_PUBLIC_KEY and LIQPAY_PRIVATE_KEY.";
+        case 403:
+            return "Error: Access denied. Your merchant account may lack permissions for this action.";
+        case 429:
+            return "Error: Rate limit exceeded. Wait before making more requests.";
+        case 500:
+        case 502:
+        case 503:
+            return `Error: LiqPay server error (HTTP ${status}). Retry after a short delay.`;
+        default:
+            return `Error: LiqPay API returned HTTP ${status}.`;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,OAA2B,EAAE,cAAkC;IAC/F,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,sFAAsF,CAAC;IAChG,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,OAAO,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;IAExE,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,GAAG,IAAI,oEAAoE,CAAC;QACrF,KAAK,aAAa;YAChB,OAAO,GAAG,IAAI,mFAAmF,CAAC;QACpG,KAAK,WAAW;YACd,OAAO,GAAG,IAAI,gFAAgF,CAAC;QACjG,KAAK,eAAe;YAClB,OAAO,GAAG,IAAI,qEAAqE,CAAC;QACtF,KAAK,qBAAqB;YACxB,OAAO,GAAG,IAAI,qEAAqE,CAAC;QACtF,KAAK,cAAc;YACjB,OAAO,GAAG,IAAI,iFAAiF,CAAC;QAClG,KAAK,YAAY;YACf,OAAO,GAAG,IAAI,gHAAgH,CAAC;QACjI;YACE,OAAO,GAAG,IAAI,8CAA8C,OAAO,IAAI,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,+EAA+E,CAAC;QACzF,KAAK,GAAG;YACN,OAAO,mFAAmF,CAAC;QAC7F,KAAK,GAAG;YACN,OAAO,+DAA+D,CAAC;QACzE,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO,oCAAoC,MAAM,+BAA+B,CAAC;QACnF;YACE,OAAO,mCAAmC,MAAM,GAAG,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { LiqPayClient } from "./client.js";
+import { registerPaymentTools } from "./tools/payments.js";
+import { registerReportTools } from "./tools/reports.js";
+import { registerRefundTools } from "./tools/refunds.js";
+import { registerWebhookTools } from "./tools/webhooks.js";
+import { registerHoldTools } from "./tools/holds.js";
+import { registerSubscriptionTools } from "./tools/subscriptions.js";
+import { registerPayoutTools } from "./tools/payouts.js";
+const publicKey = process.env["LIQPAY_PUBLIC_KEY"];
+const privateKey = process.env["LIQPAY_PRIVATE_KEY"];
+if (!publicKey || !privateKey) {
+    console.error("Error: LIQPAY_PUBLIC_KEY and LIQPAY_PRIVATE_KEY environment variables are required.\n" +
+        "Get your keys at https://www.liqpay.ua/en/adminbusiness");
+    process.exit(1);
+}
+const client = new LiqPayClient(publicKey, privateKey);
+const server = new McpServer({
+    name: "liqpay-mcp-server",
+    version: "1.0.0",
+}, {
+    instructions: "LiqPay payment gateway integration for Ukrainian e-commerce. " +
+        "Supports payments, holds, refunds, subscriptions, payouts, and webhook verification. " +
+        "Requires LIQPAY_PUBLIC_KEY and LIQPAY_PRIVATE_KEY environment variables. " +
+        "All monetary amounts are in currency units (e.g. 99.99 for ₴99.99). " +
+        "Use liqpay_create_checkout_url for PCI-safe payments via hosted page. " +
+        "Use liqpay_get_payment_status to check payment results. " +
+        "Use liqpay_verify_callback to validate incoming webhooks.",
+});
+registerPaymentTools(server, client);
+registerReportTools(server, client);
+registerRefundTools(server, client);
+registerWebhookTools(server, privateKey);
+registerHoldTools(server, client);
+registerSubscriptionTools(server, client);
+registerPayoutTools(server, client);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACnD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAErD,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC;IAC9B,OAAO,CAAC,KAAK,CACX,uFAAuF;QACrF,yDAAyD,CAC5D,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAEvD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EACV,+DAA+D;QAC/D,uFAAuF;QACvF,2EAA2E;QAC3E,sEAAsE;QACtE,wEAAwE;QACxE,0DAA0D;QAC1D,2DAA2D;CAC9D,CACF,CAAC;AAEF,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACpC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACpC,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACzC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAClC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1C,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/holds.d.ts

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

package/dist/tools/holds.js

@@ -0,0 +1,147 @@
+import { z } from "zod";
+export function registerHoldTools(server, client) {
+    server.registerTool("liqpay_create_hold", {
+        title: "Create LiqPay Hold",
+        description: "Pre-authorize (freeze) funds on the payer's card without capturing them (action: hold). " +
+            "Use when you need a 2-step payment: reserve first, charge later. " +
+            "Do not use if the merchant is not PCI DSS compliant — use liqpay_create_checkout_url instead. " +
+            "Returns { payment_id, status, amount, currency }.",
+        inputSchema: {
+            amount: z.number().positive().describe("Amount to hold in currency units (e.g. 250.00)"),
+            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. 'hold-2026-001')"),
+            card: z.string().regex(/^\d{16}$/).describe("Payer's card number — exactly 16 digits (e.g. '4111111111111111')"),
+            card_exp_month: z.string().regex(/^(0[1-9]|1[0-2])$/).describe("Card expiry month in MM format (e.g. '03')"),
+            card_exp_year: z.string().regex(/^\d{2}$/).describe("Card expiry year in YY format (e.g. '29')"),
+            card_cvv: z.string().regex(/^\d{3,4}$/).describe("Card CVV code — 3 or 4 digits (e.g. '123')"),
+        },
+        outputSchema: {
+            payment_id: z.number().describe("LiqPay internal payment ID"),
+            status: z.string().describe("Hold status (e.g. hold_wait)"),
+            amount: z.number().describe("Held amount"),
+            currency: z.string().describe("ISO 4217 currency code"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ amount, currency, description, order_id, card, card_exp_month, card_exp_year, card_cvv }) => {
+        try {
+            const result = await client.request({
+                action: "hold",
+                amount,
+                currency,
+                description,
+                order_id,
+                card,
+                card_exp_month,
+                card_exp_year,
+                card_cvv,
+            });
+            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,
+            };
+        }
+    });
+    server.registerTool("liqpay_complete_hold", {
+        title: "Complete LiqPay Hold",
+        description: "Capture previously held funds — completes the 2-step payment (action: hold_completion). " +
+            "Use after liqpay_create_hold to actually charge the frozen amount. " +
+            "Do not use if the hold has already been cancelled — it will return an error. " +
+            "Returns { status, payment_id }.",
+        inputSchema: {
+            order_id: z.string().min(1).describe("Order ID from the original liqpay_create_hold call (e.g. 'hold-2026-001')"),
+            amount: z.number().positive().optional().describe("Partial capture amount ≤ held amount (e.g. 150.00); omit for full capture"),
+        },
+        outputSchema: {
+            status: z.string().describe("Capture status (e.g. success, error)"),
+            payment_id: z.number().describe("LiqPay internal payment ID"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ order_id, amount }) => {
+        try {
+            const params = { action: "hold_completion", order_id };
+            if (amount !== undefined)
+                params["amount"] = amount;
+            const result = await client.request(params);
+            const output = {
+                status: result.status,
+                payment_id: result.payment_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,
+            };
+        }
+    });
+    server.registerTool("liqpay_cancel_hold", {
+        title: "Cancel LiqPay Hold",
+        description: "Release held funds back to payer without capture (action: hold_completion with flag). " +
+            "Use to cancel a previously created hold when the order is no longer needed. " +
+            "Do not use if funds have already been captured via liqpay_complete_hold. " +
+            "Returns { status, payment_id }.",
+        inputSchema: {
+            order_id: z.string().min(1).describe("Order ID from the original liqpay_create_hold call (e.g. 'hold-2026-001')"),
+        },
+        outputSchema: {
+            status: z.string().describe("Reversal status (e.g. reversed)"),
+            payment_id: z.number().describe("LiqPay internal payment ID"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ order_id }) => {
+        try {
+            const result = await client.request({
+                action: "hold_completion",
+                order_id,
+                flag: "reversal",
+            });
+            const output = {
+                status: result.status,
+                payment_id: result.payment_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=holds.js.map

package/dist/tools/holds.js.map

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

package/dist/tools/payments.d.ts

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