@softeria/ms-365-mcp-server 0.116.0 → 0.116.1

package/README.md

@@ -575,7 +575,7 @@ Environment variables:
 - `MS365_MCP_MAX_TOP=<n>`: Hard cap for Graph `$top` / `top` on list requests (positive integer). When the model passes a larger value, the server clamps it to `n` so responses stay smaller. Example: `MS365_MCP_MAX_TOP=15`
 - `MS365_MCP_MAX_PAGES=<n>`: Maximum number of pages followed when a tool is called with `fetchAllPages: true` (positive integer, default `100`). Bounds memory and latency for large result sets.
 - `MS365_MCP_MAX_ITEMS=<n>`: Maximum number of items accumulated when `fetchAllPages: true` (positive integer, default `10000`). Pagination stops and the response is truncated once this many items are collected.
-- `MS365_MCP_ALLOW_PAGINATION=0|false|no`: Disable multi-page following entirely. When set, `fetchAllPages: true` returns only the first page (default: pagination enabled).
+- `MS365_MCP_ALLOW_PAGINATION=0|false|no`: Disable multi-page following entirely. When set, the `fetchAllPages` parameter is not advertised on tools, and any request that still passes it returns only the first page (default: pagination enabled).
 - `MS365_MCP_BODY_FORMAT=html`: Return email bodies as HTML instead of plain text (default: text)
 - `MS365_MCP_CLOUD_TYPE=global|china`: Microsoft cloud environment (alternative to --cloud flag)
 - `LOG_LEVEL`: Set logging level (default: 'info')

package/dist/__tests__/graph-tools.test.js

@@ -252,6 +252,26 @@ describe("graph-tools", () => {
         registerGraphTools(server, graphClient);
         await server.tools.get("test-tool").handler({ fetchAllPages: true });
         expect(graphClient.graphRequest).toHaveBeenCalledTimes(1);
+        expect(server.tools.get("test-tool").schema.fetchAllPages).toBeUndefined();
+      });
+      it("should advertise fetchAllPages when pagination is enabled", async () => {
+        delete process.env.MS365_MCP_ALLOW_PAGINATION;
+        mockEndpoints.push(makeEndpoint());
+        mockEndpointsJson = [makeConfig()];
+        const server = createMockServer();
+        const { registerGraphTools } = await loadModule();
+        registerGraphTools(server, createMockGraphClient());
+        expect(server.tools.get("test-tool").schema.fetchAllPages).toBeDefined();
+      });
+      it("should reflect MS365_MCP_MAX_PAGES in the fetchAllPages description", async () => {
+        process.env.MS365_MCP_MAX_PAGES = "7";
+        mockEndpoints.push(makeEndpoint());
+        mockEndpointsJson = [makeConfig()];
+        const server = createMockServer();
+        const { registerGraphTools } = await loadModule();
+        registerGraphTools(server, createMockGraphClient());
+        const schema = server.tools.get("test-tool").schema.fetchAllPages;
+        expect(schema.description).toContain("up to 7 pages");
       });
     });
   });

package/dist/graph-tools.js

@@ -542,9 +542,10 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
         paramSchema[pathParamName] = z.string().describe(`Path parameter: ${pathParamName}`);
       }
     }
-    if (tool.method.toUpperCase() === "GET" && tool.path.includes("/")) {
+    if (tool.method.toUpperCase() === "GET" && tool.path.includes("/") && paginationAllowed()) {
+      const maxPages = positiveIntFromEnv("MS365_MCP_MAX_PAGES", DEFAULT_MAX_PAGES);
       paramSchema["fetchAllPages"] = z.boolean().describe(
-        "Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads\u2014only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search."
+        `Follow @odata.nextLink and merge up to ${maxPages} pages into one response. Can return enormous payloads\u2014only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.`
       ).optional();
     }
     if (paramSchema["filter"] !== void 0 || paramSchema["$filter"] !== void 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softeria/ms-365-mcp-server",
-  "version": "0.116.0",
+  "version": "0.116.1",
   "description": " A Model Context Protocol (MCP) server for interacting with Microsoft 365 and Office services through the Graph API",
   "type": "module",
   "main": "dist/index.js",