nomba-mcp 1.0.0

package/build/client.d.ts

@@ -0,0 +1,26 @@
+interface NombaClientConfig {
+    baseUrl: string;
+    clientId: string;
+    clientSecret: string;
+    accountId: string;
+}
+export declare class NombaApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly description: string;
+    constructor(status: number, code: string, description: string);
+}
+export declare class NombaClient {
+    private config;
+    private tokenData;
+    private tokenPromise;
+    constructor(config: NombaClientConfig);
+    private issueToken;
+    private ensureToken;
+    request<T = unknown>(method: string, path: string, body?: unknown, params?: Record<string, string>, _retry?: boolean): Promise<T>;
+    get<T = unknown>(path: string, params?: Record<string, string>): Promise<T>;
+    post<T = unknown>(path: string, body: unknown): Promise<T>;
+    put<T = unknown>(path: string, body: unknown): Promise<T>;
+    patch<T = unknown>(path: string, body: unknown): Promise<T>;
+}
+export {};

package/build/client.js

@@ -0,0 +1,120 @@
+import { TOKEN_BUFFER_MS } from "./utils.js";
+export class NombaApiError extends Error {
+    status;
+    code;
+    description;
+    constructor(status, code, description) {
+        super(`Nomba API error (${status}): ${code} - ${description}`);
+        this.name = "NombaApiError";
+        this.status = status;
+        this.code = code;
+        this.description = description;
+    }
+}
+function parseApiError(status, body) {
+    try {
+        const parsed = JSON.parse(body);
+        const code = parsed?.code ?? "UNKNOWN";
+        const description = parsed?.description ?? parsed?.message ?? "Unknown error";
+        return new NombaApiError(status, code, description);
+    }
+    catch {
+        // Don't expose raw body — it may contain echoed credentials
+        return new NombaApiError(status, "UNKNOWN", `HTTP ${status} error`);
+    }
+}
+export class NombaClient {
+    config;
+    tokenData = null;
+    tokenPromise = null;
+    constructor(config) {
+        this.config = config;
+        if (!config.baseUrl.startsWith("https://")) {
+            console.error("WARNING: NOMBA_BASE_URL does not use HTTPS. Credentials may be exposed in transit.");
+        }
+    }
+    async issueToken() {
+        const url = `${this.config.baseUrl}/v1/auth/token/issue`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                accountId: this.config.accountId,
+            },
+            body: JSON.stringify({
+                grant_type: "client_credentials",
+                client_id: this.config.clientId,
+                client_secret: this.config.clientSecret,
+            }),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            // Never expose credentials in error messages
+            throw parseApiError(response.status, errorBody);
+        }
+        const result = (await response.json());
+        this.tokenData = {
+            accessToken: result.data.access_token,
+            refreshToken: result.data.refresh_token,
+            expiresAt: new Date(result.data.expiresAt),
+        };
+    }
+    async ensureToken() {
+        if (this.tokenData &&
+            this.tokenData.expiresAt >= new Date(Date.now() + TOKEN_BUFFER_MS)) {
+            return this.tokenData.accessToken;
+        }
+        if (!this.tokenPromise) {
+            this.tokenPromise = this.issueToken().finally(() => {
+                this.tokenPromise = null;
+            });
+        }
+        await this.tokenPromise;
+        return this.tokenData.accessToken;
+    }
+    async request(method, path, body, params, _retry = false) {
+        const token = await this.ensureToken();
+        const url = new URL(path, this.config.baseUrl);
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                url.searchParams.set(k, v);
+            }
+        }
+        const response = await fetch(url.toString(), {
+            method,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                accountId: this.config.accountId,
+                "Content-Type": "application/json",
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            // On 401, clear token and retry once
+            if (response.status === 401 && !_retry) {
+                this.tokenData = null;
+                return this.request(method, path, body, params, true);
+            }
+            const errorBody = await response.text();
+            throw parseApiError(response.status, errorBody);
+        }
+        const json = await response.json();
+        if (json == null) {
+            throw new NombaApiError(response.status, "EMPTY_RESPONSE", "API returned empty response");
+        }
+        return json;
+    }
+    async get(path, params) {
+        return this.request("GET", path, undefined, params);
+    }
+    async post(path, body) {
+        return this.request("POST", path, body);
+    }
+    async put(path, body) {
+        return this.request("PUT", path, body);
+    }
+    async patch(path, body) {
+        return this.request("PATCH", path, body);
+    }
+}
+//# sourceMappingURL=client.js.map

