@monnify/mcp-server 1.0.0

package/build/tools/collections/payWithBankTransfer.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseBankTransferPaymentResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatBankTransferPayment } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { PayWithBankTransferInputSchema } from "../../schemas/extended/collections.js";
+const definition = {
+    name: "monnify_pay_with_bank_transfer",
+    description: `Initialises a bank transfer payment for an existing pending transaction and returns a one-time virtual account for the customer to transfer to.
+
+WHEN TO USE: After calling monnify_initiate_payment, use this tool when the customer wants to pay by direct bank transfer instead of card or USSD. Returns a virtual account number the customer must transfer the exact amount to.
+
+PREREQUISITES: A pending transaction must already exist — call monnify_initiate_payment first and pass its transactionReference here. The bankCode must be a valid Monnify-supported bank (call monnify_get_supported_banks to retrieve codes).
+
+SIDE EFFECTS: Creates a one-time virtual bank account tied to the transaction. The account expires at expiryDate. If the customer fails to transfer before expiry the transaction will remain pending. Calling this endpoint again with the same transactionReference and bankCode is safe (idempotent).
+
+MFA NOTE: No OTP is required from the customer on your end. The customer's own bank may require 2FA to complete the transfer.
+
+KEY OUTPUT FIELDS: accountNumber (tell the customer to transfer to this), accountName, bankName, bankCode, expiryDate (inform customer of deadline), amount (exact amount customer must send), fee, totalPayableFee, transactionReference.`,
+    inputSchema: zodToJsonSchema(PayWithBankTransferInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = PayWithBankTransferInputSchema.parse(args);
+        const result = await apiPost("/api/v1/merchant/bank-transfer/init-payment", parsed);
+        const sanitised = sanitiseBankTransferPaymentResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatBankTransferPayment(sanitised) }],
+        };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Validation failed:\n${error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (error instanceof MonnifyApiError) {
+            return { content: [error.toMcpContent()], isError: true };
+        }
+        return errorResult(`monnify_pay_with_bank_transfer failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, PayWithBankTransferInputSchema as inputSchema, handler };
+//# sourceMappingURL=payWithBankTransfer.js.map

package/build/tools/collections/payWithBankTransfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payWithBankTransfer.js","sourceRoot":"","sources":["../../../src/tools/collections/payWithBankTransfer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,mCAAmC,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AAEvF,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE;;;;;;;;;;2OAU4N;IACzO,WAAW,EAAE,eAAe,CAAC,8BAA8B,CAAwB;CACpF,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,8BAA8B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,6CAA6C,EAC7C,MAAM,CACP,CAAC;QACF,MAAM,SAAS,GAAG,mCAAmC,CAAC,MAAM,CAAC,CAAC;QAC9D,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,SAAoC,CAAC,EAAE,CAAC;SACzK,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uBAAuB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAC3G;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,WAAW,CAAC,0CAA0C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,8BAA8B,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/collections/processRefund.d.ts

@@ -0,0 +1,7 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { McpToolResult } from "../../types/mcp.js";
+import { ProcessRefundInputSchema } from "../../schemas/extended/collections.js";
+declare const definition: Tool;
+declare function handler(args: unknown): Promise<McpToolResult>;
+export { definition, ProcessRefundInputSchema as inputSchema, handler };
+//# sourceMappingURL=processRefund.d.ts.map

package/build/tools/collections/processRefund.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processRefund.d.ts","sourceRoot":"","sources":["../../../src/tools/collections/processRefund.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,QAAA,MAAM,UAAU,EAAE,IAcjB,CAAC;AAEF,iBAAe,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA4B5D;AAID,OAAO,EAAE,UAAU,EAAE,wBAAwB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/collections/processRefund.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseRefundResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatProcessRefund } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { ProcessRefundInputSchema } from "../../schemas/extended/collections.js";
+const definition = {
+    name: "monnify_process_refund",
+    description: `Initiates a refund for a previously completed payment transaction.
+
+WHEN TO USE: To reverse a charge at a customer's request, after an order cancellation, or when a duplicate or suspicious charge is detected. Can be a full or partial refund.
+
+PREREQUISITES: The original transaction must have paymentStatus = PAID. Obtain the transactionReference from monnify_get_transaction_status. Verify the destination account with monnify_verify_bank_account first.
+
+SIDE EFFECTS: Initiates a real fund transfer back to the customer. This is a financial operation — confirm the transaction reference and refund amount carefully before proceeding. Using the same refundReference is safe (idempotent — will not double-refund).
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: refundReference, transactionReference, refundStatus (INITIATED | PENDING | REFUNDED | FAILED), refundAmount, refundReason, destinationAccountNumber, createdOn.`,
+    inputSchema: zodToJsonSchema(ProcessRefundInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = ProcessRefundInputSchema.parse(args);
+        const result = await apiPost("/api/v1/refunds/initiate-refund", parsed);
+        const sanitised = sanitiseRefundResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatProcessRefund(sanitised) }],
+        };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Validation failed:\n${error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (error instanceof MonnifyApiError) {
+            return { content: [error.toMcpContent()], isError: true };
+        }
+        return errorResult(`monnify_process_refund failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, ProcessRefundInputSchema as inputSchema, handler };
+//# sourceMappingURL=processRefund.js.map

package/build/tools/collections/processRefund.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processRefund.js","sourceRoot":"","sources":["../../../src/tools/collections/processRefund.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE;;;;;;;;;;mLAUoK;IACjL,WAAW,EAAE,eAAe,CAAC,wBAAwB,CAAwB;CAC9E,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,iCAAiC,EACjC,MAAM,CACP,CAAC;QACF,MAAM,SAAS,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACjD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,SAAoC,CAAC,EAAE,CAAC;SACnK,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uBAAuB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAC3G;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,WAAW,CAAC,kCAAkC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,wBAAwB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/collections/reserveAccount.d.ts

@@ -0,0 +1,7 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { McpToolResult } from "../../types/mcp.js";
+import { ReserveAccountInputSchema } from "../../schemas/extended/collections.js";
+declare const definition: Tool;
+declare function handler(args: unknown): Promise<McpToolResult>;
+export { definition, ReserveAccountInputSchema as inputSchema, handler };
+//# sourceMappingURL=reserveAccount.d.ts.map

package/build/tools/collections/reserveAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserveAccount.d.ts","sourceRoot":"","sources":["../../../src/tools/collections/reserveAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAGlF,QAAA,MAAM,UAAU,EAAE,IAcjB,CAAC;AAEF,iBAAe,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA6B5D;AAID,OAAO,EAAE,UAAU,EAAE,yBAAyB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/collections/reserveAccount.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseReserveAccountResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatReserveAccount } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { ReserveAccountInputSchema } from "../../schemas/extended/collections.js";
+import { env } from "../../config/env.js";
+const definition = {
+    name: "monnify_reserve_account",
+    description: `Reserves a dedicated virtual bank account for a customer to pay into at any time.
+
+WHEN TO USE: For persistent payment collection — wallets, top-up accounts, or business collection accounts. Unlike one-time checkouts, reserved accounts allow customers to pay anytime by bank transfer.
+
+PREREQUISITES: Reserved Accounts feature must be enabled on your Monnify account. Contact Monnify support if unavailable.
+
+SIDE EFFECTS: Creates a persistent reserved account on Monnify's banking partners. The account persists until explicitly deleted. Using the same accountReference is safe (idempotent).
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: accountReference, accountName, accounts (array of virtual account numbers per bank), reservationReference, status, createdOn.`,
+    inputSchema: zodToJsonSchema(ReserveAccountInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = ReserveAccountInputSchema.parse(args);
+        const contractCode = parsed.contractCode ?? env().MONNIFY_CONTRACT_CODE;
+        const result = await apiPost("/api/v2/bank-transfer/reserved-accounts", { ...parsed, contractCode });
+        const sanitised = sanitiseReserveAccountResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatReserveAccount(sanitised) }],
+        };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Validation failed:\n${error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (error instanceof MonnifyApiError) {
+            return { content: [error.toMcpContent()], isError: true };
+        }
+        return errorResult(`monnify_reserve_account failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, ReserveAccountInputSchema as inputSchema, handler };
+//# sourceMappingURL=reserveAccount.js.map

package/build/tools/collections/reserveAccount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserveAccount.js","sourceRoot":"","sources":["../../../src/tools/collections/reserveAccount.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAE1C,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE;;;;;;;;;;iJAUkI;IAC/I,WAAW,EAAE,eAAe,CAAC,yBAAyB,CAAwB;CAC/E,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,GAAG,EAAE,CAAC,qBAAqB,CAAC;QACxE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,yCAAyC,EACzC,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,CAC5B,CAAC;QACF,MAAM,SAAS,GAAG,8BAA8B,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,SAAoC,CAAC,EAAE,CAAC;SACpK,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uBAAuB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAC3G;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,WAAW,CAAC,mCAAmC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,yBAAyB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/directDebit/cancelMandate.d.ts

@@ -0,0 +1,7 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { McpToolResult } from "../../types/mcp.js";
+import { CancelMandateInputSchema } from "../../schemas/extended/directDebit.js";
+declare const definition: Tool;
+declare function handler(args: unknown): Promise<McpToolResult>;
+export { definition, CancelMandateInputSchema as inputSchema, handler };
+//# sourceMappingURL=cancelMandate.d.ts.map

package/build/tools/directDebit/cancelMandate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancelMandate.d.ts","sourceRoot":"","sources":["../../../src/tools/directDebit/cancelMandate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,QAAA,MAAM,UAAU,EAAE,IAcjB,CAAC;AAEF,iBAAe,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA2B5D;AAID,OAAO,EAAE,UAAU,EAAE,wBAAwB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/directDebit/cancelMandate.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPatch } from "../../client/monnifyClient.js";
+import { sanitiseCancelMandateResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatCancelMandate } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { CancelMandateInputSchema } from "../../schemas/extended/directDebit.js";
+const definition = {
+    name: "monnify_cancel_mandate",
+    description: `Cancels an existing Direct Debit mandate, permanently stopping future debits.
+
+WHEN TO USE: When a customer requests cancellation of their subscription or recurring billing, or when a mandate needs to be revoked for compliance reasons.
+
+PREREQUISITES: The mandate must exist. The mandate can be in any status (PENDING_AUTHORIZATION, ACTIVATED).
+
+SIDE EFFECTS: IRREVERSIBLE — once cancelled, the mandate cannot be reactivated. The customer must create and authorise a new mandate to resume recurring billing. No refunds are triggered — only future scheduled debits are stopped.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: mandateReference, mandateStatus (will be CANCELLED).`,
+    inputSchema: zodToJsonSchema(CancelMandateInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = CancelMandateInputSchema.parse(args);
+        const result = await apiPatch(`/api/v1/direct-debit/mandate/cancel-mandate/${encodeURIComponent(parsed.mandateCode)}`);
+        const sanitised = sanitiseCancelMandateResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatCancelMandate(sanitised) }],
+        };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Validation failed:\n${error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (error instanceof MonnifyApiError) {
+            return { content: [error.toMcpContent()], isError: true };
+        }
+        return errorResult(`monnify_cancel_mandate failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, CancelMandateInputSchema as inputSchema, handler };
+//# sourceMappingURL=cancelMandate.js.map

package/build/tools/directDebit/cancelMandate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancelMandate.js","sourceRoot":"","sources":["../../../src/tools/directDebit/cancelMandate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE;;;;;;;;;;wEAUyD;IACtE,WAAW,EAAE,eAAe,CAAC,wBAAwB,CAAwB;CAC9E,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,+CAA+C,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CACxF,CAAC;QACF,MAAM,SAAS,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC;QACxD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,SAAoC,CAAC,EAAE,CAAC;SACnK,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uBAAuB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAC3G;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,WAAW,CAAC,kCAAkC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,wBAAwB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/directDebit/createMandate.d.ts

@@ -0,0 +1,7 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { McpToolResult } from "../../types/mcp.js";
+import { CreateMandateInputSchema } from "../../schemas/extended/directDebit.js";
+declare const definition: Tool;
+declare function handler(args: unknown): Promise<McpToolResult>;
+export { definition, CreateMandateInputSchema as inputSchema, handler };
+//# sourceMappingURL=createMandate.d.ts.map

package/build/tools/directDebit/createMandate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMandate.d.ts","sourceRoot":"","sources":["../../../src/tools/directDebit/createMandate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,QAAA,MAAM,UAAU,EAAE,IAcjB,CAAC;AAEF,iBAAe,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA4B5D;AAID,OAAO,EAAE,UAAU,EAAE,wBAAwB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/directDebit/createMandate.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseMandateResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatCreateMandate } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { CreateMandateInputSchema } from "../../schemas/extended/directDebit.js";
+const definition = {
+    name: "monnify_create_mandate",
+    description: `Creates a Direct Debit mandate on a customer's bank account, enabling recurring payments.
+
+WHEN TO USE: When setting up recurring billing for a customer — subscriptions, instalments, or utility collection. This is always the first step in the Direct Debit lifecycle.
+
+PREREQUISITES: None. However, verify the customer's bank account with monnify_verify_bank_account first to confirm account details before committing them to a mandate.
+
+SIDE EFFECTS: Generates a mandateReference and a 30-day authorization link. The mandate status starts as PENDING_AUTHORIZATION — no debiting can occur until the customer clicks the link and authorises via their bank. Monnify automatically routes to TeamApt or NIBSS based on the customer's bank.
+
+MFA NOTE: Not applicable at this stage. Customer authorisation is handled externally via the authorizationLink — share this link with the customer via email, SMS, or in-app.
+
+KEY OUTPUT FIELDS: mandateReference, mandateCode, mandateStatus (PENDING_AUTHORIZATION), authorizationLink (valid 30 days), startDate, endDate.`,
+    inputSchema: zodToJsonSchema(CreateMandateInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = CreateMandateInputSchema.parse(args);
+        const result = await apiPost("/api/v1/direct-debit/mandate/create", parsed);
+        const sanitised = sanitiseMandateResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatCreateMandate(sanitised) }],
+        };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Validation failed:\n${error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (error instanceof MonnifyApiError) {
+            return { content: [error.toMcpContent()], isError: true };
+        }
+        return errorResult(`monnify_create_mandate failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, CreateMandateInputSchema as inputSchema, handler };
+//# sourceMappingURL=createMandate.js.map

package/build/tools/directDebit/createMandate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMandate.js","sourceRoot":"","sources":["../../../src/tools/directDebit/createMandate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE;;;;;;;;;;gJAUiI;IAC9I,WAAW,EAAE,eAAe,CAAC,wBAAwB,CAAwB;CAC9E,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,qCAAqC,EACrC,MAAM,CACP,CAAC;QACF,MAAM,SAAS,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,SAAoC,CAAC,EAAE,CAAC;SACnK,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uBAAuB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAC3G;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,WAAW,CAAC,kCAAkC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,wBAAwB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/directDebit/debitMandate.d.ts

@@ -0,0 +1,7 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { McpToolResult } from "../../types/mcp.js";
+import { DebitMandateInputSchema } from "../../schemas/extended/directDebit.js";
+declare const definition: Tool;
+declare function handler(args: unknown): Promise<McpToolResult>;
+export { definition, DebitMandateInputSchema as inputSchema, handler };
+//# sourceMappingURL=debitMandate.d.ts.map

package/build/tools/directDebit/debitMandate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debitMandate.d.ts","sourceRoot":"","sources":["../../../src/tools/directDebit/debitMandate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,QAAA,MAAM,UAAU,EAAE,IAcjB,CAAC;AAEF,iBAAe,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA4B5D;AAID,OAAO,EAAE,UAAU,EAAE,uBAAuB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/directDebit/debitMandate.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseDebitStatusResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatDebitStatus } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { DebitMandateInputSchema } from "../../schemas/extended/directDebit.js";
+const definition = {
+    name: "monnify_debit_mandate",
+    description: `Debits a customer's bank account using an activated Direct Debit mandate.
+
+WHEN TO USE: To collect a payment from a customer who has an ACTIVATED mandate. Call monnify_get_mandate_status first to confirm the mandate is ACTIVATED before attempting a debit.
+
+PREREQUISITES: monnify_get_mandate_status must return mandateStatus = ACTIVATED. Never attempt to debit a PENDING_AUTHORIZATION or CANCELLED mandate.
+
+SIDE EFFECTS: Initiates a real debit from the customer's bank account. This is an irreversible financial operation. Use a unique paymentReference per debit attempt — the same reference can be safely resubmitted to check status without double-charging.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: debitReference, mandateReference, debitStatus (PENDING | SUCCESS | FAILED), amount, debitDate.`,
+    inputSchema: zodToJsonSchema(DebitMandateInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = DebitMandateInputSchema.parse(args);
+        const result = await apiPost("/api/v1/direct-debit/mandate/debit", parsed);
+        const sanitised = sanitiseDebitStatusResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatDebitStatus(sanitised) }],
+        };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Validation failed:\n${error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (error instanceof MonnifyApiError) {
+            return { content: [error.toMcpContent()], isError: true };
+        }
+        return errorResult(`monnify_debit_mandate failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, DebitMandateInputSchema as inputSchema, handler };
+//# sourceMappingURL=debitMandate.js.map

package/build/tools/directDebit/debitMandate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debitMandate.js","sourceRoot":"","sources":["../../../src/tools/directDebit/debitMandate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE;;;;;;;;;;kHAUmG;IAChH,WAAW,EAAE,eAAe,CAAC,uBAAuB,CAAwB;CAC7E,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,oCAAoC,EACpC,MAAM,CACP,CAAC;QACF,MAAM,SAAS,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,SAAoC,CAAC,EAAE,CAAC;SACjK,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uBAAuB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAC3G;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,WAAW,CAAC,iCAAiC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,uBAAuB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/directDebit/getMandateDebitStatus.d.ts

@@ -0,0 +1,7 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { McpToolResult } from "../../types/mcp.js";
+import { GetMandateDebitStatusInputSchema } from "../../schemas/extended/directDebit.js";
+declare const definition: Tool;
+declare function handler(args: unknown): Promise<McpToolResult>;
+export { definition, GetMandateDebitStatusInputSchema as inputSchema, handler };
+//# sourceMappingURL=getMandateDebitStatus.d.ts.map

package/build/tools/directDebit/getMandateDebitStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMandateDebitStatus.d.ts","sourceRoot":"","sources":["../../../src/tools/directDebit/getMandateDebitStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AAEzF,QAAA,MAAM,UAAU,EAAE,IAcjB,CAAC;AAEF,iBAAe,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA4B5D;AAID,OAAO,EAAE,UAAU,EAAE,gCAAgC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/directDebit/getMandateDebitStatus.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiGet } from "../../client/monnifyClient.js";
+import { sanitiseDebitStatusResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatDebitStatus } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { GetMandateDebitStatusInputSchema } from "../../schemas/extended/directDebit.js";
+const definition = {
+    name: "monnify_get_mandate_debit_status",
+    description: `Retrieves the status of a specific Direct Debit debit attempt.
+
+WHEN TO USE: After calling monnify_debit_mandate to check whether the debit succeeded, is still pending, or has failed. Debit operations are asynchronous — poll this endpoint to confirm the final status.
+
+PREREQUISITES: A debit attempt must exist — call monnify_debit_mandate first.
+
+SIDE EFFECTS: None. Read-only operation.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: paymentReference, debitStatus (PENDING | SUCCESS | FAILED), amount, debitDate.`,
+    inputSchema: zodToJsonSchema(GetMandateDebitStatusInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = GetMandateDebitStatusInputSchema.parse(args);
+        const result = await apiGet("/api/v1/direct-debit/mandate/debit-status", { paymentReference: parsed.paymentReference });
+        const sanitised = sanitiseDebitStatusResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatDebitStatus(sanitised) }],
+        };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Validation failed:\n${error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (error instanceof MonnifyApiError) {
+            return { content: [error.toMcpContent()], isError: true };
+        }
+        return errorResult(`monnify_get_mandate_debit_status failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, GetMandateDebitStatusInputSchema as inputSchema, handler };
+//# sourceMappingURL=getMandateDebitStatus.js.map

package/build/tools/directDebit/getMandateDebitStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMandateDebitStatus.js","sourceRoot":"","sources":["../../../src/tools/directDebit/getMandateDebitStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AAEzF,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,kCAAkC;IACxC,WAAW,EAAE;;;;;;;;;;kGAUmF;IAChG,WAAW,EAAE,eAAe,CAAC,gCAAgC,CAAwB;CACtF,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,gCAAgC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,2CAA2C,EAC3C,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAC9C,CAAC;QACF,MAAM,SAAS,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,SAAoC,CAAC,EAAE,CAAC;SACjK,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uBAAuB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAC3G;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,WAAW,CAAC,4CAA4C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,gCAAgC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/directDebit/getMandateStatus.d.ts

@@ -0,0 +1,7 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { McpToolResult } from "../../types/mcp.js";
+import { GetMandateStatusInputSchema } from "../../schemas/extended/directDebit.js";
+declare const definition: Tool;
+declare function handler(args: unknown): Promise<McpToolResult>;
+export { definition, GetMandateStatusInputSchema as inputSchema, handler };
+//# sourceMappingURL=getMandateStatus.d.ts.map

package/build/tools/directDebit/getMandateStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMandateStatus.d.ts","sourceRoot":"","sources":["../../../src/tools/directDebit/getMandateStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAEpF,QAAA,MAAM,UAAU,EAAE,IAcjB,CAAC;AAEF,iBAAe,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA4B5D;AAID,OAAO,EAAE,UAAU,EAAE,2BAA2B,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/directDebit/getMandateStatus.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiGet } from "../../client/monnifyClient.js";
+import { sanitiseMandateStatusResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatMandateStatus } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { GetMandateStatusInputSchema } from "../../schemas/extended/directDebit.js";
+const definition = {
+    name: "monnify_get_mandate_status",
+    description: `Retrieves the current status of a Direct Debit mandate.
+
+WHEN TO USE: After creating a mandate to check if the customer has authorised it (mandateStatus = ACTIVATED), or before attempting a debit. You MUST confirm mandateStatus = ACTIVATED before calling monnify_debit_mandate.
+
+PREREQUISITES: A mandate must exist — call monnify_create_mandate first.
+
+SIDE EFFECTS: None. Read-only operation.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: mandateReference, mandateCode, mandateStatus (PENDING_AUTHORIZATION | ACTIVATED | CANCELLED | REJECTED), mandateAmount, mandateType, customerName, customerAccountNumber, startDate, endDate, authorizationLink.`,
+    inputSchema: zodToJsonSchema(GetMandateStatusInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = GetMandateStatusInputSchema.parse(args);
+        const result = await apiGet("/api/v1/direct-debit/mandate/", { mandateReferences: parsed.mandateReferences });
+        const sanitised = sanitiseMandateStatusResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatMandateStatus(sanitised) }],
+        };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Validation failed:\n${error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (error instanceof MonnifyApiError) {
+            return { content: [error.toMcpContent()], isError: true };
+        }
+        return errorResult(`monnify_get_mandate_status failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, GetMandateStatusInputSchema as inputSchema, handler };
+//# sourceMappingURL=getMandateStatus.js.map

package/build/tools/directDebit/getMandateStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMandateStatus.js","sourceRoot":"","sources":["../../../src/tools/directDebit/getMandateStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAEpF,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE;;;;;;;;;;oOAUqN;IAClO,WAAW,EAAE,eAAe,CAAC,2BAA2B,CAAwB;CACjF,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,+BAA+B,EAC/B,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAChD,CAAC;QACF,MAAM,SAAS,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC;QACxD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,SAAoC,CAAC,EAAE,CAAC;SACnK,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uBAAuB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAC3G;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,WAAW,CAAC,sCAAsC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,2BAA2B,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/registry.d.ts

@@ -0,0 +1,11 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { McpToolResult } from "../types/mcp.js";
+interface ToolEntry {
+    definition: Tool;
+    handler: (args: unknown) => Promise<McpToolResult>;
+}
+export declare function registerTool(entry: ToolEntry): void;
+export declare function getAllToolDefinitions(): Tool[];
+export declare function dispatchTool(name: string, args: unknown): Promise<McpToolResult>;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/build/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,UAAU,SAAS;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CACpD;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAEnD;AAED,wBAAgB,qBAAqB,IAAI,IAAI,EAAE,CAE9C;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,aAAa,CAAC,CAIxB"}