@softeria/ms-365-mcp-server 0.139.0 → 0.139.1

package/bin/modules/simplified-openapi.mjs

@@ -55,10 +55,22 @@ export function createAndSaveSimplifiedOpenAPI(
         description: `Path parameter: ${paramName}`,
         schema: { type: 'string' },
       }));
+      // The fallback used to be the llmTip, then the tool name itself, which reached the
+      // model as the whole description ("update-sharepoint-site-onenote-page-content
+      // (synthesized)"). Prefer a real sentence built from the same name.
+      //
+      // The synthesized sentence goes ahead of the llmTip on purpose: graph-tools appends
+      // the llmTip to the description at registration, so using it here too shipped it
+      // twice in the same tool description. The llmTip stays as the fallback for the tool
+      // names with no verb to synthesize from (graph-batch).
+      const synthesizedDescription =
+        synthesizeDescriptionFromToolName(endpoint.toolName) ||
+        endpoint.llmTip ||
+        `${endpoint.toolName} (synthesized)`;
       pathSpec[methodLower] = {
         tags: ['drives.driveItem'],
-        summary: endpoint.llmTip || `${endpoint.toolName} (synthesized)`,
-        description: endpoint.llmTip || `${endpoint.toolName} (synthesized)`,
+        summary: synthesizedDescription,
+        description: synthesizedDescription,
         operationId: endpoint.toolName,
         parameters: synthesizedParameters,
         requestBody:
@@ -126,6 +138,7 @@ export function createAndSaveSimplifiedOpenAPI(
           if (!operation.description && operation.summary) {
             operation.description = operation.summary;
           }
+          operation.description = replaceNavPropertyStub(operation.description, eo.toolName);
           if (operation.parameters) {
             operation.parameters = operation.parameters.map((param) => {
               if (param.$ref && param.$ref.startsWith('#/components/parameters/')) {
@@ -166,6 +179,147 @@ export function createAndSaveSimplifiedOpenAPI(
   fs.writeFileSync(openapiTrimmedFile, yaml.dump(openApiSpec));
 }
 
+// Microsoft's spec is generated from CSDL, so operations that are plain CRUD over a
+// navigation property never get prose. They get scaffolding naming the property and its
+// parent instead - "Create new navigation property to messages for users" - which
+// describes neither the operation nor the resource it acts on. Actions and functions get
+// the same treatment in a different shape ("Invoke action setReaction"). That string is
+// what the model sees as the tool description.
+//
+// Only these prose-free shapes are replaced, and each is anchored at both ends so a stub
+// prefix followed by real text is never swallowed. Descriptions carrying real prose are
+// left alone, including the ones that describe the property rather than the operation
+// ("The messages in a mailbox or folder. Read-only. Nullable."): those are the wrong
+// subject but often carry detail worth keeping, and descriptionOverride is the right tool
+// when they aren't.
+const NAV_PROPERTY_STUB =
+  /^(?:Create new navigation property(?: to \S+)?(?: for \S+)?|Update the navigation property \S+ in \S+|Delete navigation property \S+ for \S+|Get \S+ from \S+|Invoke (?:action|function) \S+)\.?$/i;
+
+// Leading tool-name tokens that read as verbs. The tool name is a better source than the
+// HTTP method: sort-excel-range is a PATCH, and "Update" would lose the point of it.
+// Listed explicitly rather than inferred: an unknown leading token means we leave
+// Microsoft's text alone, which is the safe direction. `copilot` and `graph` are the only
+// tool-name leads that aren't verbs, and both fall out of this map on purpose.
+const TOOL_NAME_VERBS = {
+  accept: 'Accept',
+  add: 'Add',
+  cancel: 'Cancel',
+  clear: 'Clear',
+  copy: 'Copy',
+  create: 'Create',
+  decline: 'Decline',
+  delete: 'Delete',
+  dismiss: 'Dismiss',
+  extract: 'Extract',
+  find: 'Find',
+  format: 'Format',
+  forward: 'Forward',
+  get: 'Get',
+  insert: 'Insert',
+  list: 'List',
+  merge: 'Merge',
+  move: 'Move',
+  pin: 'Pin',
+  reauthorize: 'Reauthorize',
+  remove: 'Remove',
+  rename: 'Rename',
+  reply: 'Reply to',
+  search: 'Search',
+  send: 'Send',
+  set: 'Set',
+  share: 'Share',
+  snooze: 'Snooze',
+  sort: 'Sort',
+  unmerge: 'Unmerge',
+  unpin: 'Unpin',
+  unset: 'Unset',
+  update: 'Update',
+  upload: 'Upload',
+};
+
+// Multi-word verbs, matched before the single-token map. Chaining tokens generically
+// would read "Tentatively or accept" for tentatively-accept-event.
+//
+// reply-all has to live here rather than fall through: "all" reads as a possessive lead
+// (see POSSESSIVE_LEADS), so reply-all-mail-message would render "Reply to all mail
+// message" - which says reply to every message in the mailbox, the opposite of what the
+// tool does.
+const COMPOUND_VERBS = {
+  'move-rename': 'Move or rename',
+  'reply-all': 'Reply to all recipients of',
+  'tentatively-accept': 'Tentatively accept',
+};
+
+const PRODUCT_NAMES = {
+  excel: 'Excel',
+  onedrive: 'OneDrive',
+  onenote: 'OneNote',
+  outlook: 'Outlook',
+  planner: 'Planner',
+  sharepoint: 'SharePoint',
+};
+
+// "my calendar permission" already says whose it is.
+const POSSESSIVE_LEADS = new Set(['my', 'your', 'all']);
+
+// Deliberately conservative: a false "singular" only costs an article that reads slightly
+// off, while a false "plural" drops an article the sentence needed. Words like status,
+// series and news end in s without being plural.
+function isPlural(word) {
+  return /s$/i.test(word) && !/(ss|us|is|ews)$/i.test(word);
+}
+
+// Mass nouns take no article: "Send a mail" and "Upload a file content" both read wrong.
+// Only the tail is checked, since that is the noun the article has to agree with - a
+// leading "content" would be a modifier ("content type"), which is countable again.
+const UNCOUNTABLE_TAILS = new Set(['content', 'mail', 'mime', 'delta']);
+
+// Sound, not spelling. OneDrive/OneNote open with a consonant sound, and so does the
+// "yoo" class of u-words (user, unit, unique) - but not upload or update, which really do
+// take "an". Listing the yoo- prefixes is narrower and safer than a blanket /^u/.
+const CONSONANT_SOUNDING_VOWEL = /^(?:one|use|user|uni|uti|ubi|eu)/i;
+
+function articleFor(word) {
+  if (CONSONANT_SOUNDING_VOWEL.test(word)) return 'a ';
+  return /^[aeiou]/i.test(word) ? 'an ' : 'a ';
+}
+
+export function synthesizeDescriptionFromToolName(toolName) {
+  const parts = toolName.split('-');
+
+  let verb = null;
+  const compound = Object.keys(COMPOUND_VERBS).find((prefix) => toolName.startsWith(`${prefix}-`));
+  if (compound) {
+    verb = COMPOUND_VERBS[compound];
+    parts.splice(0, compound.split('-').length);
+  } else if (parts.length > 1 && TOOL_NAME_VERBS[parts[0]]) {
+    verb = TOOL_NAME_VERBS[parts.shift()];
+  }
+  if (!verb) return null;
+
+  // reply-to-chat-message: the verb phrase already ends in that preposition.
+  if (parts[0] === 'to' && verb.endsWith(' to')) parts.shift();
+  if (parts.length === 0) return null;
+
+  const words = parts.map((word) => PRODUCT_NAMES[word] ?? word);
+  // The article is chosen for the head word, so a plural head has to suppress it too -
+  // "a presences by user id" otherwise. The tail matters as well, since that is the noun
+  // the phrase is actually about ("Excel table rows").
+  const skipArticle =
+    verb === 'List' ||
+    POSSESSIVE_LEADS.has(parts[0]) ||
+    isPlural(parts[0]) ||
+    isPlural(parts[parts.length - 1]) ||
+    UNCOUNTABLE_TAILS.has(parts[parts.length - 1]);
+
+  return `${verb} ${skipArticle ? '' : articleFor(words[0])}${words.join(' ')}.`;
+}
+
+export function replaceNavPropertyStub(description, toolName) {
+  if (!description || !NAV_PROPERTY_STUB.test(description.trim())) return description;
+  return synthesizeDescriptionFromToolName(toolName) ?? description;
+}
+
 function normalizeWildcardSuccessResponses(paths) {
   Object.values(paths || {}).forEach((pathItem) => {
     if (!pathItem || typeof pathItem !== 'object') return;

package/dist/endpoints.json

@@ -105,6 +105,7 @@
     "pathPattern": "/users/{user-id}/messages/{message-id}",
     "method": "get",
     "toolName": "get-shared-mailbox-message",
+    "descriptionOverride": "Get a single Outlook message from another user's mailbox or a shared mailbox, by message ID. The user-id is the mailbox owner's ID or email address, and delegated access to that mailbox is required.",
     "presets": ["work"],
     "workScopes": ["Mail.Read.Shared"]
   },
@@ -411,6 +412,7 @@
     "pathPattern": "/me/calendars/{calendar-id}/events",
     "method": "get",
     "toolName": "list-specific-calendar-events",
+    "descriptionOverride": "List events from one of the signed-in user's calendars, addressed by calendar ID.",
     "presets": ["calendar", "outlook", "personal"],
     "scopes": ["Calendars.Read"],
     "supportsTimezone": true,
@@ -421,6 +423,7 @@
     "pathPattern": "/me/calendars/{calendar-id}/events/{event-id}",
     "method": "get",
     "toolName": "get-specific-calendar-event",
+    "descriptionOverride": "Get a single event from one of the signed-in user's calendars, addressed by calendar ID and event ID. Any calendar can be addressed this way, including the default one.",
     "presets": ["calendar", "outlook", "personal"],
     "scopes": ["Calendars.Read"],
     "supportsTimezone": true,
@@ -464,6 +467,7 @@
     "pathPattern": "/me/calendars/{calendar-id}/calendarView",
     "method": "get",
     "toolName": "get-specific-calendar-view",
+    "descriptionOverride": "List the occurrences, exceptions, and single instances of events over a time range, from one of the signed-in user's calendars addressed by calendar ID.",
     "presets": ["calendar", "outlook", "personal"],
     "scopes": ["Calendars.Read"],
     "supportsTimezone": true,
@@ -482,6 +486,7 @@
     "pathPattern": "/users/{user-id}/calendar/events",
     "method": "get",
     "toolName": "list-shared-calendar-events",
+    "descriptionOverride": "List events in another user's default calendar. The user-id is the calendar owner's ID or email address, and delegated access to that calendar is required. Recurring events are returned as a single series master, not expanded into occurrences - use get-shared-calendar-view for that.",
     "presets": ["work"],
     "workScopes": ["Calendars.Read.Shared"]
   },
@@ -489,6 +494,7 @@
     "pathPattern": "/users/{user-id}/calendarView",
     "method": "get",
     "toolName": "get-shared-calendar-view",
+    "descriptionOverride": "List the occurrences, exceptions, and single instances of events in another user's default calendar over a time range. Requires the startDateTime and endDateTime query parameters in ISO 8601 format. Unlike list-shared-calendar-events, recurring series are expanded into individual occurrences.",
     "presets": ["work"],
     "workScopes": ["Calendars.Read.Shared"],
     "supportsTimezone": true
@@ -1979,6 +1985,7 @@
     "pathPattern": "/copilot/retrieval",
     "method": "post",
     "toolName": "copilot-retrieve",
+    "descriptionOverride": "Search Microsoft 365 content using the Copilot Retrieval API. Grounds a natural-language query against the hybrid index behind Microsoft 365 Copilot and returns permission-trimmed text extracts with their source URLs.",
     "presets": ["search", "work"],
     "readOnly": true,
     "workScopes": [["Files.Read.All", "Sites.Read.All"], ["ExternalItem.Read.All"]],
@@ -2015,7 +2022,7 @@
         }
       }
     },
-    "llmTip": "Semantic/hybrid search over Microsoft 365 content via the Copilot Retrieval API. Grounds a natural-language query against the same hybrid index that powers Microsoft 365 Copilot and returns permission-trimmed text extracts with their source URLs — unlike search-query/search-onedrive-files/search-sharepoint-sites, which are lexical KQL. Prefer this for paraphrase/intent queries (e.g. resolving an informal project nickname, or matching 'packaging requirements' against text that never uses that phrase). Pass the request fields nested under a 'body' object: { queryString, dataSource, filterExpression?, resourceMetadata?, maximumNumberOfResults? }. Returns { retrievalHits: [{ webUrl, extracts: [{ text, relevanceScore }], resourceType, resourceMetadata, sensitivityLabel? }] }. Work/school accounts only (personal accounts are not supported). dataSource 'sharePoint'/'oneDriveBusiness' need delegated Files.Read.All + Sites.Read.All (requested by default); dataSource 'externalItem' (Copilot connectors) needs ExternalItem.Read.All, which is not requested by default - add it with --extra-scopes ExternalItem.Read.All."
+    "llmTip": "Retrieval here is semantic/hybrid, unlike search-query/search-onedrive-files/search-sharepoint-sites, which are lexical KQL. Prefer this for paraphrase/intent queries (e.g. resolving an informal project nickname, or matching 'packaging requirements' against text that never uses that phrase). Pass the request fields nested under a 'body' object: { queryString, dataSource, filterExpression?, resourceMetadata?, maximumNumberOfResults? }. Returns { retrievalHits: [{ webUrl, extracts: [{ text, relevanceScore }], resourceType, resourceMetadata, sensitivityLabel? }] }. Work/school accounts only (personal accounts are not supported). dataSource 'sharePoint'/'oneDriveBusiness' need delegated Files.Read.All + Sites.Read.All (requested by default); dataSource 'externalItem' (Copilot connectors) needs ExternalItem.Read.All, which is not requested by default - add it with --extra-scopes ExternalItem.Read.All."
   },
   {
     "pathPattern": "/me/onlineMeetings",
@@ -2216,17 +2223,19 @@
     "pathPattern": "/places/{place-id}/graph.roomList/rooms",
     "method": "get",
     "toolName": "list-room-list-rooms",
+    "descriptionOverride": "List the meeting rooms that belong to a room list.",
     "presets": ["calendar", "work"],
     "workScopes": ["Place.Read.All"],
-    "llmTip": "Lists rooms belonging to a specific room list. The place-id is the ID or email address of the room list (from get-room-list). Returns rooms with displayName, emailAddress, capacity, building, floorNumber, floorLabel, and AV equipment details. Combine with find-meeting-times to find available rooms for booking."
+    "llmTip": "The place-id is the ID or email address of the room list (from get-room-list). Returns rooms with displayName, emailAddress, capacity, building, floorNumber, floorLabel, and AV equipment details. Combine with find-meeting-times to find available rooms for booking."
   },
   {
     "pathPattern": "/places/{place-id}/graph.roomList/rooms/{room-id}",
     "method": "get",
     "toolName": "get-room-list-room",
+    "descriptionOverride": "Get a single meeting room from a room list, by room ID.",
     "presets": ["calendar", "work"],
     "workScopes": ["Place.Read.All"],
-    "llmTip": "Gets a specific room within a room list. The place-id is the room list ID or email, and room-id is the specific room ID. Returns full room details including capacity, building, floor, and AV equipment."
+    "llmTip": "The place-id is the room list ID or email, and room-id is the specific room ID. Returns full room details including capacity, building, floor, and AV equipment."
   },
   {
     "pathPattern": "/places/{place-id}",

package/dist/generated/client.js

@@ -5555,7 +5555,7 @@ const endpoints = makeApi([
     method: "patch",
     path: "/chats/:chatId/messages/:chatMessageId",
     alias: "update-chat-message",
-    description: `Update the navigation property messages in chats`,
+    description: `Update a chat message.`,
     requestFormat: "json",
     parameters: [
       {
@@ -5671,7 +5671,7 @@ const endpoints = makeApi([
     method: "post",
     path: "/chats/:chatId/messages/:chatMessageId/replies",
     alias: "reply-to-chat-message",
-    description: `Create new navigation property to replies for chats`,
+    description: `Reply to a chat message.`,
     requestFormat: "json",
     parameters: [
       {
@@ -5687,7 +5687,7 @@ const endpoints = makeApi([
     method: "post",
     path: "/chats/:chatId/messages/:chatMessageId/setReaction",
     alias: "set-chat-message-reaction",
-    description: `Invoke action setReaction`,
+    description: `Set a chat message reaction.`,
     requestFormat: "json",
     parameters: [
       {
@@ -5703,7 +5703,7 @@ const endpoints = makeApi([
     method: "post",
     path: "/chats/:chatId/messages/:chatMessageId/unsetReaction",
     alias: "unset-chat-message-reaction",
-    description: `Invoke action unsetReaction`,
+    description: `Unset a chat message reaction.`,
     requestFormat: "json",
     parameters: [
       {
@@ -5852,7 +5852,7 @@ const endpoints = makeApi([
     method: "patch",
     path: "/drives/:driveId/items/:driveItemId",
     alias: "move-rename-onedrive-item",
-    description: `Update the navigation property items in drives`,
+    description: `Move or rename a OneDrive item.`,
     requestFormat: "json",
     parameters: [
       {
@@ -5902,7 +5902,7 @@ const endpoints = makeApi([
     method: "delete",
     path: "/drives/:driveId/items/:driveItemId",
     alias: "delete-onedrive-file",
-    description: `Delete navigation property items for drives`,
+    description: `Delete a OneDrive file.`,
     requestFormat: "json",
     parameters: [
       {
@@ -5967,7 +5967,7 @@ const endpoints = makeApi([
     method: "post",
     path: "/drives/:driveId/items/:driveItemId/children",
     alias: "create-onedrive-folder",
-    description: `Create new navigation property to children for drives`,
+    description: `Create a OneDrive folder.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6033,7 +6033,7 @@ const endpoints = makeApi([
     method: "post",
     path: "/drives/:driveId/items/:driveItemId/copy",
     alias: "copy-drive-item",
-    description: `Invoke action copy`,
+    description: `Copy a drive item.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6066,7 +6066,7 @@ If a sharing link of the specified type already exists for the app, the existing
     method: "post",
     path: "/drives/:driveId/items/:driveItemId/createUploadSession",
     alias: "create-upload-session",
-    description: `Invoke action createUploadSession`,
+    description: `Create an upload session.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6136,7 +6136,7 @@ Items with this property set should be removed from your local state.`,
     method: "post",
     path: "/drives/:driveId/items/:driveItemId/extractSensitivityLabels",
     alias: "extract-drive-item-sensitivity-labels",
-    description: `Invoke action extractSensitivityLabels`,
+    description: `Extract drive item sensitivity labels.`,
     requestFormat: "json",
     response: z.void()
   },
@@ -6210,7 +6210,7 @@ Items with this property set should be removed from your local state.`,
     method: "delete",
     path: "/drives/:driveId/items/:driveItemId/permissions/:permissionId",
     alias: "delete-drive-item-permission",
-    description: `Delete navigation property permissions for drives`,
+    description: `Delete a drive item permission.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6225,7 +6225,7 @@ Items with this property set should be removed from your local state.`,
     method: "post",
     path: "/drives/:driveId/items/:driveItemId/preview",
     alias: "create-drive-item-preview",
-    description: `Invoke action preview`,
+    description: `Create a drive item preview.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6461,7 +6461,7 @@ Items with this property set should be removed from your local state.`,
     method: "post",
     path: "/drives/:driveId/items/:driveItemId/workbook/tables/:workbookTableId/rows",
     alias: "add-excel-table-rows",
-    description: `Create new navigation property to rows for drives`,
+    description: `Add Excel table rows.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6477,7 +6477,7 @@ Items with this property set should be removed from your local state.`,
     method: "patch",
     path: "/drives/:driveId/items/:driveItemId/workbook/tables/:workbookTableId/rows/itemAt(index=:index)",
     alias: "update-excel-table-row",
-    description: `Update a single row in a formal Excel table by zero-based row index. Body: { values: [[...]] } with one inner array matching the column count.`,
+    description: `Update an Excel table row.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6513,7 +6513,7 @@ Items with this property set should be removed from your local state.`,
     method: "delete",
     path: "/drives/:driveId/items/:driveItemId/workbook/tables/:workbookTableId/rows/itemAt(index=:index)",
     alias: "delete-excel-table-row",
-    description: `Delete a single row from a formal Excel table by zero-based row index.`,
+    description: `Delete an Excel table row.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6609,7 +6609,7 @@ Items with this property set should be removed from your local state.`,
     method: "patch",
     path: "/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range()/sort",
     alias: "sort-excel-range",
-    description: `Update the navigation property sort in drives`,
+    description: `Sort an Excel range.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6627,7 +6627,7 @@ Items with this property set should be removed from your local state.`,
     method: "get",
     path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')`,
     alias: "get-excel-range",
-    description: `Invoke function range`,
+    description: `Get an Excel range.`,
     requestFormat: "json",
     response: z.void()
   },
@@ -6635,7 +6635,7 @@ Items with this property set should be removed from your local state.`,
     method: "patch",
     path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')`,
     alias: "update-excel-range",
-    description: `Set cell values, formulas, or number format on any range \u2014 does NOT require the worksheet to be a formal Excel table. Body: { values: [['v1','v2','v3']] } for a single row, or [['a','b'],['c','d']] for multi-row. Use this for append (target the next empty row's address, e.g. 'A172:H172'), update (target a single cell like 'H42'), or prepend-style edits (read existing, concatenate, write back). Number of inner-array values must match the column count of the address.`,
+    description: `Update an Excel range.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6671,7 +6671,7 @@ Items with this property set should be removed from your local state.`,
     method: "post",
     path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/clear`,
     alias: "clear-excel-range",
-    description: `Invoke action clear`,
+    description: `Clear an Excel range.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6687,7 +6687,7 @@ Items with this property set should be removed from your local state.`,
     method: "post",
     path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/delete`,
     alias: "delete-excel-range",
-    description: `Invoke action delete`,
+    description: `Delete an Excel range.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6723,7 +6723,7 @@ Items with this property set should be removed from your local state.`,
     method: "patch",
     path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/format`,
     alias: "format-excel-range",
-    description: `Update the navigation property format in drives`,
+    description: `Format an Excel range.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6739,7 +6739,7 @@ Items with this property set should be removed from your local state.`,
     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.`,
+    description: `Format an Excel range border.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6780,7 +6780,7 @@ Items with this property set should be removed from your local state.`,
     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.`,
+    description: `Format an Excel range fill.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6820,7 +6820,7 @@ Items with this property set should be removed from your local state.`,
     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.`,
+    description: `Format an Excel range font.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6856,7 +6856,7 @@ Items with this property set should be removed from your local state.`,
     method: "post",
     path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/insert`,
     alias: "insert-excel-range",
-    description: `Invoke action insert`,
+    description: `Insert an Excel range.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6872,7 +6872,7 @@ Items with this property set should be removed from your local state.`,
     method: "post",
     path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/merge`,
     alias: "merge-excel-range",
-    description: `Invoke action merge`,
+    description: `Merge an Excel range.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6888,7 +6888,7 @@ Items with this property set should be removed from your local state.`,
     method: "post",
     path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/unmerge`,
     alias: "unmerge-excel-range",
-    description: `Invoke action unmerge`,
+    description: `Unmerge an Excel range.`,
     requestFormat: "json",
     response: z.void()
   },
@@ -6912,7 +6912,7 @@ Items with this property set should be removed from your local state.`,
     method: "get",
     path: "/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/usedRange()",
     alias: "get-excel-used-range",
-    description: `Invoke function usedRange`,
+    description: `Get an Excel used range.`,
     requestFormat: "json",
     response: z.void()
   },
@@ -7764,7 +7764,7 @@ from the default calendar of a group.`,
     method: "patch",
     path: "/me/calendar/calendarPermissions/:calendarPermissionId",
     alias: "update-my-calendar-permission",
-    description: `Update the navigation property calendarPermissions in me`,
+    description: `Update my calendar permission.`,
     requestFormat: "json",
     parameters: [
       {
@@ -7780,7 +7780,7 @@ from the default calendar of a group.`,
     method: "delete",
     path: "/me/calendar/calendarPermissions/:calendarPermissionId",
     alias: "delete-my-calendar-permission",
-    description: `Delete navigation property calendarPermissions for me`,
+    description: `Delete my calendar permission.`,
     requestFormat: "json",
     parameters: [
       {
@@ -7877,7 +7877,7 @@ from the default calendar of a group.`,
     method: "patch",
     path: "/me/calendars/:calendarId",
     alias: "update-calendar",
-    description: `Update the navigation property calendars in me`,
+    description: `Update a calendar.`,
     requestFormat: "json",
     parameters: [
       {
@@ -8110,7 +8110,7 @@ from the default calendar of a group.`,
     method: "patch",
     path: "/me/calendars/:calendarId/events/:eventId",
     alias: "update-specific-calendar-event",
-    description: `Update the navigation property events in me`,
+    description: `Update a specific calendar event.`,
     requestFormat: "json",
     parameters: [
       {
@@ -8178,7 +8178,7 @@ from the default calendar of a group.`,
     method: "delete",
     path: "/me/calendars/:calendarId/events/:eventId",
     alias: "delete-specific-calendar-event",
-    description: `Delete navigation property events for me`,
+    description: `Delete a specific calendar event.`,
     requestFormat: "json",
     parameters: [
       {
@@ -8386,7 +8386,7 @@ or from some other calendar of the user.`,
     method: "get",
     path: "/me/chats",
     alias: "list-chats",
-    description: `Get chats from me`,
+    description: `List chats.`,
     requestFormat: "json",
     parameters: [
       {
@@ -8920,7 +8920,7 @@ or from some other calendar of the user.`,
     method: "get",
     path: "/me/dataSecurityAndGovernance/sensitivityLabels",
     alias: "list-sensitivity-labels",
-    description: `Get sensitivityLabels from me`,
+    description: `List sensitivity labels.`,
     requestFormat: "json",
     parameters: [
       {
@@ -8970,7 +8970,7 @@ or from some other calendar of the user.`,
     method: "get",
     path: "/me/dataSecurityAndGovernance/sensitivityLabels/:sensitivityLabelId",
     alias: "get-sensitivity-label",
-    description: `Get sensitivityLabels from me`,
+    description: `Get a sensitivity label.`,
     requestFormat: "json",
     parameters: [
       {
@@ -10525,7 +10525,7 @@ resource.`,
     method: "delete",
     path: "/me/messages/:messageId/attachments/:attachmentId",
     alias: "delete-mail-attachment",
-    description: `Delete navigation property attachments for me`,
+    description: `Delete a mail attachment.`,
     requestFormat: "json",
     parameters: [
       {
@@ -10572,7 +10572,7 @@ resource.`,
     method: "post",
     path: "/me/messages/:messageId/createForward",
     alias: "create-forward-draft",
-    description: `Invoke action createForward`,
+    description: `Create a forward draft.`,
     requestFormat: "json",
     parameters: [
       {
@@ -12421,7 +12421,7 @@ Currently, a user can be associated with a team in two different ways:`,
     method: "get",
     path: "/places/:placeId/graph.roomList/rooms",
     alias: "list-room-list-rooms",
-    description: `Get rooms from places`,
+    description: `List room list rooms.`,
     requestFormat: "json",
     parameters: [
       {
@@ -12471,7 +12471,7 @@ Currently, a user can be associated with a team in two different ways:`,
     method: "get",
     path: "/places/:placeId/graph.roomList/rooms/:roomId",
     alias: "get-room-list-room",
-    description: `Get rooms from places`,
+    description: `Get a room list room.`,
     requestFormat: "json",
     parameters: [
       {
@@ -12985,7 +12985,7 @@ A site resource represents a team site in SharePoint.`,
     method: "get",
     path: "/sites/:siteId:/:path",
     alias: "get-sharepoint-site-by-path",
-    description: `Resolve a SharePoint site from its server-relative URL. site-id is the hostname (contoso.sharepoint.com) and path is the site path without a leading slash (sites/marketing, teams/hr). Returns the site object whose id feeds list-sharepoint-site-drives.`,
+    description: `Get a SharePoint site by path.`,
     requestFormat: "json",
     parameters: [
       {
@@ -13352,7 +13352,7 @@ To list them, include system in your $select statement.`,
     method: "patch",
     path: "/sites/:siteId/lists/:listId/columns/:columnDefinitionId",
     alias: "update-sharepoint-list-column",
-    description: `Update the navigation property columns in sites`,
+    description: `Update a SharePoint list column.`,
     requestFormat: "json",
     parameters: [
       {
@@ -13402,7 +13402,7 @@ To list them, include system in your $select statement.`,
     method: "delete",
     path: "/sites/:siteId/lists/:listId/columns/:columnDefinitionId",
     alias: "delete-sharepoint-list-column",
-    description: `Delete navigation property columns for sites`,
+    description: `Delete a SharePoint list column.`,
     requestFormat: "json",
     parameters: [
       {
@@ -13503,7 +13503,7 @@ To list them, include system in your $select statement.`,
     method: "patch",
     path: "/sites/:siteId/lists/:listId/items/:listItemId",
     alias: "update-sharepoint-list-item",
-    description: `Update the navigation property items in sites`,
+    description: `Update a SharePoint list item.`,
     requestFormat: "json",
     parameters: [
       {
@@ -13584,7 +13584,7 @@ To list them, include system in your $select statement.`,
     method: "post",
     path: "/sites/:siteId/onenote/notebooks",
     alias: "create-sharepoint-site-onenote-notebook",
-    description: `Create new navigation property to notebooks for sites`,
+    description: `Create a SharePoint site OneNote notebook.`,
     requestFormat: "json",
     parameters: [
       {
@@ -13700,7 +13700,7 @@ To list them, include system in your $select statement.`,
     method: "post",
     path: "/sites/:siteId/onenote/notebooks/:notebookId/sections",
     alias: "create-sharepoint-site-onenote-section",
-    description: `Create new navigation property to sections for sites`,
+    description: `Create a SharePoint site OneNote section.`,
     requestFormat: "json",
     parameters: [
       {
@@ -13716,7 +13716,7 @@ To list them, include system in your $select statement.`,
     method: "delete",
     path: "/sites/:siteId/onenote/pages/:onenotePageId",
     alias: "delete-sharepoint-site-onenote-page",
-    description: `Delete navigation property pages for sites`,
+    description: `Delete a SharePoint site OneNote page.`,
     requestFormat: "json",
     parameters: [
       {
@@ -13739,7 +13739,7 @@ To list them, include system in your $select statement.`,
     method: "patch",
     path: "/sites/:siteId/onenote/pages/:onenotePageId/content",
     alias: "update-sharepoint-site-onenote-page-content",
-    description: `update-sharepoint-site-onenote-page-content (synthesized)`,
+    description: `Update SharePoint site OneNote page content.`,
     requestFormat: "json",
     parameters: [
       {
@@ -13865,7 +13865,7 @@ To list them, include system in your $select statement.`,
     method: "post",
     path: "/sites/:siteId/onenote/sectionGroups/:sectionGroupId/sections",
     alias: "create-sharepoint-site-onenote-section-group-section",
-    description: `Create new navigation property to sections for sites`,
+    description: `Create a SharePoint site OneNote section group section.`,
     requestFormat: "json",
     parameters: [
       {
@@ -13931,7 +13931,7 @@ To list them, include system in your $select statement.`,
     method: "post",
     path: "/sites/:siteId/onenote/sections/:onenoteSectionId/pages",
     alias: "create-sharepoint-site-onenote-section-page",
-    description: `Create new navigation property to pages for sites`,
+    description: `Create a SharePoint site OneNote section page.`,
     requestFormat: "json",
     parameters: [
       {
@@ -14571,7 +14571,7 @@ Only the policyViolation property of a chatMessage can be updated in application
     method: "patch",
     path: "/teams/:teamId/channels/:channelId/messages/:chatMessageId/replies/:chatMessageId1",
     alias: "update-channel-message-reply",
-    description: `Update the navigation property replies in teams`,
+    description: `Update a channel message reply.`,
     requestFormat: "json",
     parameters: [
       {
@@ -14587,7 +14587,7 @@ Only the policyViolation property of a chatMessage can be updated in application
     method: "post",
     path: "/teams/:teamId/channels/:channelId/messages/:chatMessageId/setReaction",
     alias: "set-channel-message-reaction",
-    description: `Invoke action setReaction`,
+    description: `Set a channel message reaction.`,
     requestFormat: "json",
     parameters: [
       {
@@ -14603,7 +14603,7 @@ Only the policyViolation property of a chatMessage can be updated in application
     method: "post",
     path: "/teams/:teamId/channels/:channelId/messages/:chatMessageId/unsetReaction",
     alias: "unset-channel-message-reaction",
-    description: `Invoke action unsetReaction`,
+    description: `Unset a channel message reaction.`,
     requestFormat: "json",
     parameters: [
       {
@@ -15105,7 +15105,7 @@ Only the policyViolation property of a chatMessage can be updated in application
     method: "post",
     path: "/users/:userId/messages",
     alias: "create-shared-mailbox-draft",
-    description: `Create new navigation property to messages for users`,
+    description: `Create a shared mailbox draft.`,
     requestFormat: "json",
     parameters: [
       {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@softeria/ms-365-mcp-server",
   "mcpName": "io.github.Softeria/ms-365-mcp-server",
-  "version": "0.139.0",
+  "version": "0.139.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

@@ -105,6 +105,7 @@
     "pathPattern": "/users/{user-id}/messages/{message-id}",
     "method": "get",
     "toolName": "get-shared-mailbox-message",
+    "descriptionOverride": "Get a single Outlook message from another user's mailbox or a shared mailbox, by message ID. The user-id is the mailbox owner's ID or email address, and delegated access to that mailbox is required.",
     "presets": ["work"],
     "workScopes": ["Mail.Read.Shared"]
   },
@@ -411,6 +412,7 @@
     "pathPattern": "/me/calendars/{calendar-id}/events",
     "method": "get",
     "toolName": "list-specific-calendar-events",
+    "descriptionOverride": "List events from one of the signed-in user's calendars, addressed by calendar ID.",
     "presets": ["calendar", "outlook", "personal"],
     "scopes": ["Calendars.Read"],
     "supportsTimezone": true,
@@ -421,6 +423,7 @@
     "pathPattern": "/me/calendars/{calendar-id}/events/{event-id}",
     "method": "get",
     "toolName": "get-specific-calendar-event",
+    "descriptionOverride": "Get a single event from one of the signed-in user's calendars, addressed by calendar ID and event ID. Any calendar can be addressed this way, including the default one.",
     "presets": ["calendar", "outlook", "personal"],
     "scopes": ["Calendars.Read"],
     "supportsTimezone": true,
@@ -464,6 +467,7 @@
     "pathPattern": "/me/calendars/{calendar-id}/calendarView",
     "method": "get",
     "toolName": "get-specific-calendar-view",
+    "descriptionOverride": "List the occurrences, exceptions, and single instances of events over a time range, from one of the signed-in user's calendars addressed by calendar ID.",
     "presets": ["calendar", "outlook", "personal"],
     "scopes": ["Calendars.Read"],
     "supportsTimezone": true,
@@ -482,6 +486,7 @@
     "pathPattern": "/users/{user-id}/calendar/events",
     "method": "get",
     "toolName": "list-shared-calendar-events",
+    "descriptionOverride": "List events in another user's default calendar. The user-id is the calendar owner's ID or email address, and delegated access to that calendar is required. Recurring events are returned as a single series master, not expanded into occurrences - use get-shared-calendar-view for that.",
     "presets": ["work"],
     "workScopes": ["Calendars.Read.Shared"]
   },
@@ -489,6 +494,7 @@
     "pathPattern": "/users/{user-id}/calendarView",
     "method": "get",
     "toolName": "get-shared-calendar-view",
+    "descriptionOverride": "List the occurrences, exceptions, and single instances of events in another user's default calendar over a time range. Requires the startDateTime and endDateTime query parameters in ISO 8601 format. Unlike list-shared-calendar-events, recurring series are expanded into individual occurrences.",
     "presets": ["work"],
     "workScopes": ["Calendars.Read.Shared"],
     "supportsTimezone": true
@@ -1979,6 +1985,7 @@
     "pathPattern": "/copilot/retrieval",
     "method": "post",
     "toolName": "copilot-retrieve",
+    "descriptionOverride": "Search Microsoft 365 content using the Copilot Retrieval API. Grounds a natural-language query against the hybrid index behind Microsoft 365 Copilot and returns permission-trimmed text extracts with their source URLs.",
     "presets": ["search", "work"],
     "readOnly": true,
     "workScopes": [["Files.Read.All", "Sites.Read.All"], ["ExternalItem.Read.All"]],
@@ -2015,7 +2022,7 @@
         }
       }
     },
-    "llmTip": "Semantic/hybrid search over Microsoft 365 content via the Copilot Retrieval API. Grounds a natural-language query against the same hybrid index that powers Microsoft 365 Copilot and returns permission-trimmed text extracts with their source URLs — unlike search-query/search-onedrive-files/search-sharepoint-sites, which are lexical KQL. Prefer this for paraphrase/intent queries (e.g. resolving an informal project nickname, or matching 'packaging requirements' against text that never uses that phrase). Pass the request fields nested under a 'body' object: { queryString, dataSource, filterExpression?, resourceMetadata?, maximumNumberOfResults? }. Returns { retrievalHits: [{ webUrl, extracts: [{ text, relevanceScore }], resourceType, resourceMetadata, sensitivityLabel? }] }. Work/school accounts only (personal accounts are not supported). dataSource 'sharePoint'/'oneDriveBusiness' need delegated Files.Read.All + Sites.Read.All (requested by default); dataSource 'externalItem' (Copilot connectors) needs ExternalItem.Read.All, which is not requested by default - add it with --extra-scopes ExternalItem.Read.All."
+    "llmTip": "Retrieval here is semantic/hybrid, unlike search-query/search-onedrive-files/search-sharepoint-sites, which are lexical KQL. Prefer this for paraphrase/intent queries (e.g. resolving an informal project nickname, or matching 'packaging requirements' against text that never uses that phrase). Pass the request fields nested under a 'body' object: { queryString, dataSource, filterExpression?, resourceMetadata?, maximumNumberOfResults? }. Returns { retrievalHits: [{ webUrl, extracts: [{ text, relevanceScore }], resourceType, resourceMetadata, sensitivityLabel? }] }. Work/school accounts only (personal accounts are not supported). dataSource 'sharePoint'/'oneDriveBusiness' need delegated Files.Read.All + Sites.Read.All (requested by default); dataSource 'externalItem' (Copilot connectors) needs ExternalItem.Read.All, which is not requested by default - add it with --extra-scopes ExternalItem.Read.All."
   },
   {
     "pathPattern": "/me/onlineMeetings",
@@ -2216,17 +2223,19 @@
     "pathPattern": "/places/{place-id}/graph.roomList/rooms",
     "method": "get",
     "toolName": "list-room-list-rooms",
+    "descriptionOverride": "List the meeting rooms that belong to a room list.",
     "presets": ["calendar", "work"],
     "workScopes": ["Place.Read.All"],
-    "llmTip": "Lists rooms belonging to a specific room list. The place-id is the ID or email address of the room list (from get-room-list). Returns rooms with displayName, emailAddress, capacity, building, floorNumber, floorLabel, and AV equipment details. Combine with find-meeting-times to find available rooms for booking."
+    "llmTip": "The place-id is the ID or email address of the room list (from get-room-list). Returns rooms with displayName, emailAddress, capacity, building, floorNumber, floorLabel, and AV equipment details. Combine with find-meeting-times to find available rooms for booking."
   },
   {
     "pathPattern": "/places/{place-id}/graph.roomList/rooms/{room-id}",
     "method": "get",
     "toolName": "get-room-list-room",
+    "descriptionOverride": "Get a single meeting room from a room list, by room ID.",
     "presets": ["calendar", "work"],
     "workScopes": ["Place.Read.All"],
-    "llmTip": "Gets a specific room within a room list. The place-id is the room list ID or email, and room-id is the specific room ID. Returns full room details including capacity, building, floor, and AV equipment."
+    "llmTip": "The place-id is the room list ID or email, and room-id is the specific room ID. Returns full room details including capacity, building, floor, and AV equipment."
   },
   {
     "pathPattern": "/places/{place-id}",