@softeria/ms-365-mcp-server 0.131.3 → 0.132.1

package/README.md

@@ -27,6 +27,7 @@ This server supports multiple Microsoft cloud environments:
 - Comprehensive Microsoft 365 service integration
 - Read-only mode support for safe operations
 - Tool filtering for granular access control
+- [Tool presets](#tool-presets) and [dynamic discovery](#dynamic-tool-discovery) to shrink the tool surface and token usage
 
 ## Output Format: JSON vs TOON
 
@@ -94,7 +95,7 @@ MS365_MCP_OUTPUT_FORMAT=toon npx @softeria/ms-365-mcp-server
 
 ## Supported Services & Tools
 
-The server provides 200+ tools covering most of the Microsoft Graph API surface. Each tool maps 1-to-1 to a Graph API endpoint and is defined declaratively in [`src/endpoints.json`](src/endpoints.json).
+The server provides 300+ tools covering most of the Microsoft Graph API surface. Each tool maps 1-to-1 to a Graph API endpoint and is defined declaratively in [`src/endpoints.json`](src/endpoints.json).
 
 ### Personal Account Tools (Available by default)
 
@@ -509,7 +510,7 @@ Pinning is opt-in and local-MSAL only:
 
 ## Tool Presets
 
-To reduce initial connection overhead, use preset tool categories instead of loading all 90+ tools:
+To reduce initial connection overhead and token usage, use preset tool categories instead of loading the full tool set:
 
 ```bash
 npx @softeria/ms-365-mcp-server --preset mail
@@ -518,7 +519,7 @@ npx @softeria/ms-365-mcp-server --list-presets  # See all available presets
 
 Available presets: `mail`, `calendar`, `files`, `personal`, `work`, `excel`, `contacts`, `tasks`, `onenote`, `search`, `users`, `outlook`, `onedrive`, `teams`, `all`
 
-Each endpoint in `endpoints.json` declares which presets it belongs to via a `presets` array, so every preset is an exact tool-name allow-list that never over-matches across apps (e.g. `mail` does not include shared-mailbox tools; those are in `work`).
+Each endpoint in `endpoints.json` declares which presets it belongs to via a `presets` array, so every preset is an exact tool-name allow-list that never over-matches across apps (e.g. `mail` does not include shared-mailbox tools; those are in `work`). The universal binary reader `download-bytes` is included in every preset, so whatever an app returns (a file, an attachment, a photo, a recording) can always be fetched; `get-download-url` (a pre-authenticated URL for drive/SharePoint files) rides with the drive-backed presets. So a preset that can find a file can always read its bytes.
 
 The `outlook`, `onedrive` and `teams` presets are app-scoped: they expose exactly one Microsoft app. Use these for "expose exactly one app" deployments:
 
@@ -532,7 +533,7 @@ npx @softeria/ms-365-mcp-server --org-mode --preset teams
 
 ## Dynamic Tool Discovery
 
-Instead of loading all 90+ tools upfront, use dynamic discovery so the LLM finds and loads tools only when it needs them:
+Instead of loading every tool upfront, use dynamic discovery so the LLM finds and loads tools only when it needs them:
 
 ```bash
 npx @softeria/ms-365-mcp-server --discovery

package/dist/endpoints.json

@@ -702,7 +702,102 @@
     "isExcelOp": true,
     "scopes": ["Files.ReadWrite"],
     "skipEncoding": ["address"],
-    "llmTip": "Apply rangeFormat properties to a specific range. Required path param 'address' (e.g. 'A1:E5' or 'Sheet1!A1:E5'). Body: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Note: font, fill, and borders are sub-resources on rangeFormat — set them via /format/font, /format/fill, and /format/borders/{sideIndex} respectively, not on this endpoint."
+    "llmTip": "Apply rangeFormat properties to a specific range. Required path param 'address' (e.g. 'A1:E5' or 'Sheet1!A1:E5'). Body: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Font, fill, and borders are NOT set here; use format-excel-range-font, format-excel-range-fill, and format-excel-range-border for those."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format",
+    "method": "get",
+    "toolName": "get-excel-range-format",
+    "presets": ["excel", "personal"],
+    "isExcelOp": true,
+    "scopes": ["Files.Read"],
+    "skipEncoding": ["address"],
+    "llmTip": "Reads a range's format: alignment, wrapText, columnWidth, rowHeight. Font, fill, and borders are nested and omitted by default; add font, fill, and borders to the $expand parameter to include them in one call. Cell styling often encodes meaning (a fill or font color flagging status such as tentative or reconciled), so expand these to interpret what the cells mean."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format/font",
+    "method": "patch",
+    "toolName": "format-excel-range-font",
+    "presets": ["excel", "personal"],
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Set font formatting on a range: bold, italic, underline, size, color, and font name.",
+    "requestBodySchema": {
+      "type": "object",
+      "description": "Font style applied to every cell in the range. Send only the properties you want to change.",
+      "properties": {
+        "bold": { "type": "boolean" },
+        "italic": { "type": "boolean" },
+        "underline": {
+          "type": "string",
+          "enum": ["None", "Single", "Double", "SingleAccountant", "DoubleAccountant"]
+        },
+        "size": { "type": "number", "description": "Font size in points." },
+        "color": {
+          "type": "string",
+          "description": "HTML color code for the text, e.g. #FF0000 or a named color like 'red'."
+        },
+        "name": { "type": "string", "description": "Font name, e.g. 'Calibri'." }
+      }
+    }
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format/fill",
+    "method": "patch",
+    "toolName": "format-excel-range-fill",
+    "presets": ["excel", "personal"],
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Set the background fill color of a range's cells.",
+    "requestBodySchema": {
+      "type": "object",
+      "description": "Background fill applied to every cell in the range.",
+      "properties": {
+        "color": {
+          "type": "string",
+          "description": "HTML color code for the background, e.g. #FFFF00 or a named color like 'yellow'."
+        }
+      }
+    }
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format/borders/{sideIndex}",
+    "method": "patch",
+    "toolName": "format-excel-range-border",
+    "presets": ["excel"],
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Sets one border side. The {sideIndex} path param selects which side: EdgeTop, EdgeBottom, EdgeLeft, EdgeRight, InsideVertical, InsideHorizontal, DiagonalDown, or DiagonalUp. To outline all four edges, call once per side.",
+    "requestBodySchema": {
+      "type": "object",
+      "description": "Line style for the chosen border side.",
+      "properties": {
+        "style": {
+          "type": "string",
+          "enum": [
+            "None",
+            "Continuous",
+            "Dash",
+            "DashDot",
+            "DashDotDot",
+            "Dot",
+            "Double",
+            "SlantDashDot"
+          ]
+        },
+        "weight": {
+          "type": "string",
+          "enum": ["Hairline", "Thin", "Medium", "Thick"]
+        },
+        "color": {
+          "type": "string",
+          "description": "HTML color code for the line, e.g. #000000 or a named color like 'black'."
+        }
+      }
+    }
   },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range()/sort",

