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

package/dist/generated/client.js

@@ -870,17 +870,39 @@ const microsoft_graph_workbookPivotTable = z.lazy(
   }).strict()
 );
 const microsoft_graph_workbookWorksheetProtectionOptions = z.object({
-  allowAutoFilter: z.boolean().describe("Represents the worksheet protection option of allowing using auto filter feature.").optional(),
-  allowDeleteColumns: z.boolean().describe("Represents the worksheet protection option of allowing deleting columns.").optional(),
-  allowDeleteRows: z.boolean().describe("Represents the worksheet protection option of allowing deleting rows.").optional(),
-  allowFormatCells: z.boolean().describe("Represents the worksheet protection option of allowing formatting cells.").optional(),
-  allowFormatColumns: z.boolean().describe("Represents the worksheet protection option of allowing formatting columns.").optional(),
-  allowFormatRows: z.boolean().describe("Represents the worksheet protection option of allowing formatting rows.").optional(),
-  allowInsertColumns: z.boolean().describe("Represents the worksheet protection option of allowing inserting columns.").optional(),
-  allowInsertHyperlinks: z.boolean().describe("Represents the worksheet protection option of allowing inserting hyperlinks.").optional(),
-  allowInsertRows: z.boolean().describe("Represents the worksheet protection option of allowing inserting rows.").optional(),
-  allowPivotTables: z.boolean().describe("Represents the worksheet protection option of allowing using pivot table feature.").optional(),
-  allowSort: z.boolean().describe("Represents the worksheet protection option of allowing using sort feature.").optional()
+  allowAutoFilter: z.boolean().describe(
+    "Indicates whether the worksheet protection option to allow the use of the autofilter feature is enabled."
+  ).optional(),
+  allowDeleteColumns: z.boolean().describe(
+    "Indicates whether the worksheet protection option to allow deleting columns is enabled."
+  ).optional(),
+  allowDeleteRows: z.boolean().describe(
+    "Indicates whether the worksheet protection option to allow deleting rows is enabled."
+  ).optional(),
+  allowFormatCells: z.boolean().describe(
+    "Indicates whether the worksheet protection option to allow formatting cells is enabled."
+  ).optional(),
+  allowFormatColumns: z.boolean().describe(
+    "Indicates whether the worksheet protection option to allow formatting columns is enabled."
+  ).optional(),
+  allowFormatRows: z.boolean().describe(
+    "Indicates whether the worksheet protection option to allow formatting rows is enabled."
+  ).optional(),
+  allowInsertColumns: z.boolean().describe(
+    "Indicates whether the worksheet protection option to allow inserting columns is enabled."
+  ).optional(),
+  allowInsertHyperlinks: z.boolean().describe(
+    "Indicates whether the worksheet protection option to allow inserting hyperlinks is enabled."
+  ).optional(),
+  allowInsertRows: z.boolean().describe(
+    "Indicates whether the worksheet protection option to allow inserting rows is enabled."
+  ).optional(),
+  allowPivotTables: z.boolean().describe(
+    "Indicates whether the worksheet protection option to allow the use of the pivot table feature is enabled."
+  ).optional(),
+  allowSort: z.boolean().describe(
+    "Indicates whether the worksheet protection option to allow the use of the sort feature is enabled."
+  ).optional()
 }).strict();
 const microsoft_graph_workbookWorksheetProtection = z.object({
   id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
@@ -6326,7 +6348,7 @@ open extensions or extended properties, and how to specify extended properties.`
     method: "delete",
     path: "/me/messages/:messageId",
     alias: "delete-mail-message",
-    description: `Delete a message in the specified user's mailbox, or delete a relationship of the message.`,
+    description: `Delete eventMessage.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6420,9 +6442,8 @@ open extensions or extended properties, and how to specify extended properties.`
     method: "post",
     path: "/me/messages/:messageId/attachments",
     alias: "add-mail-attachment",
-    description: `Use this API to add an attachment to a message. An attachment can be one of the following types: All these types of attachment resources are derived from the attachment
-resource. You can add an attachment to an existing message by posting to its attachments collection, or you can
-add an attachment to a message that is being created and sent on the fly. This operation limits the size of the attachment you can add to under 3 MB.`,
+    description: `Use this API to create a new Attachment. An attachment can be one of the following types: All these types of attachment resources are derived from the attachment
+resource.`,
     requestFormat: "json",
     parameters: [
       {
@@ -7785,7 +7806,8 @@ add an attachment to a message that is being created and sent on the fly. This o
     method: "get",
     path: "/sites",
     alias: "search-sharepoint-sites",
-    description: `Search across a SharePoint tenant for sites that match keywords provided. The only property that works for sorting is createdDateTime. The search filter is a free text search that uses multiple properties when retrieving the search results.`,
+    description: `List all available sites in an organization. Specific filter criteria and query options are also supported and described below: In addition, you can use a $search query against the /sites collection to find sites matching given keywords.
+If you want to list all sites across all geographies, refer to getAllSites. For more guidance about building applications that use site discovery for scanning purposes, see Best practices for discovering files and detecting changes at scale.`,
     requestFormat: "json",
     parameters: [
       {
@@ -8724,7 +8746,7 @@ To monitor future changes, call the delta API by using the @odata.deltaLink in t
     method: "post",
     path: "/teams/:teamId/channels/:channelId/messages",
     alias: "send-channel-message",
-    description: `Send a new chatMessage in the specified channel or a chat.`,
+    description: `Send a new chatMessage in the specified channel.`,
     requestFormat: "json",
     parameters: [
       {
@@ -8861,7 +8883,7 @@ To monitor future changes, call the delta API by using the @odata.deltaLink in t
     method: "get",
     path: "/users",
     alias: "list-users",
-    description: `Retrieve a list of user objects.`,
+    description: `List properties and relationships of the user objects.`,
     requestFormat: "json",
     parameters: [
       {

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",
@@ -85,7 +89,25 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
                   queryParams[fixedParamName] = `${paramValue}`;
                   break;
                 case "Body":
-                  body = paramValue;
+                  if (paramDef.schema) {
+                    const parseResult = paramDef.schema.safeParse(paramValue);
+                    if (!parseResult.success) {
+                      const wrapped = { [paramName]: paramValue };
+                      const wrappedResult = paramDef.schema.safeParse(wrapped);
+                      if (wrappedResult.success) {
+                        logger.info(
+                          `Auto-corrected parameter '${paramName}': AI passed nested field directly, wrapped it as {${paramName}: ...}`
+                        );
+                        body = wrapped;
+                      } else {
+                        body = paramValue;
+                      }
+                    } else {
+                      body = paramValue;
+                    }
+                  } else {
+                    body = paramValue;
+                  }
                   break;
                 case "Header":
                   headers[fixedParamName] = `${paramValue}`;
@@ -111,6 +133,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.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",