@monnify/mcp-server 1.0.0

package/build/tools/registry.js

@@ -0,0 +1,15 @@
+import { McpToolError } from "../utils/errors.js";
+const registry = new Map();
+export function registerTool(entry) {
+    registry.set(entry.definition.name, entry);
+}
+export function getAllToolDefinitions() {
+    return [...registry.values()].map((e) => e.definition);
+}
+export async function dispatchTool(name, args) {
+    const entry = registry.get(name);
+    if (!entry)
+        throw new McpToolError(name, new Error(`Unknown tool: ${name}`));
+    return entry.handler(args);
+}
+//# sourceMappingURL=registry.js.map

package/build/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;AAE9C,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,IAAa;IAEb,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,YAAY,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/build/tools/utilities/getSupportedBanks.d.ts

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

package/build/tools/utilities/getSupportedBanks.d.ts.map

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

package/build/tools/utilities/getSupportedBanks.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiGet } from "../../client/monnifyClient.js";
+import { sanitiseBankListResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError, ValidationError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { formatSupportedBanks } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+const InputSchema = z.object({});
+const definition = {
+    name: "monnify_get_supported_banks",
+    description: `Returns all Nigerian banks supported by Monnify for payments and verification.
+
+WHEN TO USE: Before calling monnify_verify_bank_account, monnify_create_mandate, or monnify_process_refund to look up the correct 3-digit bank code for a given bank name. Also useful to present bank choices to users.
+
+PREREQUISITES: None.
+
+SIDE EFFECTS: None. Read-only operation.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: name (bank display name), code (3-digit bank code used in other API calls).`,
+    inputSchema: zodToJsonSchema(InputSchema),
+};
+async function handler(_args) {
+    try {
+        InputSchema.parse(_args);
+        const banks = await apiGet("/api/v1/banks");
+        const sanitised = sanitiseBankListResponse(Array.isArray(banks) ? banks : []);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatSupportedBanks(sanitised) }],
+        };
+    }
+    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_supported_banks failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler: (args) => handler(args) });
+export { definition, InputSchema as inputSchema, handler };
+//# sourceMappingURL=getSupportedBanks.js.map

package/build/tools/utilities/getSupportedBanks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSupportedBanks.js","sourceRoot":"","sources":["../../../src/tools/utilities/getSupportedBanks.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,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEjC,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE;;;;;;;;;;+FAUgF;IAC7F,WAAW,EAAE,eAAe,CAAC,WAAW,CAAwB;CACjE,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,KAAkC;IACvD,IAAI,CAAC;QACH,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAiC,eAAe,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAG,wBAAwB,CACxC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAClC,CAAC;QACF,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,SAA2C,CAAC,EAAE,CAAC;SAC3K,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,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,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,uCAAuC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAmC,CAAC,EAAE,CAAC,CAAC;AAE9F,OAAO,EAAE,UAAU,EAAE,WAAW,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

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

package/build/tools/utilities/getTransactionList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTransactionList.d.ts","sourceRoot":"","sources":["../../../src/tools/utilities/getTransactionList.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;AAMxD,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,CA4DhF;AAID,OAAO,EAAE,UAAU,EAAE,WAAW,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/utilities/getTransactionList.js

