@monnify/mcp-server 1.0.0

package/build/tools/collections/getAllTransactions.js

@@ -0,0 +1,140 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiGet } from "../../client/monnifyClient.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError, ValidationError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatAllTransactions } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+const InputSchema = z.object({
+    page: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe("Page number (zero-indexed). Default is 0."),
+    size: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(10)
+        .describe("Number of transactions per page. Default is 10, max is 100."),
+    from: z
+        .string()
+        .optional()
+        .describe("Filter start date in ISO 8601 format (YYYY-MM-DDTHH:mm:ss)."),
+    to: z
+        .string()
+        .optional()
+        .describe("Filter end date in ISO 8601 format (YYYY-MM-DDTHH:mm:ss)."),
+    paymentStatus: z
+        .enum(["PAID", "PENDING", "CANCELLED", "FAILED"])
+        .optional()
+        .describe("Filter by payment status."),
+    paymentReference: z
+        .string()
+        .optional()
+        .describe("Filter by your payment reference."),
+    transactionReference: z
+        .string()
+        .optional()
+        .describe("Filter by Monnify transaction reference."),
+    customerName: z
+        .string()
+        .optional()
+        .describe("Filter by customer name."),
+    customerEmail: z
+        .string()
+        .email()
+        .optional()
+        .describe("Filter by customer email address."),
+    amount: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Filter by exact transaction amount in Naira."),
+    fromAmount: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Filter transactions with amount greater than or equal to this value in Naira."),
+    toAmount: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Filter transactions with amount less than or equal to this value in Naira."),
+});
+const definition = {
+    name: "monnify_get_all_transactions",
+    description: `Returns a paginated list of all transactions on your integration, with optional filters.
+
+WHEN TO USE: For reporting, reconciliation, or finding transactions when you have partial information (e.g. date range, customer email, amount range, or status) rather than a specific reference.
+
+PREREQUISITES: None.
+
+SIDE EFFECTS: None. Read-only operation.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: content (array of transactions — each with transactionReference, paymentReference, amountPaid, totalPayable, paymentStatus, paidOn, paymentMethod, currencyCode), totalElements, totalPages, size, number (current page).`,
+    inputSchema: zodToJsonSchema(InputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = InputSchema.parse(args);
+        const result = await apiGet("/api/v1/transactions/search", {
+            page: parsed.page,
+            size: parsed.size,
+            from: parsed.from,
+            to: parsed.to,
+            paymentStatus: parsed.paymentStatus,
+            paymentReference: parsed.paymentReference,
+            transactionReference: parsed.transactionReference,
+            customerName: parsed.customerName,
+            customerEmail: parsed.customerEmail,
+            amount: parsed.amount,
+            fromAmount: parsed.fromAmount,
+            toAmount: parsed.toAmount,
+        });
+        const content = Array.isArray(result["content"]) ? result["content"] : [];
+        const safeContent = content.map((tx) => ({
+            transactionReference: tx["transactionReference"],
+            paymentReference: tx["paymentReference"],
+            amountPaid: tx["amountPaid"],
+            totalPayable: tx["totalPayable"],
+            paymentStatus: tx["paymentStatus"],
+            paidOn: tx["paidOn"],
+            paymentMethod: tx["paymentMethod"],
+            currencyCode: tx["currencyCode"],
+        }));
+        const meta = {
+            totalElements: result["totalElements"],
+            totalPages: result["totalPages"],
+            size: result["size"],
+            number: result["number"],
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: getResponseFormat() === "json"
+                        ? JSON.stringify({ content: safeContent, ...meta }, null, 2)
+                        : formatAllTransactions(safeContent, meta),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        if (error instanceof MonnifyApiError) {
+            return { content: [error.toMcpContent()], isError: true };
+        }
+        if (error instanceof ValidationError) {
+            return { content: [error.toMcpContent()], isError: true };
+        }
+        return errorResult(`monnify_get_all_transactions failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler: (args) => handler(args) });
+export { definition, InputSchema as inputSchema, handler };
+//# sourceMappingURL=getAllTransactions.js.map

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

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

package/build/tools/collections/getReservedAccount.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=getReservedAccount.d.ts.map

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

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

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiGet } from "../../client/monnifyClient.js";
+import { sanitiseReservedAccountDetailsResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatReservedAccountDetails } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+const InputSchema = z.object({
+    accountReference: z
+        .string()
+        .min(1)
+        .describe("The unique reference used when the reserved account was created."),
+});
+const definition = {
+    name: "monnify_get_reserved_account",
+    description: `Returns the details of an existing reserved account including its virtual account numbers.
+
+WHEN TO USE: To look up a reserved account by its reference — e.g. to show a customer their dedicated payment account, confirm the account is still active, or retrieve virtual account numbers for display.
+
+PREREQUISITES: The reserved account must have been created with monnify_reserve_account.
+
+SIDE EFFECTS: None. Read-only operation.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: accountName, accountReference, status, accounts (virtual account numbers per bank), customerName, customerEmail, createdOn.`,
+    inputSchema: zodToJsonSchema(InputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = InputSchema.parse(args);
+        const result = await apiGet(`/api/v2/bank-transfer/reserved-accounts/${encodeURIComponent(parsed.accountReference)}`);
+        const sanitised = sanitiseReservedAccountDetailsResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatReservedAccountDetails(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_reserved_account failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, InputSchema as inputSchema, handler };
+//# sourceMappingURL=getReservedAccount.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getReservedAccount.js","sourceRoot":"","sources":["../../../src/tools/collections/getReservedAccount.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,sCAAsC,EAAE,MAAM,6BAA6B,CAAC;AACrF,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,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,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,kEAAkE,CAAC;CAChF,CAAC,CAAC;AAEH,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE;;;;;;;;;;+IAUgI;IAC7I,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,MAAM,CACzB,2CAA2C,kBAAkB,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CACzF,CAAC;QACF,MAAM,SAAS,GAAG,sCAAsC,CAAC,MAAM,CAAC,CAAC;QACjE,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,4BAA4B,CAAC,SAAoC,CAAC,EAAE,CAAC;SAC5K,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,wCAAwC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9E,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/getReservedAccountTransactions.d.ts

@@ -0,0 +1,20 @@
+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;
+    page: z.ZodDefault<z.ZodNumber>;
+    size: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    accountReference: string;
+    size: number;
+    page: number;
+}, {
+    accountReference: string;
+    size?: number | undefined;
+    page?: number | undefined;
+}>;
+declare const definition: Tool;
+declare function handler(args: unknown): Promise<McpToolResult>;
+export { definition, InputSchema as inputSchema, handler };
+//# sourceMappingURL=getReservedAccountTransactions.d.ts.map

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

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

package/build/tools/collections/getReservedAccountTransactions.js

@@ -0,0 +1,86 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiGet } from "../../client/monnifyClient.js";
+import { sanitiseReservedAccountTransactionsResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatReservedAccountTransactions } 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 fetch transactions for."),
+    page: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe("Page number (zero-indexed). Default is 0."),
+    size: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(10)
+        .describe("Number of transactions per page. Default is 10, max is 100."),
+});
+const definition = {
+    name: "monnify_get_reserved_account_transactions",
+    description: `Returns a paginated list of all transactions received on a reserved account.
+
+WHEN TO USE: To review payment history for a customer's dedicated virtual account — e.g. checking what has been paid into a wallet, reconciling a subscription account, or investigating a missing payment.
+
+PREREQUISITES: The reserved account must exist. Use monnify_get_reserved_account to confirm it is active.
+
+SIDE EFFECTS: None. Read-only operation.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: transactionReference, paymentReference, amountPaid, totalPayable, paymentStatus, paidOn, paymentMethod, currencyCode.`,
+    inputSchema: zodToJsonSchema(InputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = InputSchema.parse(args);
+        const result = await apiGet("/api/v1/bank-transfer/reserved-accounts/transactions", {
+            accountReference: parsed.accountReference,
+            page: parsed.page,
+            size: parsed.size,
+        });
+        const content = Array.isArray(result["content"]) ? result["content"] : [];
+        const sanitised = sanitiseReservedAccountTransactionsResponse(content);
+        const txMeta = {
+            totalElements: result["totalElements"],
+            totalPages: result["totalPages"],
+            number: result["number"],
+            accountReference: parsed.accountReference,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: getResponseFormat() === "json"
+                        ? JSON.stringify({ content: sanitised, ...txMeta }, null, 2)
+                        : formatReservedAccountTransactions(sanitised, txMeta),
+                },
+            ],
+        };
+    }
+    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_reserved_account_transactions failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, InputSchema as inputSchema, handler };
+//# sourceMappingURL=getReservedAccountTransactions.js.map

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

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

package/build/tools/collections/getTransactionDetails.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<{
+    transactionReference: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    transactionReference: string;
+}, {
+    transactionReference: string;
+}>;
+declare const definition: Tool;
+declare function handler(args: unknown): Promise<McpToolResult>;
+export { definition, InputSchema as inputSchema, handler };
+//# sourceMappingURL=getTransactionDetails.d.ts.map

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

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

package/build/tools/collections/getTransactionDetails.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiGet } from "../../client/monnifyClient.js";
+import { sanitiseTransactionStatusResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatTransactionStatus } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+const InputSchema = z.object({
+    transactionReference: z
+        .string()
+        .min(1)
+        .describe("Monnify-generated transaction reference (e.g. 'MNFY|67|20220725111957|000283'). Returned as transactionReference from monnify_initiate_payment or monnify_get_all_transactions."),
+});
+const definition = {
+    name: "monnify_get_transaction_details",
+    description: `Retrieves the full status and details of a transaction directly by its Monnify transaction reference.
+
+WHEN TO USE: When you have the Monnify transactionReference and need to confirm the payment outcome. Use monnify_get_transaction_status if you only have your own paymentReference.
+
+PREREQUISITES: A valid Monnify transactionReference from a prior transaction.
+
+SIDE EFFECTS: None. Read-only operation.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: transactionReference, paymentReference, amountPaid, totalPayable, settledAmount, paidOn, paymentStatus (PAID | PENDING | CANCELLED | FAILED), currencyCode, paymentMethod.`,
+    inputSchema: zodToJsonSchema(InputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = InputSchema.parse(args);
+        const result = await apiGet(`/api/v2/transactions/${encodeURIComponent(parsed.transactionReference)}`);
+        const sanitised = sanitiseTransactionStatusResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatTransactionStatus(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_transaction_details failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, InputSchema as inputSchema, handler };
+//# sourceMappingURL=getTransactionDetails.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getTransactionDetails.js","sourceRoot":"","sources":["../../../src/tools/collections/getTransactionDetails.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,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,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,iLAAiL,CAClL;CACJ,CAAC,CAAC;AAEH,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,iCAAiC;IACvC,WAAW,EAAE;;;;;;;;;;8LAU+K;IAC5L,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,MAAM,CACzB,wBAAwB,kBAAkB,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAC1E,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;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,2CAA2C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjF,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/getTransactionStatus.d.ts

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

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

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

package/build/tools/collections/getTransactionStatus.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiGet } from "../../client/monnifyClient.js";
+import { sanitiseTransactionStatusResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { GetTransactionStatusInputSchema } from "../../schemas/extended/collections.js";
+import { formatTransactionStatus } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+const definition = {
+    name: "monnify_get_transaction_status",
+    description: `Queries the status of a payment transaction.
+
+WHEN TO USE: After initiating a payment to check if it has been completed (paymentStatus = PAID), or when a customer reports a payment issue. Poll this endpoint after the customer's redirect back from checkout.
+
+PREREQUISITES: A transaction must exist — call monnify_initiate_payment first, or have a known paymentReference.
+
+SIDE EFFECTS: None. Read-only operation.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: transactionReference, paymentReference, amountPaid, totalPayable, paymentStatus (PAID | PENDING | CANCELLED | FAILED), paidOn, currencyCode, paymentMethod.`,
+    inputSchema: zodToJsonSchema(GetTransactionStatusInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = GetTransactionStatusInputSchema.parse(args);
+        const result = await apiGet("/api/v2/merchant/transactions/query", {
+            paymentReference: parsed.paymentReference,
+            transactionReference: parsed.transactionReference,
+        });
+        const sanitised = sanitiseTransactionStatusResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatTransactionStatus(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_transaction_status failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, GetTransactionStatusInputSchema as inputSchema, handler };
+//# sourceMappingURL=getTransactionStatus.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getTransactionStatus.js","sourceRoot":"","sources":["../../../src/tools/collections/getTransactionStatus.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,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,+BAA+B,EAAE,MAAM,uCAAuC,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE;;;;;;;;;;+KAUgK;IAC7K,WAAW,EAAE,eAAe,CAAC,+BAA+B,CAAwB;CACrF,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,+BAA+B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,qCAAqC,EACrC;YACE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;SAClD,CACF,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;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,+BAA+B,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

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

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

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

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

package/build/tools/collections/initiatePayment.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseInitiatePaymentResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { InitiatePaymentInputSchema } from "../../schemas/extended/collections.js";
+import { tryEnv } from "../../config/env.js";
+import { formatInitiatePayment } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+const definition = {
+    name: "monnify_initiate_payment",
+    description: `Initiates a payment transaction and returns a checkout URL for the customer.
+
+WHEN TO USE: When a customer needs to make a one-time payment. Returns a checkoutUrl — redirect the customer to this URL to complete payment via card, bank transfer, USSD, or other methods.
+
+PREREQUISITES: None. A Monnify contract code is required (from Dashboard → Settings → Contract Codes).
+
+SIDE EFFECTS: Creates a pending transaction on Monnify. Does not charge the customer — the customer must visit checkoutUrl and complete payment. Providing the same paymentReference again is safe (idempotent — returns the existing transaction).
+
+MFA NOTE: Not applicable at this stage. The customer may encounter card 3DS (OTP) authentication on the checkout page.
+
+KEY OUTPUT FIELDS: transactionReference (Monnify's ref), paymentReference (your ref), checkoutUrl (send this to the customer), enabledPaymentMethod.`,
+    inputSchema: zodToJsonSchema(InitiatePaymentInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = InitiatePaymentInputSchema.parse(args);
+        const contractCode = parsed.contractCode ?? tryEnv()?.MONNIFY_CONTRACT_CODE;
+        if (!contractCode) {
+            return {
+                content: [{ type: "text", text: "Validation failed:\n  - contractCode: Required (or configure MONNIFY_CONTRACT_CODE environment variable)" }],
+                isError: true,
+            };
+        }
+        const result = await apiPost("/api/v1/merchant/transactions/init-transaction", { ...parsed, contractCode });
+        const sanitised = sanitiseInitiatePaymentResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatInitiatePayment(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_initiate_payment failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, InitiatePaymentInputSchema as inputSchema, handler };
+//# sourceMappingURL=initiatePayment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"initiatePayment.js","sourceRoot":"","sources":["../../../src/tools/collections/initiatePayment.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,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,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,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE;;;;;;;;;;qJAUsI;IACnJ,WAAW,EAAE,eAAe,CAAC,0BAA0B,CAAwB;CAChF,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,EAAE,EAAE,qBAAqB,CAAC;QAC5E,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0GAA0G,EAAE,CAAC;gBAC7I,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,gDAAgD,EAChD,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,CAC5B,CAAC;QACF,MAAM,SAAS,GAAG,+BAA+B,CAAC,MAAM,CAAC,CAAC;QAC1D,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,qBAAqB,CAAC,SAAoC,CAAC,EAAE,CAAC;SACrK,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,oCAAoC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,0BAA0B,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

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

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

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

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