package/dist/generated/client.js

@@ -2593,6 +2593,7 @@ const microsoft_graph_listItem = z.object({
   documentSetVersions: z.array(microsoft_graph_documentSetVersion).describe("Version information for a document set version created by a user.").optional(),
   driveItem: microsoft_graph_driveItem.describe("[Note: Simplified from 45 properties to 25 most common ones]").optional(),
   fields: microsoft_graph_fieldValueSet.optional(),
+  permissions: z.array(microsoft_graph_permission).optional(),
   versions: z.array(microsoft_graph_listItemVersion).describe("The list of previous versions of the list item.").optional()
 }).passthrough();
 const microsoft_graph_longRunningOperationStatus = z.enum([
@@ -2716,6 +2717,7 @@ const microsoft_graph_list = z.lazy(
     drive: microsoft_graph_drive.optional(),
     items: z.array(microsoft_graph_listItem).describe("All items contained in the list.").optional(),
     operations: z.array(microsoft_graph_richLongRunningOperation).describe("The collection of long-running operations on the list.").optional(),
+    permissions: z.array(microsoft_graph_permission).optional(),
     subscriptions: z.array(microsoft_graph_subscription).describe("The set of subscriptions on the list.").optional()
   }).passthrough()
 );
@@ -4160,6 +4162,7 @@ const microsoft_graph_place = z.object({
   label: z.string().describe("User-defined description of the place.").nullish(),
   parentId: z.string().describe("The ID of a parent place.").nullish(),
   phone: z.string().describe("The phone number of the place.").nullish(),
+  placeId: z.string().describe("A stable service-level identifier for the place object used by Places workloads.").nullish(),
   tags: z.array(z.string()).describe("Custom tags that are associated with the place for categorization or filtering.").optional(),
   checkIns: z.array(microsoft_graph_checkInClaim).describe(
     "A subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place."
@@ -4181,6 +4184,7 @@ const microsoft_graph_room = z.object({
   label: z.string().describe("User-defined description of the place.").nullish(),
   parentId: z.string().describe("The ID of a parent place.").nullish(),
   phone: z.string().describe("The phone number of the place.").nullish(),
+  placeId: z.string().describe("A stable service-level identifier for the place object used by Places workloads.").nullish(),
   tags: z.array(z.string()).describe("Custom tags that are associated with the place for categorization or filtering.").optional(),
   checkIns: z.array(microsoft_graph_checkInClaim).describe(
     "A subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place."
@@ -4194,7 +4198,6 @@ const microsoft_graph_room = z.object({
   floorLabel: z.string().describe("Specifies a descriptive label for the floor, for example, P.").nullish(),
   floorNumber: z.number().gte(-2147483648).lte(2147483647).describe("Specifies the floor number that the room is on.").nullish(),
   nickname: z.string().describe("Specifies a nickname for the room, for example, 'conf room'.").optional(),
-  placeId: z.string().describe("An alternative immutable unique identifier of the room. Read-only.").nullish(),
   teamsEnabledState: microsoft_graph_placeFeatureEnablement.optional(),
   videoDeviceName: z.string().describe("Specifies the name of the video device in the room.").nullish()
 }).passthrough();
@@ -4208,6 +4211,7 @@ const microsoft_graph_workspace = z.object({
   label: z.string().describe("User-defined description of the place.").nullish(),
   parentId: z.string().describe("The ID of a parent place.").nullish(),
   phone: z.string().describe("The phone number of the place.").nullish(),
+  placeId: z.string().describe("A stable service-level identifier for the place object used by Places workloads.").nullish(),
   tags: z.array(z.string()).describe("Custom tags that are associated with the place for categorization or filtering.").optional(),
   checkIns: z.array(microsoft_graph_checkInClaim).describe(
     "A subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place."
@@ -4222,8 +4226,7 @@ const microsoft_graph_workspace = z.object({
   mode: microsoft_graph_placeMode.optional(),
   nickname: z.string().describe(
     "A short, friendly name for the workspace, often used for easier identification or display in the UI."
-  ).optional(),
-  placeId: z.string().describe("An alternative immutable unique identifier of the workspace. Read-only.").nullish()
+  ).optional()
 }).passthrough();
 const microsoft_graph_roomList = z.object({
   id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
@@ -4234,6 +4237,7 @@ const microsoft_graph_roomList = z.object({
   label: z.string().describe("User-defined description of the place.").nullish(),
   parentId: z.string().describe("The ID of a parent place.").nullish(),
   phone: z.string().describe("The phone number of the place.").nullish(),
+  placeId: z.string().describe("A stable service-level identifier for the place object used by Places workloads.").nullish(),
   tags: z.array(z.string()).describe("Custom tags that are associated with the place for categorization or filtering.").optional(),
   checkIns: z.array(microsoft_graph_checkInClaim).describe(
     "A subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place."
@@ -4814,6 +4818,28 @@ const microsoft_graph_userCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_user)
 }).partial().passthrough();
+const format_excel_range_font_Body = z.object({
+  bold: z.boolean(),
+  italic: z.boolean(),
+  underline: z.enum(["None", "Single", "Double", "SingleAccountant", "DoubleAccountant"]),
+  size: z.number().describe("Font size in points."),
+  color: z.string().describe("HTML color code for the text, e.g. #FF0000 or a named color like 'red'."),
+  name: z.string().describe("Font name, e.g. 'Calibri'.")
+}).partial().passthrough();
+const format_excel_range_border_Body = z.object({
+  style: z.enum([
+    "None",
+    "Continuous",
+    "Dash",
+    "DashDot",
+    "DashDotDot",
+    "Dot",
+    "Double",
+    "SlantDashDot"
+  ]),
+  weight: z.enum(["Hairline", "Thin", "Medium", "Thick"]),
+  color: z.string().describe("HTML color code for the line, e.g. #000000 or a named color like 'black'.")
+}).partial().passthrough();
 const schemas = {
   microsoft_graph_chatType,
   microsoft_graph_migrationMode,
@@ -5319,7 +5345,9 @@ const schemas = {
   microsoft_graph_subscriptionCollectionResponse,
   microsoft_graph_channelCollectionResponse,
   microsoft_graph_teamsTabCollectionResponse,
-  microsoft_graph_userCollectionResponse
+  microsoft_graph_userCollectionResponse,
+  format_excel_range_font_Body,
+  format_excel_range_border_Body
 };
 const endpoints = makeApi([
   {
@@ -6658,6 +6686,26 @@ Items with this property set should be removed from your local state.`,
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/format`,
+    alias: "get-excel-range-format",
+    description: `Returns a format object, encapsulating the range's font, fill, borders, alignment, and other properties. Read-only.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "$select",
+        type: "Query",
+        schema: z.array(z.string()).describe("Select properties to be returned").optional()
+      },
+      {
+        name: "$expand",
+        type: "Query",
+        schema: z.array(z.string()).describe("Expand related entities").optional()
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "patch",
     path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/format`,
@@ -6674,6 +6722,123 @@ Items with this property set should be removed from your local state.`,
     ],
     response: z.void()
   },
+  {
+    method: "patch",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/format/borders/:sideIndex`,
+    alias: "format-excel-range-border",
+    description: `Sets one border side. The {sideIndex} path param selects which side: EdgeTop, EdgeBottom, EdgeLeft, EdgeRight, InsideVertical, InsideHorizontal, DiagonalDown, or DiagonalUp. To outline all four edges, call once per side.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Operation payload`,
+        type: "Body",
+        schema: format_excel_range_border_Body
+      },
+      {
+        name: "driveId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: drive-id")
+      },
+      {
+        name: "driveItemId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: driveItem-id")
+      },
+      {
+        name: "workbookWorksheetId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: workbookWorksheet-id")
+      },
+      {
+        name: "address",
+        type: "Path",
+        schema: z.string().describe("Path parameter: address")
+      },
+      {
+        name: "sideIndex",
+        type: "Path",
+        schema: z.string().describe("Path parameter: sideIndex")
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "patch",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/format/fill`,
+    alias: "format-excel-range-fill",
+    description: `Set the background fill color of a range's cells.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Operation payload`,
+        type: "Body",
+        schema: z.object({
+          color: z.string().describe(
+            "HTML color code for the background, e.g. #FFFF00 or a named color like 'yellow'."
+          )
+        }).partial().passthrough()
+      },
+      {
+        name: "driveId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: drive-id")
+      },
+      {
+        name: "driveItemId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: driveItem-id")
+      },
+      {
+        name: "workbookWorksheetId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: workbookWorksheet-id")
+      },
+      {
+        name: "address",
+        type: "Path",
+        schema: z.string().describe("Path parameter: address")
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "patch",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/format/font`,
+    alias: "format-excel-range-font",
+    description: `Set font formatting on a range: bold, italic, underline, size, color, and font name.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Operation payload`,
+        type: "Body",
+        schema: format_excel_range_font_Body
+      },
+      {
+        name: "driveId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: drive-id")
+      },
+      {
+        name: "driveItemId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: driveItem-id")
+      },
+      {
+        name: "workbookWorksheetId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: workbookWorksheet-id")
+      },
+      {
+        name: "address",
+        type: "Path",
+        schema: z.string().describe("Path parameter: address")
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "post",
     path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/insert`,

package/dist/tool-categories.js

@@ -53,13 +53,32 @@ const PRESET_META = {
     requiresOrgMode: true
   }
 };
+const UNIVERSAL_UTILITY_TOOLS = ["download-bytes"];
+const SCOPED_UTILITY_TOOLS = {
+  "get-download-url": ["files", "onedrive", "personal", "work", "search"],
+  "parse-teams-url": ["teams", "work"]
+};
+for (const [tool, presets] of Object.entries(SCOPED_UTILITY_TOOLS)) {
+  for (const preset of presets) {
+    if (!Object.prototype.hasOwnProperty.call(PRESET_META, preset)) {
+      throw new Error(
+        `SCOPED_UTILITY_TOOLS["${tool}"] references unknown preset "${preset}" (not in PRESET_META)`
+      );
+    }
+  }
+}
 function presetPattern(preset) {
-  const names = [
+  const endpointNames = [
     ...new Set(endpointEntries.filter((e) => e.presets?.includes(preset)).map((e) => e.toolName))
   ];
-  if (names.length === 0) {
+  if (endpointNames.length === 0) {
     throw new Error(`Preset "${preset}" matches no endpoints in endpoints.json`);
   }
+  const names = [
+    ...endpointNames,
+    ...UNIVERSAL_UTILITY_TOOLS,
+    ...Object.entries(SCOPED_UTILITY_TOOLS).filter(([, presets]) => presets.includes(preset)).map(([name]) => name)
+  ];
   return new RegExp(`^(?:${names.join("|")})$`);
 }
 const TOOL_CATEGORIES = {

package/package.json

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

package/src/endpoints.json

@@ -702,7 +702,102 @@
     "isExcelOp": true,
     "scopes": ["Files.ReadWrite"],
     "skipEncoding": ["address"],
-    "llmTip": "Apply rangeFormat properties to a specific range. Required path param 'address' (e.g. 'A1:E5' or 'Sheet1!A1:E5'). Body: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Note: font, fill, and borders are sub-resources on rangeFormat — set them via /format/font, /format/fill, and /format/borders/{sideIndex} respectively, not on this endpoint."
+    "llmTip": "Apply rangeFormat properties to a specific range. Required path param 'address' (e.g. 'A1:E5' or 'Sheet1!A1:E5'). Body: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Font, fill, and borders are NOT set here; use format-excel-range-font, format-excel-range-fill, and format-excel-range-border for those."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format",
+    "method": "get",
+    "toolName": "get-excel-range-format",
+    "presets": ["excel", "personal"],
+    "isExcelOp": true,
+    "scopes": ["Files.Read"],
+    "skipEncoding": ["address"],
+    "llmTip": "Reads a range's format: alignment, wrapText, columnWidth, rowHeight. Font, fill, and borders are nested and omitted by default; add font, fill, and borders to the $expand parameter to include them in one call. Cell styling often encodes meaning (a fill or font color flagging status such as tentative or reconciled), so expand these to interpret what the cells mean."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format/font",
+    "method": "patch",
+    "toolName": "format-excel-range-font",
+    "presets": ["excel", "personal"],
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Set font formatting on a range: bold, italic, underline, size, color, and font name.",
+    "requestBodySchema": {
+      "type": "object",
+      "description": "Font style applied to every cell in the range. Send only the properties you want to change.",
+      "properties": {
+        "bold": { "type": "boolean" },
+        "italic": { "type": "boolean" },
+        "underline": {
+          "type": "string",
+          "enum": ["None", "Single", "Double", "SingleAccountant", "DoubleAccountant"]
+        },
+        "size": { "type": "number", "description": "Font size in points." },
+        "color": {
+          "type": "string",
+          "description": "HTML color code for the text, e.g. #FF0000 or a named color like 'red'."
+        },
+        "name": { "type": "string", "description": "Font name, e.g. 'Calibri'." }
+      }
+    }
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format/fill",
+    "method": "patch",
+    "toolName": "format-excel-range-fill",
+    "presets": ["excel", "personal"],
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Set the background fill color of a range's cells.",
+    "requestBodySchema": {
+      "type": "object",
+      "description": "Background fill applied to every cell in the range.",
+      "properties": {
+        "color": {
+          "type": "string",
+          "description": "HTML color code for the background, e.g. #FFFF00 or a named color like 'yellow'."
+        }
+      }
+    }
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format/borders/{sideIndex}",
+    "method": "patch",
+    "toolName": "format-excel-range-border",
+    "presets": ["excel"],
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Sets one border side. The {sideIndex} path param selects which side: EdgeTop, EdgeBottom, EdgeLeft, EdgeRight, InsideVertical, InsideHorizontal, DiagonalDown, or DiagonalUp. To outline all four edges, call once per side.",
+    "requestBodySchema": {
+      "type": "object",
+      "description": "Line style for the chosen border side.",
+      "properties": {
+        "style": {
+          "type": "string",
+          "enum": [
+            "None",
+            "Continuous",
+            "Dash",
+            "DashDot",
+            "DashDotDot",
+            "Dot",
+            "Double",
+            "SlantDashDot"
+          ]
+        },
+        "weight": {
+          "type": "string",
+          "enum": ["Hairline", "Thin", "Medium", "Thick"]
+        },
+        "color": {
+          "type": "string",
+          "description": "HTML color code for the line, e.g. #000000 or a named color like 'black'."
+        }
+      }
+    }
   },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range()/sort",