@softeria/ms-365-mcp-server 0.19.2 → 0.20.0

package/dist/graph-client.js

@@ -43,14 +43,26 @@ class GraphClient {
         );
       }
       const text = await response.text();
+      let result;
       if (text === "") {
-        return { message: "OK!" };
+        result = { message: "OK!" };
+      } else {
+        try {
+          result = JSON.parse(text);
+        } catch {
+          result = { message: "OK!", rawResponse: text };
+        }
       }
-      try {
-        return JSON.parse(text);
-      } catch {
-        return { message: "OK!", rawResponse: text };
+      if (options.includeHeaders) {
+        const etag = response.headers.get("ETag") || response.headers.get("etag");
+        if (result && typeof result === "object" && !Array.isArray(result)) {
+          return {
+            ...result,
+            _etag: etag || "no-etag-found"
+          };
+        }
       }
+      return result;
     } catch (error) {
       logger.error("Microsoft Graph API request failed:", error);
       throw error;
@@ -96,6 +108,44 @@ class GraphClient {
     }
   }
   formatJsonResponse(data, rawResponse = false) {
+    if (data && typeof data === "object" && "_headers" in data) {
+      const responseData = data;
+      const meta = {};
+      if (responseData._etag) {
+        meta.etag = responseData._etag;
+      }
+      if (responseData._headers) {
+        meta.headers = responseData._headers;
+      }
+      if (rawResponse) {
+        return {
+          content: [{ type: "text", text: JSON.stringify(responseData.data) }],
+          _meta: meta
+        };
+      }
+      if (responseData.data === null || responseData.data === void 0) {
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true }) }],
+          _meta: meta
+        };
+      }
+      const removeODataProps2 = (obj) => {
+        if (typeof obj === "object" && obj !== null) {
+          Object.keys(obj).forEach((key) => {
+            if (key.startsWith("@odata.")) {
+              delete obj[key];
+            } else if (typeof obj[key] === "object") {
+              removeODataProps2(obj[key]);
+            }
+          });
+        }
+      };
+      removeODataProps2(responseData.data);
+      return {
+        content: [{ type: "text", text: JSON.stringify(responseData.data, null, 2) }],
+        _meta: meta
+      };
+    }
     if (rawResponse) {
       return {
         content: [{ type: "text", text: JSON.stringify(data) }]

package/dist/graph-tools.js

@@ -42,6 +42,7 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
     if (tool.method.toUpperCase() === "GET" && tool.path.includes("/")) {
       paramSchema["fetchAllPages"] = z.boolean().describe("Automatically fetch all pages of results").optional();
     }
+    paramSchema["includeHeaders"] = z.boolean().describe("Include response headers (including ETag) in the response metadata").optional();
     server.tool(
       tool.alias,
       tool.description || `Execute ${tool.method.toUpperCase()} request to ${tool.path}`,
@@ -63,6 +64,9 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
             if (paramName === "fetchAllPages") {
               continue;
             }
+            if (paramName === "includeHeaders") {
+              continue;
+            }
             const odataParams = [
               "filter",
               "select",
@@ -111,6 +115,9 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
           if (isProbablyMediaContent) {
             options.rawResponse = true;
           }
+          if (params.includeHeaders === true) {
+            options.includeHeaders = true;
+          }
           logger.info(`Making graph request to ${path2} with options: ${JSON.stringify(options)}`);
           let response = await graphClient.graphRequest(path2, options);
           const fetchAllPages = params.fetchAllPages === true;

package/package.json

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