package/build/client.js.map

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

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { NombaClient } from "./client.js";
+import { registerAccountTools } from "./tools/accounts.js";
+import { registerTransferTools } from "./tools/transfers.js";
+import { registerCheckoutTools } from "./tools/checkout.js";
+import { registerVirtualAccountTools } from "./tools/virtual-accounts.js";
+import { registerTransactionTools } from "./tools/transactions.js";
+import { registerBillTools } from "./tools/bills/index.js";
+import { registerAirtimeTools } from "./tools/airtime.js";
+import { registerSubAccountTools } from "./tools/sub-accounts.js";
+import { registerBankListResource } from "./resources/bank-list.js";
+const NOMBA_CLIENT_ID = process.env.NOMBA_CLIENT_ID;
+const NOMBA_CLIENT_SECRET = process.env.NOMBA_CLIENT_SECRET;
+const NOMBA_ACCOUNT_ID = process.env.NOMBA_ACCOUNT_ID;
+const NOMBA_BASE_URL = process.env.NOMBA_BASE_URL || "https://sandbox.nomba.com";
+if (!NOMBA_CLIENT_ID || !NOMBA_CLIENT_SECRET || !NOMBA_ACCOUNT_ID) {
+    console.error("Missing required environment variables: NOMBA_CLIENT_ID, NOMBA_CLIENT_SECRET, NOMBA_ACCOUNT_ID");
+    process.exit(1);
+}
+if (NOMBA_BASE_URL.includes("api.nomba.com")) {
+    console.error("WARNING: Running against PRODUCTION Nomba API");
+}
+const nombaClient = new NombaClient({
+    baseUrl: NOMBA_BASE_URL,
+    clientId: NOMBA_CLIENT_ID,
+    clientSecret: NOMBA_CLIENT_SECRET,
+    accountId: NOMBA_ACCOUNT_ID,
+});
+const server = new McpServer({
+    name: "nomba-mcp",
+    version: "1.0.0",
+});
+registerAccountTools(server, nombaClient);
+registerTransferTools(server, nombaClient);
+registerCheckoutTools(server, nombaClient);
+registerVirtualAccountTools(server, nombaClient);
+registerTransactionTools(server, nombaClient);
+registerBillTools(server, nombaClient);
+registerAirtimeTools(server, nombaClient);
+registerSubAccountTools(server, nombaClient);
+registerBankListResource(server, nombaClient);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Nomba MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AACpD,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AAC5D,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;AACtD,MAAM,cAAc,GAClB,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,2BAA2B,CAAC;AAE5D,IAAI,CAAC,eAAe,IAAI,CAAC,mBAAmB,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAClE,OAAO,CAAC,KAAK,CACX,gGAAgG,CACjG,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;IAClC,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,eAAe;IACzB,YAAY,EAAE,mBAAmB;IACjC,SAAS,EAAE,gBAAgB;CAC5B,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC1C,qBAAqB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC3C,qBAAqB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC3C,2BAA2B,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACjD,wBAAwB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC9C,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACvC,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC1C,uBAAuB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC7C,wBAAwB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE9C,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACrD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/resources/bank-list.d.ts

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

package/build/resources/bank-list.js

