nomba-mcp 1.0.0

package/build/tools/sub-accounts.js

@@ -0,0 +1,174 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall, buildParams, } from "../utils.js";
+export function registerSubAccountTools(server, client) {
+    server.registerTool("nomba_create_sub_account", {
+        title: "Create Sub-Account",
+        description: "Create a new sub-account under the parent Nomba account. Sub-accounts can have their own balances and make transactions.",
+        inputSchema: {
+            accountName: z
+                .string()
+                .describe("Name for the sub-account"),
+            email: z
+                .string()
+                .email()
+                .optional()
+                .describe("Email address for the sub-account holder"),
+            phoneNumber: z
+                .string()
+                .optional()
+                .describe("Phone number for the sub-account holder"),
+        },
+    }, async ({ accountName, email, phoneNumber }) => {
+        logToolCall("nomba_create_sub_account", { accountName });
+        try {
+            const body = { accountName };
+            if (email)
+                body.email = email;
+            if (phoneNumber)
+                body.phoneNumber = phoneNumber;
+            const result = await client.post("/v1/accounts", body);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_list_sub_accounts", {
+        title: "List Sub-Accounts",
+        description: "List all sub-accounts under the parent Nomba account. Supports pagination.",
+        inputSchema: {
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(50)
+                .optional()
+                .describe("Number of results per page (max 50)"),
+            cursor: z
+                .string()
+                .optional()
+                .describe("Pagination cursor from a previous response"),
+        },
+    }, async ({ limit, cursor }) => {
+        logToolCall("nomba_list_sub_accounts", { limit, cursor });
+        try {
+            const params = buildParams({ limit, cursor });
+            const result = await client.get("/v1/accounts", params);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_get_sub_account", {
+        title: "Get Sub-Account",
+        description: "Fetch details of a specific sub-account by its account ID.",
+        inputSchema: {
+            accountId: z
+                .string()
+                .describe("The sub-account ID"),
+        },
+    }, async ({ accountId }) => {
+        logToolCall("nomba_get_sub_account", { accountId });
+        try {
+            const result = await client.get(`/v1/accounts/${accountId}`);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_get_sub_account_balance", {
+        title: "Get Sub-Account Balance",
+        description: "Fetch the current balance of a specific sub-account. Returns available balance in NGN.",
+        inputSchema: {
+            accountId: z
+                .string()
+                .describe("The sub-account ID"),
+        },
+    }, async ({ accountId }) => {
+        logToolCall("nomba_get_sub_account_balance", { accountId });
+        try {
+            const result = await client.get(`/v1/accounts/${accountId}/balance`);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_update_sub_account", {
+        title: "Update Sub-Account",
+        description: "Update the details of an existing sub-account.",
+        inputSchema: {
+            accountId: z
+                .string()
+                .describe("The sub-account ID to update"),
+            accountName: z
+                .string()
+                .optional()
+                .describe("New account name"),
+            email: z
+                .string()
+                .email()
+                .optional()
+                .describe("New email address"),
+            phoneNumber: z
+                .string()
+                .optional()
+                .describe("New phone number"),
+        },
+    }, async ({ accountId, accountName, email, phoneNumber }) => {
+        logToolCall("nomba_update_sub_account", { accountId });
+        try {
+            const body = {};
+            if (accountName)
+                body.accountName = accountName;
+            if (email)
+                body.email = email;
+            if (phoneNumber)
+                body.phoneNumber = phoneNumber;
+            const result = await client.put(`/v1/accounts/${accountId}`, body);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_suspend_sub_account", {
+        title: "Suspend Sub-Account",
+        description: "Suspend a sub-account. Suspended accounts cannot make or receive transactions.",
+        inputSchema: {
+            accountId: z
+                .string()
+                .describe("The sub-account ID to suspend"),
+        },
+    }, async ({ accountId }) => {
+        logToolCall("nomba_suspend_sub_account", { accountId });
+        try {
+            const result = await client.put(`/v1/accounts/${accountId}/suspend`, {});
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_reactivate_sub_account", {
+        title: "Reactivate Sub-Account",
+        description: "Reactivate a previously suspended sub-account.",
+        inputSchema: {
+            accountId: z
+                .string()
+                .describe("The sub-account ID to reactivate"),
+        },
+    }, async ({ accountId }) => {
+        logToolCall("nomba_reactivate_sub_account", { accountId });
+        try {
+            const result = await client.put(`/v1/accounts/${accountId}/reactivate`, {});
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=sub-accounts.js.map

package/build/tools/sub-accounts.js.map

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

package/build/tools/transactions.d.ts

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

package/build/tools/transactions.js

@@ -0,0 +1,115 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall, buildParams } from "../utils.js";
+export function registerTransactionTools(server, client) {
+    server.registerTool("nomba_list_bank_transactions", {
+        title: "List Bank Transactions",
+        description: "Fetch bank transactions for the parent Nomba account. Supports filtering by date range and pagination. Returns transaction amounts, types (CREDIT/DEBIT), statuses, and metadata.",
+        inputSchema: {
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(50)
+                .optional()
+                .describe("Number of results per page (max 50)"),
+            cursor: z
+                .string()
+                .optional()
+                .describe("Pagination cursor from a previous response"),
+            dateFrom: z
+                .string()
+                .optional()
+                .describe("Start date in UTC format (e.g., 2024-01-01T00:00:00Z)"),
+            dateTo: z
+                .string()
+                .optional()
+                .describe("End date in UTC format (e.g., 2024-12-31T23:59:59Z)"),
+        },
+    }, async ({ limit, cursor, dateFrom, dateTo }) => {
+        logToolCall("nomba_list_bank_transactions", { limit, dateFrom, dateTo });
+        try {
+            const params = buildParams({ limit, cursor, dateFrom, dateTo });
+            const result = await client.get("/v1/transactions/bank", params);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_requery_transaction", {
+        title: "Requery Transaction",
+        description: "Requery/check the status of a specific transaction using its session ID. Useful for verifying if a transfer or payment was successful.",
+        inputSchema: {
+            sessionId: z
+                .string()
+                .describe("The session ID of the transaction to requery"),
+        },
+    }, async ({ sessionId }) => {
+        logToolCall("nomba_requery_transaction", { sessionId });
+        try {
+            const result = await client.post("/v1/transactions/accounts", { sessionId });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_get_transaction", {
+        title: "Get Transaction Details",
+        description: "Fetch details of a single transaction by its transaction ID.",
+        inputSchema: {
+            transactionId: z
+                .string()
+                .describe("The transaction ID to look up"),
+        },
+    }, async ({ transactionId }) => {
+        logToolCall("nomba_get_transaction", { transactionId });
+        try {
+            const result = await client.get(`/v1/transactions/${transactionId}`);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_filter_transactions", {
+        title: "Filter Transactions",
+        description: "Filter transactions on the parent account with advanced filters. Supports filtering by type (CREDIT/DEBIT), date range, and pagination.",
+        inputSchema: {
+            type: z
+                .enum(["CREDIT", "DEBIT"])
+                .optional()
+                .describe("Filter by transaction type: CREDIT or DEBIT"),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(50)
+                .optional()
+                .describe("Number of results per page (max 50)"),
+            cursor: z
+                .string()
+                .optional()
+                .describe("Pagination cursor from a previous response"),
+            dateFrom: z
+                .string()
+                .optional()
+                .describe("Start date in UTC format (e.g., 2024-01-01T00:00:00Z)"),
+            dateTo: z
+                .string()
+                .optional()
+                .describe("End date in UTC format (e.g., 2024-12-31T23:59:59Z)"),
+        },
+    }, async ({ type, limit, cursor, dateFrom, dateTo }) => {
+        logToolCall("nomba_filter_transactions", { type, limit, dateFrom, dateTo });
+        try {
+            const params = buildParams({ type, limit, cursor, dateFrom, dateTo });
+            const result = await client.get("/v1/transactions/filter", params);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=transactions.js.map

package/build/tools/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../src/tools/transactions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEpF,MAAM,UAAU,wBAAwB,CACtC,MAAiB,EACjB,MAAmB;IAEnB,MAAM,CAAC,YAAY,CACjB,8BAA8B,EAC9B;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,mLAAmL;QACrL,WAAW,EAAE;YACX,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CAAC,qCAAqC,CAAC;YAClD,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4CAA4C,CAAC;YACzD,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,uDAAuD,CAAC;YACpE,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;SACnE;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5C,WAAW,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;YACjE,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,2BAA2B,EAC3B;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,wIAAwI;QAC1I,WAAW,EAAE;YACX,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,CAAC,8CAA8C,CAAC;SAC5D;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,WAAW,CAAC,2BAA2B,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,2BAA2B,EAC3B,EAAE,SAAS,EAAE,CACd,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,uBAAuB,EACvB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,8DAA8D;QAChE,WAAW,EAAE;YACX,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,CAAC,+BAA+B,CAAC;SAC7C;KACF,EACD,KAAK,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE;QAC1B,WAAW,CAAC,uBAAuB,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAC7B,oBAAoB,aAAa,EAAE,CACpC,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,2BAA2B,EAC3B;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,yIAAyI;QAC3I,WAAW,EAAE;YACX,IAAI,EAAE,CAAC;iBACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;iBACzB,QAAQ,EAAE;iBACV,QAAQ,CAAC,6CAA6C,CAAC;YAC1D,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CAAC,qCAAqC,CAAC;YAClD,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4CAA4C,CAAC;YACzD,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,uDAAuD,CAAC;YACpE,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;SACnE;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;QAClD,WAAW,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YACtE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;YACnE,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/transfers.d.ts

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

package/build/tools/transfers.js

@@ -0,0 +1,97 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall } from "../utils.js";
+export function registerTransferTools(server, client) {
+    server.registerTool("nomba_list_banks", {
+        title: "List Bank Codes",
+        description: "Fetch the list of all Nigerian bank codes and names. Use this before making bank transfers to get the correct bankCode for the recipient's bank.",
+    }, async () => {
+        logToolCall("nomba_list_banks");
+        try {
+            const result = await client.get("/v1/transfers/banks");
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_lookup_bank_account", {
+        title: "Lookup Bank Account",
+        description: "Validate a bank account by looking up the account holder's name. Always call this before initiating a bank transfer to confirm the recipient is correct.",
+        inputSchema: {
+            accountNumber: z
+                .string()
+                .length(10)
+                .describe("10-digit Nigerian bank account number"),
+            bankCode: z
+                .string()
+                .describe("Bank code obtained from the nomba_list_banks tool"),
+        },
+    }, async ({ accountNumber, bankCode }) => {
+        logToolCall("nomba_lookup_bank_account", { accountNumber, bankCode });
+        try {
+            const result = await client.post("/v1/transfers/bank-account-lookup", { accountNumber, bankCode });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_transfer_to_bank", {
+        title: "Transfer to Bank Account",
+        description: 
+        // Nomba is NGN-only
+        "Transfer funds from the Nomba account to an external Nigerian bank account. Amount is in Naira (NGN). Always use nomba_lookup_bank_account first to verify the recipient.",
+        inputSchema: {
+            amount: z.number().positive().describe("Amount in Naira to transfer"),
+            accountNumber: z
+                .string()
+                .length(10)
+                .describe("Recipient 10-digit bank account number"),
+            bankCode: z.string().describe("Recipient bank code"),
+            narration: z
+                .string()
+                .optional()
+                .describe("Transfer description/narration"),
+        },
+    }, async ({ amount, accountNumber, bankCode, narration }) => {
+        logToolCall("nomba_transfer_to_bank", { amount, accountNumber, bankCode });
+        try {
+            const result = await client.post("/v1/transfers/to-banks", {
+                amount,
+                accountNumber,
+                bankCode,
+                narration,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_transfer_between_accounts", {
+        title: "Transfer Between Nomba Accounts",
+        description: 
+        // Nomba is NGN-only
+        "Transfer funds between two Nomba accounts (e.g., parent to sub-account or between sub-accounts). Amount is in Naira (NGN).",
+        inputSchema: {
+            amount: z.number().positive().describe("Amount in Naira to transfer"),
+            destinationAccountId: z
+                .string()
+                .describe("Destination Nomba account ID (UUID)"),
+            narration: z
+                .string()
+                .optional()
+                .describe("Transfer description/narration"),
+        },
+    }, async ({ amount, destinationAccountId, narration }) => {
+        logToolCall("nomba_transfer_between_accounts", { amount, destinationAccountId });
+        try {
+            const result = await client.post("/v1/transfers/between-accounts", { amount, destinationAccountId, narration });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=transfers.js.map

package/build/tools/transfers.js.map

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

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

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

package/build/tools/virtual-accounts.js

@@ -0,0 +1,131 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall, buildParams } from "../utils.js";
+export function registerVirtualAccountTools(server, client) {
+    server.registerTool("nomba_create_virtual_account", {
+        title: "Create Virtual Account",
+        description: "Create a new virtual bank account under the parent Nomba account. Virtual accounts can receive bank transfers and are useful for collecting payments from specific customers.",
+        inputSchema: {
+            accountName: z
+                .string()
+                .min(8)
+                .max(64)
+                .describe("Name for the virtual account holder (8-64 characters)"),
+            accountRef: z
+                .string()
+                .min(16)
+                .max(64)
+                .optional()
+                .describe("Your unique reference for this account (16-64 characters)"),
+        },
+    }, async ({ accountName, accountRef }) => {
+        logToolCall("nomba_create_virtual_account", { accountName });
+        try {
+            const body = { accountName };
+            if (accountRef)
+                body.accountRef = accountRef;
+            const result = await client.post("/v1/accounts/virtual", body);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_get_virtual_account", {
+        title: "Get Virtual Account",
+        description: "Fetch details of a specific virtual account by its account ID. Returns account name, bank details, status, and balance.",
+        inputSchema: {
+            accountId: z
+                .string()
+                .describe("The virtual account ID (UUID)"),
+        },
+    }, async ({ accountId }) => {
+        logToolCall("nomba_get_virtual_account", { accountId });
+        try {
+            const result = await client.get(`/v1/accounts/virtual/${accountId}`);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_update_virtual_account", {
+        title: "Update Virtual Account",
+        description: "Update the details of an existing virtual account, such as the account name or callback URL.",
+        inputSchema: {
+            accountId: z
+                .string()
+                .describe("The virtual account ID (UUID) to update"),
+            accountName: z
+                .string()
+                .min(8)
+                .max(64)
+                .optional()
+                .describe("New account name (8-64 characters)"),
+            callbackUrl: z
+                .string()
+                .url()
+                .optional()
+                .describe("Webhook URL for payment notifications on this account"),
+        },
+    }, async ({ accountId, accountName, callbackUrl }) => {
+        logToolCall("nomba_update_virtual_account", { accountId });
+        try {
+            const body = {};
+            if (accountName)
+                body.accountName = accountName;
+            if (callbackUrl)
+                body.callbackUrl = callbackUrl;
+            const result = await client.patch(`/v1/accounts/virtual/${accountId}`, body);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_expire_virtual_account", {
+        title: "Expire Virtual Account",
+        description: "Expire/deactivate a virtual account so it can no longer receive payments. This action cannot be undone.",
+        inputSchema: {
+            accountId: z
+                .string()
+                .describe("The virtual account ID (UUID) to expire"),
+        },
+    }, async ({ accountId }) => {
+        logToolCall("nomba_expire_virtual_account", { accountId });
+        try {
+            const result = await client.post(`/v1/accounts/virtual/${accountId}/expire`, {});
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("nomba_list_virtual_accounts", {
+        title: "List Virtual Accounts",
+        description: "List all virtual accounts under the parent Nomba account. Supports pagination with limit and cursor.",
+        inputSchema: {
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(50)
+                .optional()
+                .describe("Number of results per page (max 50)"),
+            cursor: z
+                .string()
+                .optional()
+                .describe("Pagination cursor from a previous response"),
+        },
+    }, async ({ limit, cursor }) => {
+        logToolCall("nomba_list_virtual_accounts", { limit, cursor });
+        try {
+            const params = buildParams({ limit, cursor });
+            const result = await client.get("/v1/accounts/virtual", params);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=virtual-accounts.js.map

package/build/tools/virtual-accounts.js.map

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

package/build/utils.d.ts

@@ -0,0 +1,18 @@
+export declare const TOKEN_BUFFER_MS = 60000;
+export declare const MAX_PAGE_SIZE = 50;
+export declare const CACHE_TTL_MS: number;
+export declare function jsonResponse(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function errorResponse(error: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
+export declare function buildParams(obj: Record<string, unknown>): Record<string, string>;
+export declare function logToolCall(tool: string, params?: Record<string, unknown>): void;

package/build/utils.js

@@ -0,0 +1,35 @@
+export const TOKEN_BUFFER_MS = 60_000;
+export const MAX_PAGE_SIZE = 50;
+export const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24h
+export function jsonResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+export function errorResponse(error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return {
+        content: [{ type: "text", text: `Error: ${msg}` }],
+        isError: true,
+    };
+}
+export function buildParams(obj) {
+    const params = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (v !== undefined && v !== null)
+            params[k] = String(v);
+    }
+    return params;
+}
+export function logToolCall(tool, params) {
+    const sanitized = { ts: new Date().toISOString(), tool };
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            sanitized[k] = typeof v === "string" && v.length > 100
+                ? v.slice(0, 20) + "..."
+                : v;
+        }
+    }
+    console.error(JSON.stringify(sanitized));
+}
+//# sourceMappingURL=utils.js.map

package/build/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AACtC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,MAAM;AAEvD,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC;QAC3D,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,GAA4B;IAE5B,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAgC;IACxE,MAAM,SAAS,GAA4B,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC;IAClF,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG;gBACpD,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK;gBACxB,CAAC,CAAC,CAAC,CAAC;QACR,CAAC;IACH,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;AAC3C,CAAC"}