nomba-mcp 1.0.0

package/build/tools/bills/electricity.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall } from "../../utils.js";
+export function registerElectricityTools(server, client) {
+    server.registerTool("nomba_get_electricity_providers", {
+        title: "Get Electricity Providers",
+        description: "Fetch the list of available electricity distribution companies (DisCos). Use this to get provider codes before purchasing electricity tokens.",
+    }, async () => {
+        logToolCall("nomba_get_electricity_providers");
+        try {
+            const result = await client.get("/v1/bills/electricity/providers");
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_lookup_electricity_customer", {
+        title: "Lookup Electricity Customer",
+        description: "Validate an electricity meter number and get the customer's name. Always use this before purchasing electricity to confirm the meter details.",
+        inputSchema: {
+            meterNumber: z.string().describe("The electricity meter number"),
+            providerCode: z
+                .string()
+                .describe("Electricity provider code from nomba_get_electricity_providers"),
+            meterType: z
+                .enum(["prepaid", "postpaid"])
+                .describe("Type of meter: prepaid or postpaid"),
+        },
+    }, async ({ meterNumber, providerCode, meterType }) => {
+        logToolCall("nomba_lookup_electricity_customer", { meterNumber, providerCode, meterType });
+        try {
+            const result = await client.post("/v1/bills/electricity/customer-lookup", { meterNumber, providerCode, meterType });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_buy_electricity", {
+        title: "Buy Electricity",
+        description: "Purchase electricity tokens for a prepaid meter or pay a postpaid electricity bill. Amount is in Naira.",
+        inputSchema: {
+            meterNumber: z.string().describe("The electricity meter number"),
+            providerCode: z.string().describe("Electricity provider code"),
+            meterType: z
+                .enum(["prepaid", "postpaid"])
+                .describe("Type of meter: prepaid or postpaid"),
+            amount: z
+                .number()
+                .positive()
+                .describe("Amount in Naira to pay"),
+        },
+    }, async ({ meterNumber, providerCode, meterType, amount }) => {
+        logToolCall("nomba_buy_electricity", { meterNumber, providerCode, meterType, amount });
+        try {
+            const result = await client.post("/v1/bills/electricity/pay", {
+                meterNumber,
+                providerCode,
+                meterType,
+                amount,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=electricity.js.map

package/build/tools/bills/electricity.js.map

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

package/build/tools/bills/index.d.ts

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

package/build/tools/bills/index.js

@@ -0,0 +1,9 @@
+import { registerElectricityTools } from "./electricity.js";
+import { registerBettingTools } from "./betting.js";
+import { registerCableTools } from "./cable.js";
+export function registerBillTools(server, client) {
+    registerElectricityTools(server, client);
+    registerBettingTools(server, client);
+    registerCableTools(server, client);
+}
+//# sourceMappingURL=index.js.map

package/build/tools/bills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/bills/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,MAAmB;IAEnB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC"}

package/build/tools/bills.d.ts

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

package/build/tools/bills.js

@@ -0,0 +1,246 @@
+import { z } from "zod";
+export function registerBillTools(server, client) {
+    // Electricity
+    server.registerTool("nomba_get_electricity_providers", {
+        title: "Get Electricity Providers",
+        description: "Fetch the list of available electricity distribution companies (DisCos). Use this to get provider codes before purchasing electricity tokens.",
+    }, async () => {
+        try {
+            const result = await client.get("/v1/bills/electricity/providers");
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("nomba_lookup_electricity_customer", {
+        title: "Lookup Electricity Customer",
+        description: "Validate an electricity meter number and get the customer's name. Always use this before purchasing electricity to confirm the meter details.",
+        inputSchema: {
+            meterNumber: z.string().describe("The electricity meter number"),
+            providerCode: z
+                .string()
+                .describe("Electricity provider code from nomba_get_electricity_providers"),
+            meterType: z
+                .enum(["prepaid", "postpaid"])
+                .describe("Type of meter: prepaid or postpaid"),
+        },
+    }, async ({ meterNumber, providerCode, meterType }) => {
+        try {
+            const result = await client.post("/v1/bills/electricity/customer-lookup", { meterNumber, providerCode, meterType });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("nomba_buy_electricity", {
+        title: "Buy Electricity",
+        description: "Purchase electricity tokens for a prepaid meter or pay a postpaid electricity bill. Amount is in Naira.",
+        inputSchema: {
+            meterNumber: z.string().describe("The electricity meter number"),
+            providerCode: z.string().describe("Electricity provider code"),
+            meterType: z
+                .enum(["prepaid", "postpaid"])
+                .describe("Type of meter: prepaid or postpaid"),
+            amount: z
+                .number()
+                .positive()
+                .describe("Amount in Naira to pay"),
+        },
+    }, async ({ meterNumber, providerCode, meterType, amount }) => {
+        try {
+            const result = await client.post("/v1/bills/electricity/pay", {
+                meterNumber,
+                providerCode,
+                meterType,
+                amount,
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Betting
+    server.registerTool("nomba_get_betting_providers", {
+        title: "Get Betting Providers",
+        description: "Fetch the list of available betting platforms. Use this to get provider codes before funding a betting account.",
+    }, async () => {
+        try {
+            const result = await client.get("/v1/bills/betting/providers");
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("nomba_fund_betting_account", {
+        title: "Fund Betting Account",
+        description: "Fund a customer's betting account on a supported betting platform. Amount is in Naira.",
+        inputSchema: {
+            customerId: z
+                .string()
+                .describe("The customer's betting account ID/username"),
+            providerCode: z.string().describe("Betting provider code"),
+            amount: z
+                .number()
+                .positive()
+                .describe("Amount in Naira to fund"),
+        },
+    }, async ({ customerId, providerCode, amount }) => {
+        try {
+            const result = await client.post("/v1/bills/betting/pay", {
+                customerId,
+                providerCode,
+                amount,
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Cable TV
+    server.registerTool("nomba_get_cable_providers", {
+        title: "Get Cable TV Providers",
+        description: "Fetch the list of available cable TV providers (e.g., DSTV, GOtv, Startimes). Use this to get provider codes before paying for a cable subscription.",
+    }, async () => {
+        try {
+            const result = await client.get("/v1/bills/cabletv/providers");
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("nomba_lookup_cable_customer", {
+        title: "Lookup Cable TV Customer",
+        description: "Validate a cable TV smartcard/IUC number and get the customer's name. Always use this before paying for a cable subscription.",
+        inputSchema: {
+            smartcardNumber: z
+                .string()
+                .describe("The smartcard or IUC number"),
+            providerCode: z.string().describe("Cable TV provider code"),
+        },
+    }, async ({ smartcardNumber, providerCode }) => {
+        try {
+            const result = await client.post("/v1/bills/cabletv/customer-lookup", { smartcardNumber, providerCode });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("nomba_pay_cable_subscription", {
+        title: "Pay Cable TV Subscription",
+        description: "Pay for a cable TV subscription (DSTV, GOtv, Startimes, etc.). Amount is in Naira.",
+        inputSchema: {
+            smartcardNumber: z
+                .string()
+                .describe("The smartcard or IUC number"),
+            providerCode: z.string().describe("Cable TV provider code"),
+            productCode: z
+                .string()
+                .describe("The subscription plan/bouquet code"),
+            amount: z
+                .number()
+                .positive()
+                .describe("Amount in Naira to pay"),
+        },
+    }, async ({ smartcardNumber, providerCode, productCode, amount }) => {
+        try {
+            const result = await client.post("/v1/bills/cabletv/pay", {
+                smartcardNumber,
+                providerCode,
+                productCode,
+                amount,
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=bills.js.map

package/build/tools/bills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bills.js","sourceRoot":"","sources":["../../src/tools/bills.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,MAAmB;IAEnB,cAAc;IACd,MAAM,CAAC,YAAY,CACjB,iCAAiC,EACjC;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,+IAA+I;KAClJ,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;YACnE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAW,KAAe,CAAC,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mCAAmC,EACnC;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,+IAA+I;QACjJ,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YAChE,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,CACP,gEAAgE,CACjE;YACH,SAAS,EAAE,CAAC;iBACT,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;iBAC7B,QAAQ,CAAC,oCAAoC,CAAC;SAClD;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,uCAAuC,EACvC,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,CACzC,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAW,KAAe,CAAC,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,yGAAyG;QAC3G,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YAChE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YAC9D,SAAS,EAAE,CAAC;iBACT,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;iBAC7B,QAAQ,CAAC,oCAAoC,CAAC;YACjD,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,wBAAwB,CAAC;SACtC;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;QACzD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;gBAC5D,WAAW;gBACX,YAAY;gBACZ,SAAS;gBACT,MAAM;aACP,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAW,KAAe,CAAC,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,UAAU;IACV,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,iHAAiH;KACpH,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;YAC/D,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAW,KAAe,CAAC,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,wFAAwF;QAC1F,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,4CAA4C,CAAC;YACzD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAC1D,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,yBAAyB,CAAC;SACvC;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;gBACxD,UAAU;gBACV,YAAY;gBACZ,MAAM;aACP,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAW,KAAe,CAAC,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,WAAW;IACX,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,sJAAsJ;KACzJ,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;YAC/D,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAW,KAAe,CAAC,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,+HAA+H;QACjI,WAAW,EAAE;YACX,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,QAAQ,CAAC,6BAA6B,CAAC;YAC1C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SAC5D;KACF,EACD,KAAK,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,mCAAmC,EACnC,EAAE,eAAe,EAAE,YAAY,EAAE,CAClC,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAW,KAAe,CAAC,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,8BAA8B,EAC9B;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,oFAAoF;QACtF,WAAW,EAAE;YACX,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,QAAQ,CAAC,6BAA6B,CAAC;YAC1C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YAC3D,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,oCAAoC,CAAC;YACjD,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,wBAAwB,CAAC;SACtC;KACF,EACD,KAAK,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE;QAC/D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;gBACxD,eAAe;gBACf,YAAY;gBACZ,WAAW;gBACX,MAAM;aACP,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAW,KAAe,CAAC,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/checkout.d.ts

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

package/build/tools/checkout.js

@@ -0,0 +1,138 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall } from "../utils.js";
+export function registerCheckoutTools(server, client) {
+    server.registerTool("nomba_create_checkout_order", {
+        title: "Create Checkout Order",
+        description: 
+        // Nomba is NGN-only
+        "Create a checkout payment order and get a payment link. The customer can use this link to pay via card, bank transfer, or USSD. Amount is in Naira (NGN).",
+        inputSchema: {
+            amount: z.number().positive().describe("Payment amount in Naira"),
+            customerEmail: z
+                .string()
+                .email()
+                .describe("Customer's email address"),
+            callbackUrl: z
+                .string()
+                .url()
+                .describe("URL to redirect the customer to after payment"),
+            orderReference: z
+                .string()
+                .optional()
+                .describe("Your unique order reference/ID"),
+            customerId: z
+                .string()
+                .optional()
+                .describe("Your internal customer identifier"),
+            tokenizeCard: z
+                .boolean()
+                .optional()
+                .describe("Whether to save the customer's card for future charges"),
+        },
+    }, async ({ amount, customerEmail, callbackUrl, orderReference, customerId, tokenizeCard, }) => {
+        logToolCall("nomba_create_checkout_order", { amount, customerEmail });
+        try {
+            const result = await client.post("/v1/checkout/order", {
+                order: {
+                    amount,
+                    currency: "NGN", // Nomba is NGN-only
+                    customerEmail,
+                    callbackUrl,
+                    orderReference,
+                    customerId,
+                },
+                tokenizeCard,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_charge_tokenized_card", {
+        title: "Charge Tokenized Card",
+        description: "Charge a previously saved/tokenized card. Use this for recurring payments or returning customers who saved their card during checkout.",
+        inputSchema: {
+            amount: z.number().positive().describe("Amount in Naira to charge"),
+            tokenizedCardId: z
+                .string()
+                .describe("The tokenized card ID from a previous checkout"),
+            customerEmail: z
+                .string()
+                .email()
+                .describe("Customer's email address"),
+        },
+    }, async ({ amount, tokenizedCardId, customerEmail }) => {
+        logToolCall("nomba_charge_tokenized_card", { amount, customerEmail });
+        try {
+            const result = await client.post("/v1/checkout/charge-tokenized-card", { amount, tokenizedCardId, customerEmail });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_refund_transaction", {
+        title: "Refund Transaction",
+        description: "Process a refund for a completed checkout transaction. You can do a full or partial refund by specifying the amount.",
+        inputSchema: {
+            transactionId: z
+                .string()
+                .describe("The transaction ID to refund"),
+            amount: z
+                .number()
+                .positive()
+                .optional()
+                .describe("Amount to refund in Naira. Omit for full refund."),
+        },
+    }, async ({ transactionId, amount }) => {
+        logToolCall("nomba_refund_transaction", { transactionId, amount });
+        try {
+            const body = { transactionId };
+            if (amount !== undefined)
+                body.amount = amount;
+            const result = await client.post("/v1/checkout/refund", body);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_get_checkout_transaction", {
+        title: "Get Checkout Transaction Details",
+        description: "Retrieve the details and status of a checkout transaction by its order reference.",
+        inputSchema: {
+            orderReference: z
+                .string()
+                .describe("The order reference from the checkout order creation"),
+        },
+    }, async ({ orderReference }) => {
+        logToolCall("nomba_get_checkout_transaction", { orderReference });
+        try {
+            const result = await client.get(`/v1/checkout/order/${orderReference}`);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_cancel_transaction", {
+        title: "Cancel Checkout Transaction",
+        description: "Cancel an incomplete/pending checkout transaction. Only works for transactions that have not been completed.",
+        inputSchema: {
+            orderReference: z
+                .string()
+                .describe("The order reference of the transaction to cancel"),
+        },
+    }, async ({ orderReference }) => {
+        logToolCall("nomba_cancel_transaction", { orderReference });
+        try {
+            const result = await client.post("/v1/checkout/cancel-transaction", { orderReference });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=checkout.js.map

package/build/tools/checkout.js.map

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

package/build/tools/sub-accounts.d.ts

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