@@ -0,0 +1,26 @@
+import { CACHE_TTL_MS } from "../utils.js";
+export function registerBankListResource(server, client) {
+    let cache = null;
+    server.registerResource("bank-list", "nomba://banks", {
+        description: "List of all Nigerian bank codes and names. Cached for 24 hours.",
+        mimeType: "application/json",
+    }, async () => {
+        if (!cache || Date.now() >= cache.expiresAt) {
+            const result = await client.get("/v1/transfers/banks");
+            cache = {
+                data: JSON.stringify(result, null, 2),
+                expiresAt: Date.now() + CACHE_TTL_MS,
+            };
+        }
+        return {
+            contents: [
+                {
+                    uri: "nomba://banks",
+                    mimeType: "application/json",
+                    text: cache.data,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=bank-list.js.map

package/build/resources/bank-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank-list.js","sourceRoot":"","sources":["../../src/resources/bank-list.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,UAAU,wBAAwB,CACtC,MAAiB,EACjB,MAAmB;IAEnB,IAAI,KAAK,GAA+C,IAAI,CAAC;IAE7D,MAAM,CAAC,gBAAgB,CACrB,WAAW,EACX,eAAe,EACf;QACE,WAAW,EACT,iEAAiE;QACnE,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACvD,KAAK,GAAG;gBACN,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY;aACrC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,eAAe;oBACpB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;iBACjB;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/accounts.d.ts

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

package/build/tools/accounts.js

@@ -0,0 +1,88 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall } from "../utils.js";
+export function registerAccountTools(server, client) {
+    server.registerTool("nomba_get_parent_account", {
+        title: "Get Parent Account",
+        description: "Fetch the parent account details for the authenticated Nomba business. Returns account ID, name, type, status, BVN, and linked bank accounts.",
+    }, async () => {
+        logToolCall("nomba_get_parent_account");
+        try {
+            const result = await client.get("/v1/accounts/parent");
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_get_parent_balance", {
+        title: "Get Parent Account Balance",
+        description: "Fetch the current balance of the parent Nomba business account. Returns available balance in NGN.",
+    }, async () => {
+        logToolCall("nomba_get_parent_balance");
+        try {
+            const result = await client.get("/v1/accounts/parent/balance");
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_list_terminals", {
+        title: "List Terminals",
+        description: "List all POS terminals assigned to the parent Nomba account. Returns terminal IDs, serial numbers, and labels.",
+    }, async () => {
+        logToolCall("nomba_list_terminals");
+        try {
+            const result = await client.get("/v1/accounts/terminals");
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_assign_terminal", {
+        title: "Assign Terminal",
+        description: "Assign a POS terminal to the parent Nomba account.",
+        inputSchema: {
+            terminalId: z
+                .string()
+                .describe("The terminal ID to assign"),
+            serialNumber: z
+                .string()
+                .describe("The terminal serial number"),
+        },
+    }, async ({ terminalId, serialNumber }) => {
+        logToolCall("nomba_assign_terminal", { terminalId, serialNumber });
+        try {
+            const result = await client.post("/v1/terminals/assign", {
+                terminalId,
+                serialNumber,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_unassign_terminal", {
+        title: "Unassign Terminal",
+        description: "Unassign a POS terminal from the parent Nomba account.",
+        inputSchema: {
+            terminalId: z
+                .string()
+                .describe("The terminal ID to unassign"),
+        },
+    }, async ({ terminalId }) => {
+        logToolCall("nomba_unassign_terminal", { terminalId });
+        try {
+            const result = await client.post("/v1/terminals/unassign", {
+                terminalId,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=accounts.js.map

package/build/tools/accounts.js.map

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

package/build/tools/airtime.d.ts

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

package/build/tools/airtime.js

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall } from "../utils.js";
+export function registerAirtimeTools(server, client) {
+    server.registerTool("nomba_buy_airtime", {
+        title: "Buy Airtime",
+        description: "Purchase airtime/credit for a Nigerian phone number. Amount is in Naira. Supports all major networks (MTN, Airtel, Glo, 9mobile).",
+        inputSchema: {
+            phoneNumber: z
+                .string()
+                .describe("Nigerian phone number (e.g., 08012345678 or 2348012345678)"),
+            amount: z
+                .number()
+                .positive()
+                .describe("Amount of airtime in Naira"),
+            network: z
+                .string()
+                .optional()
+                .describe("Network provider (e.g., MTN, AIRTEL, GLO, 9MOBILE). Auto-detected if omitted."),
+        },
+    }, async ({ phoneNumber, amount, network }) => {
+        logToolCall("nomba_buy_airtime", { phoneNumber, amount, network });
+        try {
+            const body = { phoneNumber, amount };
+            if (network)
+                body.network = network;
+            const result = await client.post("/v1/bills/airtime/pay", body);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_list_data_plans", {
+        title: "List Data Plans",
+        description: "Fetch available data bundle plans for a specific network provider. Returns plan names, data amounts, prices, and plan codes needed for purchasing.",
+        inputSchema: {
+            network: z
+                .string()
+                .describe("Network provider (e.g., MTN, AIRTEL, GLO, 9MOBILE)"),
+        },
+    }, async ({ network }) => {
+        logToolCall("nomba_list_data_plans", { network });
+        try {
+            const result = await client.get("/v1/bills/data/plans", { network });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_buy_data", {
+        title: "Buy Data Bundle",
+        description: "Purchase a data bundle for a Nigerian phone number. Use nomba_list_data_plans first to get available plans and their codes.",
+        inputSchema: {
+            phoneNumber: z
+                .string()
+                .describe("Nigerian phone number (e.g., 08012345678 or 2348012345678)"),
+            dataPlanCode: z
+                .string()
+                .describe("Data plan code from nomba_list_data_plans"),
+            network: z
+                .string()
+                .describe("Network provider (e.g., MTN, AIRTEL, GLO, 9MOBILE)"),
+        },
+    }, async ({ phoneNumber, dataPlanCode, network }) => {
+        logToolCall("nomba_buy_data", { phoneNumber, dataPlanCode, network });
+        try {
+            const result = await client.post("/v1/bills/data/pay", {
+                phoneNumber,
+                dataPlanCode,
+                network,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=airtime.js.map

package/build/tools/airtime.js.map

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

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

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

package/build/tools/bills/betting.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall } from "../../utils.js";
+export function registerBettingTools(server, client) {
+    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 () => {
+        logToolCall("nomba_get_betting_providers");
+        try {
+            const result = await client.get("/v1/bills/betting/providers");
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    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 }) => {
+        logToolCall("nomba_fund_betting_account", { customerId, providerCode, amount });
+        try {
+            const result = await client.post("/v1/bills/betting/pay", {
+                customerId,
+                providerCode,
+                amount,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=betting.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"betting.js","sourceRoot":"","sources":["../../../src/tools/bills/betting.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE1E,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,MAAmB;IAEnB,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,iHAAiH;KACpH,EACD,KAAK,IAAI,EAAE;QACT,WAAW,CAAC,6BAA6B,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;YAC/D,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,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,WAAW,CAAC,4BAA4B,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;QAChF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;gBACxD,UAAU;gBACV,YAAY;gBACZ,MAAM;aACP,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

package/build/tools/bills/cable.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall } from "../../utils.js";
+export function registerCableTools(server, client) {
+    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 () => {
+        logToolCall("nomba_get_cable_providers");
+        try {
+            const result = await client.get("/v1/bills/cabletv/providers");
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    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 }) => {
+        logToolCall("nomba_lookup_cable_customer", { smartcardNumber, providerCode });
+        try {
+            const result = await client.post("/v1/bills/cabletv/customer-lookup", { smartcardNumber, providerCode });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    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 }) => {
+        logToolCall("nomba_pay_cable_subscription", { smartcardNumber, providerCode, productCode, amount });
+        try {
+            const result = await client.post("/v1/bills/cabletv/pay", {
+                smartcardNumber,
+                providerCode,
+                productCode,
+                amount,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=cable.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cable.js","sourceRoot":"","sources":["../../../src/tools/bills/cable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE1E,MAAM,UAAU,kBAAkB,CAChC,MAAiB,EACjB,MAAmB;IAEnB,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,sJAAsJ;KACzJ,EACD,KAAK,IAAI,EAAE;QACT,WAAW,CAAC,2BAA2B,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;YAC/D,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,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,WAAW,CAAC,6BAA6B,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,mCAAmC,EACnC,EAAE,eAAe,EAAE,YAAY,EAAE,CAClC,CAAC;YACF,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,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,WAAW,CAAC,8BAA8B,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACpG,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,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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