@carrierllc/mcp 0.13.12 → 0.13.13

package/dist/index.js

@@ -63,6 +63,7 @@ import {
   recurringPackageParams,
   renderHtml,
   repairPlanFor,
+  scopeListSubscriberParams,
   staleActivePackages,
   storefrontClerkUrls,
   subscriberIdParams,
@@ -73,7 +74,7 @@ import {
   verifyStorefront,
   withOcsListSummary,
   withTemplateResellerId
-} from "./chunk-IQDAU7WA.js";
+} from "./chunk-OJITGTFO.js";
 import "./chunk-SHKKVIIA.js";
 
 // src/index.ts
@@ -1512,7 +1513,7 @@ 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. 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: `{ summary, subscriberList: [...] }` \u2014 subscriber summary records with ICCID, status and account, behind a server-counted `summary.total` (rows returned) and `summary.breakdown.status`. Answer 'how many' from `summary`, not by counting rows \u2014 but when `summary.moreAvailable` is set this is one page, so report `summary.upstreamTotal` for the fleet-wide figure, never `total`. Do NOT use this to fetch full details for a specific subscriber \u2014 use `get_subscriber` for that.",
+      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 needs a search key: `imsi`, `iccid`, `activationCode`, `accountId` or `msisdn`. With none, Carrier scopes the call to this organization's default account (its preferred_account_id, else the lowest-id account under its reseller) and says so in `default_account`. If no account can be found the call fails with an error \u2014 it never returns an empty list. 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: `{ summary, subscriberList: [...] }` \u2014 subscriber summary records with ICCID, status and account, behind a server-counted `summary.total` (rows returned) and `summary.breakdown.status`. Answer 'how many' from `summary`, not by counting rows \u2014 but when `summary.moreAvailable` is set this is one page, so report `summary.upstreamTotal` for the fleet-wide figure, never `total`. 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"),
@@ -1522,12 +1523,7 @@ function registerAllTools(server2, ctx) {
         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(
@@ -1538,13 +1534,25 @@ function registerAllTools(server2, ctx) {
       async (args, token2) => {
         const params = buildListSubscriberParams(args);
         const client2 = new OcsClient(ctx.env.CARRIER_OCS_BASE_URL, token2);
-        const raw = await client2.call("listSubscriber", params);
+        const scope = await scopeListSubscriberParams({
+          params,
+          ...ctx.managedAuth.managed ? { managed: true } : {},
+          ...ctx.managedAuth.preferredAccountId ? { preferredAccountId: ctx.managedAuth.preferredAccountId } : {},
+          call: (method, callParams) => client2.call(method, callParams)
+        });
+        if (!scope.ok) throw new Error(scope.message);
+        const raw = await client2.call("listSubscriber", scope.params);
         const payload = applySubscriberFilters(raw, args);
+        const summarised = withOcsListSummary(payload, "subscribers");
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(withOcsListSummary(payload, "subscribers"), null, 2)
+              text: JSON.stringify(
+                scope.defaultAccount ? { ...summarised, default_account: scope.defaultAccount } : summarised,
+                null,
+                2
+              )
             }
           ]
         };