@@ -0,0 +1,136 @@
+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";
+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_transaction_list",
+    description: `Search and list transactions with optional filters.
+
+WHEN TO USE: For reporting, reconciliation, or finding a specific transaction when you have partial information (e.g. customer email or date range but not the full reference).
+
+PREREQUISITES: None.
+
+SIDE EFFECTS: None. Read-only operation.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: content (array of transactions), 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"],
+        }));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        content: safeContent,
+                        totalElements: result["totalElements"],
+                        totalPages: result["totalPages"],
+                        size: result["size"],
+                        number: result["number"],
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    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_transaction_list failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler: (args) => handler(args) });
+export { definition, InputSchema as inputSchema, handler };
+//# sourceMappingURL=getTransactionList.js.map

package/build/tools/utilities/getTransactionList.js.map

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

package/build/tools/verification/verifyBankAccount.d.ts

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

package/build/tools/verification/verifyBankAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyBankAccount.d.ts","sourceRoot":"","sources":["../../../src/tools/verification/verifyBankAccount.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,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAItF,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,4BAA4B,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/verification/verifyBankAccount.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiGet } from "../../client/monnifyClient.js";
+import { sanitiseBankAccountResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { VerifyBankAccountInputSchema } from "../../schemas/extended/verification.js";
+import { formatBankAccountVerification } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+const definition = {
+    name: "monnify_verify_bank_account",
+    description: `Verifies a Nigerian bank account number and returns the account holder name.
+
+WHEN TO USE: Before initiating a refund, creating a direct debit mandate, or confirming account details provided by a user. Always verify account details before committing them to a mandate or refund.
+
+PREREQUISITES: None. Call monnify_get_supported_banks first to look up the correct bankCode.
+
+SIDE EFFECTS: None. Read-only — does not move any funds or create any records.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: accountName (name of account holder), accountNumber, bankCode, bankName.`,
+    inputSchema: zodToJsonSchema(VerifyBankAccountInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = VerifyBankAccountInputSchema.parse(args);
+        const result = await apiGet("/api/v1/disbursements/account/validate", {
+            accountNumber: parsed.accountNumber,
+            bankCode: parsed.bankCode,
+        });
+        const sanitised = sanitiseBankAccountResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatBankAccountVerification(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_verify_bank_account failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, VerifyBankAccountInputSchema as inputSchema, handler };
+//# sourceMappingURL=verifyBankAccount.js.map

package/build/tools/verification/verifyBankAccount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyBankAccount.js","sourceRoot":"","sources":["../../../src/tools/verification/verifyBankAccount.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,EAAmB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE;;;;;;;;;;4FAU6E;IAC1F,WAAW,EAAE,eAAe,CAAC,4BAA4B,CAAwB;CAClF,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,4BAA4B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,wCAAwC,EACxC;YACE,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CACF,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,6BAA6B,CAAC,SAAoC,CAAC,EAAE,CAAC;SAC7K,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,uCAAuC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,4BAA4B,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/verification/verifyBvn.d.ts

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

package/build/tools/verification/verifyBvn.d.ts.map

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

package/build/tools/verification/verifyBvn.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseBvnResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { VerifyBvnInputSchema } from "../../schemas/extended/verification.js";
+import { formatBvnVerification } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+const definition = {
+    name: "monnify_verify_bvn",
+    description: `Verifies that a customer's BVN details match the provided name, date of birth, and phone number.
+
+WHEN TO USE: For KYC (Know Your Customer) verification flows, onboarding with identity checks, or before creating a direct debit mandate where BVN validation is required.
+
+PREREQUISITES: None. Requires Monnify Identity Verification API access to be enabled on your account.
+
+SIDE EFFECTS: None. Read-only — does not store any data.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: bvn, nameMatch (boolean), mobileNoMatch (boolean), dateOfBirthMatch (boolean). A result of true means the provided value matches the BVN record.`,
+    inputSchema: zodToJsonSchema(VerifyBvnInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = VerifyBvnInputSchema.parse(args);
+        const result = await apiPost("/api/v1/vas/bvn-details-match", parsed);
+        const sanitised = sanitiseBvnResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatBvnVerification(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_verify_bvn failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, VerifyBvnInputSchema as inputSchema, handler };
+//# sourceMappingURL=verifyBvn.js.map

package/build/tools/verification/verifyBvn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyBvn.js","sourceRoot":"","sources":["../../../src/tools/verification/verifyBvn.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,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,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,wCAAwC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;;;;;;;;;;oKAUqJ;IAClK,WAAW,EAAE,eAAe,CAAC,oBAAoB,CAAwB;CAC1E,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,+BAA+B,EAC/B,MAAM,CACP,CAAC;QACF,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC9C,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,8BAA8B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,oBAAoB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/verification/verifyBvnInfo.d.ts

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

package/build/tools/verification/verifyBvnInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyBvnInfo.d.ts","sourceRoot":"","sources":["../../../src/tools/verification/verifyBvnInfo.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,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAIlF,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/verification/verifyBvnInfo.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseBvnInfoResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { VerifyBvnInfoInputSchema } from "../../schemas/extended/verification.js";
+import { formatBvnInfo } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+const definition = {
+    name: "monnify_verify_bvn_info",
+    description: `Verifies whether the provided name, date of birth, and mobile number match the BVN record, returning a single boolean result.
+
+WHEN TO USE: When you need a holistic match check against a BVN — all supplied details must match for bvnInformationMatch to be true. Useful for onboarding flows, KYC, and direct debit mandate validation.
+
+PREREQUISITES: None. Requires Monnify Identity Verification API access enabled on your account. Live environment only — costs ₦10 per successful request.
+
+SIDE EFFECTS: None. Read-only — does not store any data.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: bvn, name, dateOfBirth, mobileNo, bvnInformationMatch (boolean — true if all provided details match the BVN record).`,
+    inputSchema: zodToJsonSchema(VerifyBvnInfoInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = VerifyBvnInfoInputSchema.parse(args);
+        const result = await apiPost("/api/v1/vas/bvn-details-match", parsed);
+        const sanitised = sanitiseBvnInfoResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatBvnInfo(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_verify_bvn_info failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, VerifyBvnInfoInputSchema as inputSchema, handler };
+//# sourceMappingURL=verifyBvnInfo.js.map

package/build/tools/verification/verifyBvnInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyBvnInfo.js","sourceRoot":"","sources":["../../../src/tools/verification/verifyBvnInfo.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,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE;;;;;;;;;;wIAUyH;IACtI,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,+BAA+B,EAC/B,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,aAAa,CAAC,SAAoC,CAAC,EAAE,CAAC;SAC7J,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,wBAAwB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/tools/verification/verifyNin.d.ts

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

package/build/tools/verification/verifyNin.d.ts.map

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

package/build/tools/verification/verifyNin.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { apiPost } from "../../client/monnifyClient.js";
+import { sanitiseNinResponse } from "../../security/sanitiser.js";
+import { registerTool } from "../registry.js";
+import { MonnifyApiError } from "../../utils/errors.js";
+import { errorResult } from "../../types/mcp.js";
+import { VerifyNinInputSchema } from "../../schemas/extended/verification.js";
+import { formatNinVerification } from "../../utils/format.js";
+import { getResponseFormat } from "../../utils/clientContext.js";
+const definition = {
+    name: "monnify_verify_nin",
+    description: `Verifies a customer's National Identification Number (NIN) by matching it against the provided name and date of birth.
+
+WHEN TO USE: For strong identity verification flows where NIN is required, such as high-value onboarding, compliance checks, or regulatory KYC requirements that mandate NIN validation.
+
+PREREQUISITES: None. Requires Monnify Identity Verification API access enabled on your account. Live environment only — costs ₦60 per successful request.
+
+SIDE EFFECTS: None. Read-only — does not store any data.
+
+MFA NOTE: Not applicable.
+
+KEY OUTPUT FIELDS: nin, firstName, lastName, dateOfBirth, gender, phoneNumber, ninInformationMatch (boolean — true if the provided name and date of birth match the NIN record).`,
+    inputSchema: zodToJsonSchema(VerifyNinInputSchema),
+};
+async function handler(args) {
+    try {
+        const parsed = VerifyNinInputSchema.parse(args);
+        const result = await apiPost("/api/v1/vas/nin-details", parsed);
+        const sanitised = sanitiseNinResponse(result);
+        return {
+            content: [{ type: "text", text: getResponseFormat() === "json" ? JSON.stringify(sanitised, null, 2) : formatNinVerification(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_verify_nin failed: ${String(error)}`);
+    }
+}
+registerTool({ definition, handler });
+export { definition, VerifyNinInputSchema as inputSchema, handler };
+//# sourceMappingURL=verifyNin.js.map

package/build/tools/verification/verifyNin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyNin.js","sourceRoot":"","sources":["../../../src/tools/verification/verifyNin.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,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,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,wCAAwC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,UAAU,GAAS;IACvB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;;;;;;;;;;iLAUkK;IAC/K,WAAW,EAAE,eAAe,CAAC,oBAAoB,CAAwB;CAC1E,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAa;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,yBAAyB,EACzB,MAAM,CACP,CAAC;QACF,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC9C,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,8BAA8B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,oBAAoB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/build/transport/http.d.ts

@@ -0,0 +1,3 @@
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare function startHttpTransport(server: Server): Promise<void>;
+//# sourceMappingURL=http.d.ts.map

package/build/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAuCxE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCtE"}