@carrierllc/mcp 0.2.4 → 0.2.6

package/dist/index.js

@@ -530,13 +530,22 @@ function registerAllTools(server2, ctx) {
     "list_subscribers",
     {
       title: "List Subscribers",
-      description: "Use this to list subscribers with optional filters and pagination. Good for fleet enumeration, bulk status checks, and finding subscribers by account or status. Params: `accountId` (integer, filter by account), `status` (string, e.g. 'ACTIVE'/'SUSPENDED'), `offset` (integer, for pagination \u2014 default 0), `limit` (integer, max results \u2014 always set to avoid unbounded fetches; recommended max 100 per call). Returns: array of subscriber summary records with ICCID, status, and account. Do NOT use this to fetch full details for a specific subscriber \u2014 use `get_subscriber` for that.",
-      inputSchema: {
+      description: "Use this to list subscribers with optional filters and pagination. Good for fleet enumeration, bulk status checks, and finding subscribers by account or status. OCS REQUIRES at least one search key \u2014 provide exactly one of: `imsi`, `iccid`, `activationCode`, `accountId`, or `msisdn`. Calling with no key will be rejected before reaching OCS. Params: `imsi` (string), `iccid` (string), `activationCode` (string), `accountId` (integer), `msisdn` (string), `status` (string, e.g. 'ACTIVE'/'SUSPENDED'), `offset` (integer, pagination \u2014 default 0), `limit` (integer, max results \u2014 always set to avoid unbounded fetches; recommended max 100 per call). Returns: array of subscriber summary records with ICCID, status, and account. Do NOT use this to fetch full details for a specific subscriber \u2014 use `get_subscriber` for that.",
+      inputSchema: z.object({
+        imsi: z.string().optional().describe("Filter by IMSI"),
+        iccid: z.string().optional().describe("Filter by ICCID"),
+        activationCode: z.string().optional().describe("Filter by activation code"),
         accountId: z.number().optional().describe("Filter by account ID"),
+        msisdn: z.string().optional().describe("Filter by MSISDN"),
         status: z.string().optional().describe("Filter by status"),
         offset: z.number().optional().describe("Pagination offset"),
         limit: z.number().optional().describe("Max results to return")
-      },
+      }).refine(
+        (d) => d.imsi !== void 0 || d.iccid !== void 0 || d.activationCode !== void 0 || d.accountId !== void 0 || d.msisdn !== void 0,
+        {
+          message: "Provide at least one of: imsi, iccid, activationCode, accountId, msisdn"
+        }
+      ),
       annotations: { readOnlyHint: true }
     },
     wrapHandler(
@@ -546,7 +555,11 @@ function registerAllTools(server2, ctx) {
       ctx,
       async (args, token2) => {
         const params = {};
+        if (args.imsi) params.imsi = args.imsi;
+        if (args.iccid) params.iccid = args.iccid;
+        if (args.activationCode) params.activationCode = args.activationCode;
         if (args.accountId !== void 0) params.accountId = args.accountId;
+        if (args.msisdn) params.msisdn = args.msisdn;
         if (args.status) params.status = args.status;
         if (args.offset !== void 0) params.offset = args.offset;
         const client = new OcsClient(ctx.env.CARRIER_OCS_BASE_URL, token2);
@@ -3120,9 +3133,11 @@ function registerIntelligenceTools(server2, ctx) {
       safeCall(ctx.env, token2, "listResellerAccount", {})
     ]);
     const sections = ["# Fleet Health Dashboard\n"];
-    if (statusResult.data && Array.isArray(statusResult.data)) {
-      let totalActive = 0, totalSuspended = 0, totalInventory = 0, totalOther = 0;
-      for (const account of statusResult.data) {
+    let totalActive = 0, totalSuspended = 0, totalInventory = 0, totalOther = 0;
+    const statusOk = statusResult.data && Array.isArray(statusResult.data);
+    const statusAccounts = statusOk ? statusResult.data : [];
+    if (statusOk) {
+      for (const account of statusAccounts) {
         totalActive += Number(account.active ?? 0);
         totalSuspended += Number(account.suspended ?? 0);
         totalInventory += Number(account.inventory ?? account.notActivated ?? 0);
@@ -3131,37 +3146,79 @@ function registerIntelligenceTools(server2, ctx) {
       const total = totalActive + totalSuspended + totalInventory + totalOther;
       const utilization = total > 0 ? (totalActive / total * 100).toFixed(1) : "0";
       sections.push(`## eSIM Fleet Status`);
-      sections.push(`| Metric | Count | % |`);
-      sections.push(`|--------|-------|---|`);
-      sections.push(`| Active | ${totalActive} | ${total > 0 ? (totalActive / total * 100).toFixed(1) : 0}% |`);
-      sections.push(`| Suspended | ${totalSuspended} | ${total > 0 ? (totalSuspended / total * 100).toFixed(1) : 0}% |`);
-      sections.push(`| Inventory | ${totalInventory} | ${total > 0 ? (totalInventory / total * 100).toFixed(1) : 0}% |`);
-      sections.push(`| Other | ${totalOther} | ${total > 0 ? (totalOther / total * 100).toFixed(1) : 0}% |`);
-      sections.push(`| **Total** | **${total}** | |`);
-      sections.push(`
-**Fleet Utilization: ${utilization}%**`);
-      if (totalSuspended > totalActive * 0.1) {
+      if (total === 0) {
+        sections.push(`No eSIMs provisioned across ${statusAccounts.length} account(s).`);
+      } else {
+        sections.push(`| Metric | Count | % |`);
+        sections.push(`|--------|-------|---|`);
+        sections.push(`| Active | ${totalActive} | ${(totalActive / total * 100).toFixed(1)}% |`);
+        sections.push(`| Suspended | ${totalSuspended} | ${(totalSuspended / total * 100).toFixed(1)}% |`);
+        sections.push(`| Inventory | ${totalInventory} | ${(totalInventory / total * 100).toFixed(1)}% |`);
+        sections.push(`| Other | ${totalOther} | ${(totalOther / total * 100).toFixed(1)}% |`);
+        sections.push(`| **Total** | **${total}** | |`);
         sections.push(`
-\u26A0 High suspension rate (${totalSuspended} suspended vs ${totalActive} active)`);
+**Fleet Utilization: ${utilization}%**`);
+        if (totalSuspended > totalActive * 0.1) {
+          sections.push(`
+High suspension rate (${totalSuspended} suspended vs ${totalActive} active)`);
+        }
       }
+    } else {
+      sections.push(`## eSIM Fleet Status`);
+      sections.push(`Unavailable: ${statusResult.error ?? "esimStatusPerAccount returned no data"}`);
     }
-    if (accountsResult.data && Array.isArray(accountsResult.data)) {
-      const lowBalance = accountsResult.data.filter(
+    const accountsOk = accountsResult.data && Array.isArray(accountsResult.data);
+    const accounts = accountsOk ? accountsResult.data : [];
+    if (accountsOk) {
+      const lowBalance = accounts.filter(
         (a) => Number(a.balance ?? 0) < 10
       );
+      const packageOnlyZero = accounts.filter(
+        (a) => Boolean(a.packageOnly) && Number(a.balance ?? 0) <= 0
+      );
+      sections.push(`
+## Account Summary`);
+      sections.push(`- Total accounts: ${accounts.length}`);
+      sections.push(`- Low balance (< 10): ${lowBalance.length}`);
+      sections.push(`- Package-only with 0 balance: ${packageOnlyZero.length}`);
       if (lowBalance.length > 0) {
         sections.push(`
-## Low Balance Accounts (< 10)`);
-        sections.push(`| Account | Balance |`);
-        sections.push(`|---------|---------|`);
+### Low Balance Accounts (< 10)`);
+        sections.push(`| Account | Balance | packageOnly |`);
+        sections.push(`|---------|---------|-------------|`);
         for (const a of lowBalance) {
-          sections.push(`| ${a.name ?? a.accountId ?? "?"} | ${Number(a.balance ?? 0).toFixed(2)} |`);
+          sections.push(`| ${a.name ?? a.accountId ?? "?"} | ${Number(a.balance ?? 0).toFixed(2)} | ${a.packageOnly ? "yes" : "no"} |`);
         }
       }
+      const critical = packageOnlyZero.length;
+      const warning = lowBalance.length - critical;
+      const healthy = accounts.length - lowBalance.length;
+      sections.push(`
+## Fleet Health Verdict`);
+      sections.push(`- Healthy: ${healthy}`);
+      sections.push(`- Warning (low balance, not package-only-zero): ${Math.max(warning, 0)}`);
+      sections.push(`- Critical (package-only and 0 balance): ${critical}`);
+      if (accounts.length === 0) {
+        sections.push(`
+No accounts found under this reseller.`);
+      } else if (critical > 0) {
+        sections.push(`
+Action: top up package-only accounts at 0 balance to keep packages assignable.`);
+      } else if (lowBalance.length === 0) {
+        sections.push(`
+All accounts healthy.`);
+      }
+    } else {
       sections.push(`
 ## Account Summary`);
-      sections.push(`- Total accounts: ${accountsResult.data.length}`);
-      sections.push(`- Low balance (< 10): ${lowBalance.length}`);
+      sections.push(`Unavailable: ${accountsResult.error ?? "listResellerAccount returned no data"}`);
+    }
+    if (!statusOk && !accountsOk) {
+      sections.push(`
+## Errors`);
+      if (statusResult.error) sections.push(`- esimStatusPerAccount: ${statusResult.error}`);
+      if (accountsResult.error) sections.push(`- listResellerAccount: ${accountsResult.error}`);
+      return result(sections.join("\n"), true);
     }
     return result(sections.join("\n"));
   });