@softeria/ms-365-mcp-server 0.133.2 → 0.134.0

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

@@ -48,6 +48,7 @@ function makeEndpoint(overrides = {}) {
       { name: "search", type: "Query", schema: z.string().optional() },
       { name: "select", type: "Query", schema: z.string().optional() },
       { name: "orderby", type: "Query", schema: z.string().optional() },
+      { name: "expand", type: "Query", schema: z.string().optional() },
       { name: "count", type: "Query", schema: z.boolean().optional() },
       { name: "top", type: "Query", schema: z.number().optional() },
       { name: "skip", type: "Query", schema: z.number().optional() }
@@ -378,6 +379,20 @@ describe("graph-tools", () => {
       expect(schema["top"].description).toContain("Start small");
       expect(schema["top"].description).toContain("$select");
     });
+    it("should describe $expand as navigation-properties-only", async () => {
+      const endpoint = makeEndpoint();
+      const config = makeConfig();
+      mockEndpoints.push(endpoint);
+      mockEndpointsJson = [config];
+      const server = createMockServer();
+      const { registerGraphTools } = await loadModule();
+      registerGraphTools(server, createMockGraphClient());
+      const schema = server.tools.get("test-tool").schema;
+      expect(schema["expand"]).toBeDefined();
+      expect(schema["expand"].description).not.toBe("Expand related entities");
+      expect(schema["expand"].description).toContain("navigation");
+      expect(schema["expand"].description).toContain("attachments");
+    });
   });
   describe("MS365_MCP_MAX_TOP", () => {
     const prevMaxTop = process.env.MS365_MCP_MAX_TOP;

package/dist/graph-tools.js

@@ -1023,6 +1023,12 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
       const key = paramSchema["$select"] !== void 0 ? "$select" : "select";
       paramSchema[key] = z.string().describe("Comma-separated fields to return, e.g. id,subject,from,receivedDateTime").optional();
     }
+    if (paramSchema["expand"] !== void 0 || paramSchema["$expand"] !== void 0) {
+      const key = paramSchema["$expand"] !== void 0 ? "$expand" : "expand";
+      paramSchema[key] = z.array(z.string()).describe(
+        'Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.'
+      ).optional();
+    }
     if (paramSchema["orderby"] !== void 0 || paramSchema["$orderby"] !== void 0) {
       const key = paramSchema["$orderby"] !== void 0 ? "$orderby" : "orderby";
       paramSchema[key] = z.string().describe("Sort expression, e.g. receivedDateTime desc").optional();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softeria/ms-365-mcp-server",
-  "version": "0.133.2",
+  "version": "0.134.0",
   "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",