@monnify/mcp-server 1.0.0

package/build/tools/collections/authoriseCard3ds.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseAuthoriseCard3dsResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatAuthoriseCard3ds } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { AuthoriseCard3dsInputSchema } from "../../schemas/extended/collections.js";
+import { tryEnv } from "../../config/env.js";
+const definition = {
+    name: "monnify_authorise_card_3ds",
+    description: `Initiates 3D Secure (3DS) authorisation for a card transaction and returns the redirect URL for the customer to complete bank authentication.
+
+WHEN TO USE: Only when monnify_charge_card returns status THREE_DS_TRANSACTION_INITIATED. Call this tool with the transactionReference and apiKey from the charge response to obtain the 3DS redirect URL, then direct the customer to that URL to complete authentication on their bank's page.
+
+PREREQUISITES: monnify_charge_card must have been called and returned status THREE_DS_TRANSACTION_INITIATED. Both transactionReference and apiKey from that charge response are required.
+
+SIDE EFFECTS: Prepares the 3DS authentication session on Monnify's end. After the customer completes authentication on the bank's 3DS page, the bank will redirect them back to the merchant's configured redirectUrl. Call monnify_get_transaction_status afterwards to confirm the final payment outcome.
+
+MFA NOTE: 3DS authentication happens entirely on the customer's bank page — the bank issues and validates the OTP or biometric challenge. The merchant does not see the 3DS credential.
+
+KEY OUTPUT FIELDS: redirectUrl (send the customer to this URL to complete 3DS authentication), status, transactionReference, paymentReference, authorizedAmount.`,
+    inputSchema: zodToJsonSchema(AuthoriseCard3dsInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = AuthoriseCard3dsInputSchema.parse(args);
+        const apiKey = parsed.apiKey ?? tryEnv()?.MONNIFY_API_KEY;
+        if (!apiKey) {
+            return {
+                content: [{ type: "text", text: "Validation failed:\n  - apiKey: Required (or configure MONNIFY_API_KEY environment variable)" }],
+                isError: true,
+            };
+        }
+        const result = await apiPost("/api/v1/sdk/cards/secure-3d/authorize", { ...parsed, apiKey });
+        const sanitised = sanitiseAuthoriseCard3dsResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatAuthoriseCard3ds(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_authorise_card_3ds failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, AuthoriseCard3dsInputSchema as inputSchema, handler };
+//# sourceMappingURL=authoriseCard3ds.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authoriseCard3ds.js","sourceRoot":"","sources":["../../../src/tools/collections/authoriseCard3ds.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,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAC/E,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,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE;;;;;;;;;;iKAUkJ;IAC/J,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,CAAC,MAAM,IAAI,MAAM,EAAE,EAAE,eAAe,CAAC;QAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,8FAA8F,EAAE,CAAC;gBACjI,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,uCAAuC,EACvC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CACtB,CAAC;QACF,MAAM,SAAS,GAAG,gCAAgC,CAAC,MAAM,CAAC,CAAC;QAC3D,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,sBAAsB,CAAC,SAAoC,CAAC,EAAE,CAAC;SACtK,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/collections/authoriseCardOtp.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"authoriseCardOtp.d.ts","sourceRoot":"","sources":["../../../src/tools/collections/authoriseCardOtp.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/collections/authoriseCardOtp.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseAuthoriseCardOtpResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatAuthoriseCardOtp } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { AuthoriseCardOtpInputSchema } from "../../schemas/extended/collections.js";
+const definition = {
+    name: "monnify_authorise_card_otp",
+    description: `Completes a card transaction that is awaiting OTP (one-time password) authorisation.
+
+WHEN TO USE: Only when monnify_charge_card returns status OTP_TRANSACTION_INITIATED. Collect the OTP the customer receives via SMS from their bank and pass it here to finalise the payment.
+
+PREREQUISITES: monnify_charge_card must have been called and returned status OTP_TRANSACTION_INITIATED. The customer must have received and provided their bank OTP.
+
+SIDE EFFECTS: Submits the OTP to the card network for verification. A SUCCESS status means the payment is complete. A FAILED status means the OTP was incorrect or expired — the customer must retry the charge.
+
+MFA NOTE: The OTP is issued by the customer's bank, not Monnify. It is typically 6 digits and valid for a short window (1–5 minutes). Never store or log OTP values.
+
+KEY OUTPUT FIELDS: status (SUCCESS or FAILED), transactionReference, paymentReference, authorizedAmount, message.`,
+    inputSchema: zodToJsonSchema(AuthoriseCardOtpInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = AuthoriseCardOtpInputSchema.parse(args);
+        const result = await apiPost("/api/v1/merchant/cards/otp/authorize", parsed);
+        const sanitised = sanitiseAuthoriseCardOtpResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatAuthoriseCardOtp(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_authorise_card_otp failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, AuthoriseCardOtpInputSchema as inputSchema, handler };
+//# sourceMappingURL=authoriseCardOtp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authoriseCardOtp.js","sourceRoot":"","sources":["../../../src/tools/collections/authoriseCardOtp.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,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAC/E,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,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,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;;;;;;;;;;kHAUmG;IAChH,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,OAAO,CAC1B,sCAAsC,EACtC,MAAM,CACP,CAAC;QACF,MAAM,SAAS,GAAG,gCAAgC,CAAC,MAAM,CAAC,CAAC;QAC3D,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,sBAAsB,CAAC,SAAoC,CAAC,EAAE,CAAC;SACtK,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/collections/chargeCard.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"chargeCard.d.ts","sourceRoot":"","sources":["../../../src/tools/collections/chargeCard.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,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,QAAA,MAAM,UAAU,EAAE,IAkBjB,CAAC;AAEF,iBAAe,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA4B5D;AAID,OAAO,EAAE,UAAU,EAAE,qBAAqB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/collections/chargeCard.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseChargeCardResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatChargeCard } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { ChargeCardInputSchema } from "../../schemas/extended/collections.js";
+const definition = {
+    name: "monnify_charge_card",
+    description: `Charges a customer's card against an existing pending transaction using card details collected by the merchant.
+
+WHEN TO USE: After calling monnify_initiate_payment, use this tool to directly charge a card when you have collected card details on your own payment form (not via the checkoutUrl). The transaction must already exist and be in PENDING status.
+
+PREREQUISITES: A pending transaction must already exist — call monnify_initiate_payment first and pass its transactionReference here. Card details and browser deviceInformation must be collected from the customer's browser. Never log or store raw card numbers, CVVs, or PINs.
+
+SIDE EFFECTS: Attempts to charge the card immediately. The response status determines the next step:
+  - SUCCESS → payment is complete, no further action needed
+  - OTP_AUTHORIZATION_REQUIRED → card requires OTP; otpData.message tells the customer where to get it. Collect the OTP and call monnify_authorise_card_otp
+  - BANK_AUTHORIZATION_REQUIRED → card requires 3DS; redirect customer to secure3dData.redirectUrl, then call monnify_authorise_card_3ds
+  - FAILED → charge failed; surface the message to the customer
+
+MFA NOTE: Nigerian-issued cards require card.pin and may also trigger OTP or 3DS. Always handle all three non-SUCCESS statuses.
+
+KEY OUTPUT FIELDS: status (determines next step), transactionReference, paymentReference, authorizedAmount, message, otpData (for OTP flow — contains id and message), secure3dData (for 3DS flow — contains id and redirectUrl).`,
+    inputSchema: zodToJsonSchema(ChargeCardInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = ChargeCardInputSchema.parse(args);
+        const result = await apiPost("/api/v1/merchant/cards/charge", parsed);
+        const sanitised = sanitiseChargeCardResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatChargeCard(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_charge_card failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, ChargeCardInputSchema as inputSchema, handler };
+//# sourceMappingURL=chargeCard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chargeCard.js","sourceRoot":"","sources":["../../../src/tools/collections/chargeCard.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,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,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,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;;;;;;;;;;kOAcmN;IAChO,WAAW,EAAE,eAAe,CAAC,qBAAqB,CAAwB;CAC3E,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,+BAA+B,EAC/B,MAAM,CACP,CAAC;QACF,MAAM,SAAS,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;QACrD,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,gBAAgB,CAAC,SAAoC,CAAC,EAAE,CAAC;SAChK,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,+BAA+B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,qBAAqB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"chargeCardToken.d.ts","sourceRoot":"","sources":["../../../src/tools/collections/chargeCardToken.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,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAGnF,QAAA,MAAM,UAAU,EAAE,IAcjB,CAAC;AAEF,iBAAe,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAwC5D;AAID,OAAO,EAAE,UAAU,EAAE,0BAA0B,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/collections/chargeCardToken.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseChargeCardTokenResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatChargeCardToken } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { ChargeCardTokenInputSchema } from "../../schemas/extended/collections.js";
+import { tryEnv } from "../../config/env.js";
+const definition = {
+    name: "monnify_charge_card_token",
+    description: `Charges a previously tokenized card using its card token, without requiring the customer to re-enter card details.
+
+WHEN TO USE: For recurring or repeat charges on a card the customer has already paid with. The card token is obtained from monnify_get_transaction_status after a previous successful card charge — look for the cardToken field in the response.
+
+PREREQUISITES: A card token from a prior successful charge. Store the cardToken alongside the customerEmail used in that original charge — both are required here. The token is tied to the merchant's contractCode and apiKey.
+
+SIDE EFFECTS: Initiates a real card charge immediately. This is a financial transaction — use a unique paymentReference per charge attempt. The same paymentReference can be safely resubmitted to deduplicate retries without double-charging.
+
+MFA NOTE: Token charges bypass OTP and 3DS — the customer authorised recurring charges when they first paid. Ensure you have the customer's explicit consent to store and reuse their card token.
+
+KEY OUTPUT FIELDS: transactionReference, paymentReference, amountPaid, totalPayable, settlementAmount, paidOn, paymentStatus (PAID | FAILED), paymentMethod, currency.`,
+    inputSchema: zodToJsonSchema(ChargeCardTokenInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = ChargeCardTokenInputSchema.parse(args);
+        const contractCode = parsed.contractCode ?? tryEnv()?.MONNIFY_CONTRACT_CODE;
+        const apiKey = parsed.apiKey ?? tryEnv()?.MONNIFY_API_KEY;
+        if (!contractCode || !apiKey) {
+            const missing = [
+                !contractCode && "  - contractCode: Required (or configure MONNIFY_CONTRACT_CODE environment variable)",
+                !apiKey && "  - apiKey: Required (or configure MONNIFY_API_KEY environment variable)",
+            ].filter(Boolean).join("\n");
+            return {
+                content: [{ type: "text", text: `Validation failed:\n${missing}` }],
+                isError: true,
+            };
+        }
+        const result = await apiPost("/api/v1/merchant/cards/charge-card-token", { ...parsed, contractCode, apiKey });
+        const sanitised = sanitiseChargeCardTokenResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatChargeCardToken(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_charge_card_token failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, ChargeCardTokenInputSchema as inputSchema, handler };
+//# sourceMappingURL=chargeCardToken.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"createInvoice.d.ts","sourceRoot":"","sources":["../../../src/tools/collections/createInvoice.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;AAGjF,QAAA,MAAM,UAAU,EAAE,IAcjB,CAAC;AAEF,iBAAe,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA6B5D;AAID,OAAO,EAAE,UAAU,EAAE,wBAAwB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/collections/createInvoice.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseInvoiceResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatCreateInvoice } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+import { CreateInvoiceInputSchema } from "../../schemas/extended/collections.js";
+import { env } from "../../config/env.js";
+const definition = {
+    name: "monnify_create_invoice",
+    description: `Creates a payment invoice and returns a URL the customer can use to pay.
+
+WHEN TO USE: When you need to send a customer a formal invoice with a fixed amount and expiry date. Suitable for B2B billing, service charges, or any scenario where you want a shareable payment link with a deadline.
+
+PREREQUISITES: None. A Monnify contract code is required.
+
+SIDE EFFECTS: Creates an invoice record on Monnify. The invoice remains active until the expiryDate or until paid. Using the same invoiceReference is safe (idempotent).
+
+MFA NOTE: Not applicable at the invoice creation stage.
+
+KEY OUTPUT FIELDS: invoiceReference, invoiceStatus, checkoutUrl (share with customer), invoiceUrl, offlinePaymentCode, expiryDate, createdOn.`,
+    inputSchema: zodToJsonSchema(CreateInvoiceInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = CreateInvoiceInputSchema.parse(args);
+        const contractCode = parsed.contractCode ?? env().MONNIFY_CONTRACT_CODE;
+        const result = await apiPost("/api/v1/invoice/create", parsed);
+        const sanitised = sanitiseInvoiceResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatCreateInvoice(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_invoice failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, CreateInvoiceInputSchema as inputSchema, handler };
+//# sourceMappingURL=createInvoice.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createInvoice.js","sourceRoot":"","sources":["../../../src/tools/collections/createInvoice.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;AACjF,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAE1C,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE;;;;;;;;;;8IAU+H;IAC5I,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,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,GAAG,EAAE,CAAC,qBAAqB,CAAC;QACxE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,wBAAwB,EACxB,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/collections/deallocateReservedAccount.d.ts

@@ -0,0 +1,14 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import type { McpToolResult } from "../../types/mcp.js";
+declare const InputSchema: z.ZodObject<{
+    accountReference: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    accountReference: string;
+}, {
+    accountReference: string;
+}>;
+declare const definition: Tool;
+declare function handler(args: unknown): Promise<McpToolResult>;
+export { definition, InputSchema as inputSchema, handler };
+//# sourceMappingURL=deallocateReservedAccount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deallocateReservedAccount.d.ts","sourceRoot":"","sources":["../../../src/tools/collections/deallocateReservedAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASxD,QAAA,MAAM,WAAW;;;;;;EAKf,CAAC;AAEH,QAAA,MAAM,UAAU,EAAE,IAcjB,CAAC;AAEF,iBAAe,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAsB5D;AAID,OAAO,EAAE,UAAU,EAAE,WAAW,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/collections/deallocateReservedAccount.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiDelete } from "../../client/monnifyClient.js";
+import { sanitiseDeallocateAccountResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatDeallocateAccount } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+const InputSchema = z.object({
+    accountReference: z
+        .string()
+        .min(1)
+        .describe("The unique reference of the reserved account to permanently remove."),
+});
+const definition = {
+    name: "monnify_deallocate_reserved_account",
+    description: `Permanently deletes a reserved account. The virtual account numbers will no longer accept payments.
+
+WHEN TO USE: When a customer closes their account, a wallet is terminated, or a reserved account is no longer needed. This action is irreversible.
+
+PREREQUISITES: The reserved account must exist and be in an active state.
+
+SIDE EFFECTS: DESTRUCTIVE — permanently removes the reserved account. Any payments sent to the virtual account numbers after deallocation will be rejected or returned. Cannot be undone.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: accountReference, accountName, status (confirms deallocation).`,
+    inputSchema: zodToJsonSchema(InputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = InputSchema.parse(args);
+        const result = await apiDelete(`/api/v1/bank-transfer/reserved-accounts/reference/${encodeURIComponent(parsed.accountReference)}`);
+        const sanitised = sanitiseDeallocateAccountResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatDeallocateAccount(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_deallocate_reserved_account failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, InputSchema as inputSchema, handler };
+//# sourceMappingURL=deallocateReservedAccount.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deallocateReservedAccount.js","sourceRoot":"","sources":["../../../src/tools/collections/deallocateReservedAccount.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAC;AAChF,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,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,qEAAqE,CAAC;CACnF,CAAC,CAAC;AAEH,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE;;;;;;;;;;kFAUmE;IAChF,WAAW,EAAE,eAAe,CAAC,WAAW,CAAwB;CACjE,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,SAAS,CAC5B,qDAAqD,kBAAkB,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CACnG,CAAC;QACF,MAAM,SAAS,GAAG,iCAAiC,CAAC,MAAM,CAAC,CAAC;QAC5D,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,uBAAuB,CAAC,SAAoC,CAAC,EAAE,CAAC;SACvK,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACrI,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,+CAA+C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,WAAW,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

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

@@ -0,0 +1,47 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import type { McpToolResult } from "../../types/mcp.js";
+declare const InputSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    size: z.ZodDefault<z.ZodNumber>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    paymentStatus: z.ZodOptional<z.ZodEnum<["PAID", "PENDING", "CANCELLED", "FAILED"]>>;
+    paymentReference: z.ZodOptional<z.ZodString>;
+    transactionReference: z.ZodOptional<z.ZodString>;
+    customerName: z.ZodOptional<z.ZodString>;
+    customerEmail: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    fromAmount: z.ZodOptional<z.ZodNumber>;
+    toAmount: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    size: number;
+    page: number;
+    transactionReference?: string | undefined;
+    paymentReference?: string | undefined;
+    paymentStatus?: "PAID" | "FAILED" | "CANCELLED" | "PENDING" | undefined;
+    customerEmail?: string | undefined;
+    customerName?: string | undefined;
+    amount?: number | undefined;
+    from?: string | undefined;
+    to?: string | undefined;
+    fromAmount?: number | undefined;
+    toAmount?: number | undefined;
+}, {
+    transactionReference?: string | undefined;
+    paymentReference?: string | undefined;
+    paymentStatus?: "PAID" | "FAILED" | "CANCELLED" | "PENDING" | undefined;
+    customerEmail?: string | undefined;
+    customerName?: string | undefined;
+    amount?: number | undefined;
+    size?: number | undefined;
+    page?: number | undefined;
+    from?: string | undefined;
+    to?: string | undefined;
+    fromAmount?: number | undefined;
+    toAmount?: number | undefined;
+}>;
+declare const definition: Tool;
+declare function handler(args: z.infer<typeof InputSchema>): Promise<McpToolResult>;
+export { definition, InputSchema as inputSchema, handler };
+//# sourceMappingURL=getAllTransactions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAllTransactions.d.ts","sourceRoot":"","sources":["../../../src/tools/collections/getAllTransactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0Df,CAAC;AAEH,QAAA,MAAM,UAAU,EAAE,IAcjB,CAAC;AAEF,iBAAe,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CA0DhF;AAID,OAAO,EAAE,UAAU,EAAE,WAAW,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}