@softeria/ms-365-mcp-server 0.105.0 → 0.106.0

package/dist/endpoints.json

@@ -1625,10 +1625,11 @@
     "llmTip": "Gets presence status for a specific user by their user ID or UPN (email). Returns availability and activity. Use list-users to find the user ID first."
   },
   {
-    "pathPattern": "/communications/presences",
+    "pathPattern": "/communications/getPresencesByUserId",
     "method": "post",
     "toolName": "get-presences-by-user-id",
     "workScopes": ["Presence.Read.All"],
+    "contentType": "application/json",
     "llmTip": "Gets presence for multiple users in a single call. Body: { ids: ['user-id-1', 'user-id-2', ...] }. Returns array of presence objects. More efficient than calling get-user-presence for each user. Maximum 650 user IDs per request."
   },
   {
@@ -2032,5 +2033,66 @@
     "workScopes": ["Notes.Read"],
     "contentType": "application/json",
     "llmTip": "Resolves a OneNote notebook from its web URL (the link a user copies from OneNote / SharePoint / Teams). Body: { webUrl: 'https://...' }. Returns a CopyNotebookModel with the notebook's id, displayName, sectionsUrl, sectionGroupsUrl, and isShared — you can then list its sections via list-onenote-notebook-sections. Accepts user notebooks, group notebooks, and SharePoint-hosted team notebooks. Personal Microsoft accounts are not supported."
+  },
+  {
+    "pathPattern": "/me/presence/setPresence",
+    "method": "post",
+    "toolName": "set-my-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Sets the user's presence session as an application. Body: { sessionId (your app's client/session id, required), availability ('Available' | 'Busy' | 'DoNotDisturb' | 'BeRightBack' | 'Away' | 'Offline'), activity ('Available' | 'InACall' | 'InAMeeting' | 'Presenting' | 'Busy' | 'Away' | 'OffWork' | 'Offline'), expirationDuration (ISO 8601 duration like 'PT1H' — defaults to PT5M, max PT24H) }. Note: if the user also wants to override their *visible* status regardless of activity, prefer set-my-user-preferred-presence. clear-my-presence ends the session."
+  },
+  {
+    "pathPattern": "/me/presence/clearPresence",
+    "method": "post",
+    "toolName": "clear-my-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Ends the application's presence session for the current user. Body: { sessionId } — must match the sessionId used in set-my-presence. If this was the user's only presence session, their status returns to Offline."
+  },
+  {
+    "pathPattern": "/me/presence/setUserPreferredPresence",
+    "method": "post",
+    "toolName": "set-my-user-preferred-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Sets the user's preferred (sticky) availability and activity — the value Teams clients display regardless of underlying activity. Body: { availability ('Available' | 'Busy' | 'DoNotDisturb' | 'BeRightBack' | 'Away' | 'Offline'), activity (same values), expirationDuration (ISO 8601 duration like 'PT2H' — omit for indefinite). Requires at least one active presence session (Teams client signed in or set-my-presence call). Use this for 'put me in Do Not Disturb for 2 hours' workflows. clear-my-user-preferred-presence reverts to actual presence."
+  },
+  {
+    "pathPattern": "/me/presence/clearUserPreferredPresence",
+    "method": "post",
+    "toolName": "clear-my-user-preferred-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "llmTip": "Clears any preferred (sticky) presence override set via set-my-user-preferred-presence. The user's visible status returns to their actual activity (e.g. Available when free, InAMeeting when in a call). No request body."
+  },
+  {
+    "pathPattern": "/me/presence/setStatusMessage",
+    "method": "post",
+    "toolName": "set-my-status-message",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Sets the user's Teams status message (the free-text note shown next to their name, e.g. 'Heads-down on Q3 plan'). Body: { statusMessage: { message: { content: 'text or HTML', contentType: 'text' | 'html' }, expiryDateTime: { dateTime: '2026-05-06T17:00:00', timeZone: 'UTC' } (optional) } }. Pass an empty object {} or message.content='' to clear. expiryDateTime is optional — omit for no expiration."
+  },
+  {
+    "pathPattern": "/me/teamwork/associatedTeams",
+    "method": "get",
+    "toolName": "list-my-associated-teams",
+    "workScopes": ["Team.ReadBasic.All"],
+    "llmTip": "Lists Teams the current user is associated with — both joined teams and host teams of shared channels the user is a direct member of. Returns associatedTeamInfo objects with id, displayName, and tenantId. Broader than list-joined-teams because it includes shared-channel host teams."
+  },
+  {
+    "pathPattern": "/me/teamwork/installedApps",
+    "method": "get",
+    "toolName": "list-my-installed-teams-apps",
+    "workScopes": ["TeamsAppInstallation.ReadForUser"],
+    "llmTip": "Lists Teams apps installed in the current user's personal scope (the apps pinned to the user's Teams sidebar / accessible without joining a team or chat). Use $expand=teamsApp,teamsAppDefinition for full app metadata (displayName, version, distributionMethod). Useful before send-my-activity-notification to discover the user's own teamsAppId."
+  },
+  {
+    "pathPattern": "/me/teamwork/sendActivityNotification",
+    "method": "post",
+    "toolName": "send-my-activity-notification",
+    "workScopes": ["TeamsActivity.Send"],
+    "contentType": "application/json",
+    "llmTip": "Sends a Teams activity feed notification to the current user (the badge + entry in their Activity tab). Body: { topic: { source: 'entityUrl' | 'text', value: <Graph URL or plain text>, webUrl?: <click-through URL when source=text> }, activityType: <one of the activity types declared in the calling app's Teams manifest>, previewText: { content: 'short preview' }, templateParameters?: [{ name, value }] (substituted into the manifest's localized notification template), teamsAppId?: <required when caller is not a Teams app — fetch via list-my-installed-teams-apps>, chainId?, iconId? }. Use to ping the user with 'action required' notifications from agentic workflows. activityType must exist in the Teams app manifest — see https://learn.microsoft.com/graph/teams-send-activityfeednotifications."
   }
 ]

package/dist/generated/client.js

@@ -432,6 +432,8 @@ const microsoft_graph_pinnedChatMessageInfoCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_pinnedChatMessageInfo)
 }).partial().passthrough();
+const get_presences_by_user_id_Body = z.object({ ids: z.array(z.string()) }).partial().passthrough();
+const BaseCollectionPaginationCountResponse = z.object({ "@odata.count": z.number().int().nullable(), "@odata.nextLink": z.string().nullable() }).partial().passthrough();
 const microsoft_graph_outOfOfficeSettings = z.object({
   isOutOfOffice: z.boolean().describe(
     "If true, either of the following is met:The current time falls within the out-of-office window configured in Outlook or Teams.An event marked as 'Show as Out of Office' appears on the user's calendar.Otherwise, false."
@@ -900,7 +902,6 @@ const share_drive_item_Body = z.object({
   expirationDateTime: z.string().nullable(),
   password: z.string().nullable()
 }).partial().passthrough();
-const BaseCollectionPaginationCountResponse = z.object({ "@odata.count": z.number().int().nullable(), "@odata.nextLink": z.string().nullable() }).partial().passthrough();
 const ReferenceNumeric = z.enum(["-INF", "INF", "NaN"]);
 const create_drive_item_preview_Body = z.object({
   page: z.string().nullable(),
@@ -3780,6 +3781,55 @@ const microsoft_graph_plannerTaskCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_plannerTask)
 }).partial().passthrough();
+const set_my_presence_Body = z.object({
+  sessionId: z.string().nullable(),
+  availability: z.string(),
+  activity: z.string(),
+  expirationDuration: z.string().regex(/^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$/).nullable()
+}).partial().passthrough();
+const set_my_status_message_Body = z.object({
+  statusMessage: z.union([
+    microsoft_graph_presenceStatusMessage,
+    z.object({}).partial().passthrough()
+  ])
+}).partial().passthrough();
+const set_my_user_preferred_presence_Body = z.object({
+  availability: z.string(),
+  activity: z.string(),
+  expirationDuration: z.string().regex(/^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$/).nullable()
+}).partial().passthrough();
+const microsoft_graph_associatedTeamInfo = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  displayName: z.string().describe("The name of the team.").nullish(),
+  tenantId: z.string().describe("The ID of the Microsoft Entra tenant.").nullish(),
+  team: microsoft_graph_team.describe("[Note: Simplified from 30 properties to 25 most common ones]").optional()
+}).passthrough();
+const microsoft_graph_associatedTeamInfoCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_associatedTeamInfo)
+}).partial().passthrough();
+const microsoft_graph_userScopeTeamsAppInstallation = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  consentedPermissionSet: microsoft_graph_teamsAppPermissionSet.optional(),
+  teamsApp: microsoft_graph_teamsApp.optional(),
+  teamsAppDefinition: microsoft_graph_teamsAppDefinition.optional(),
+  chat: microsoft_graph_chat.optional()
+}).passthrough();
+const microsoft_graph_userScopeTeamsAppInstallationCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_userScopeTeamsAppInstallation)
+}).partial().passthrough();
+const send_my_activity_notification_Body = z.object({
+  topic: z.object({}).partial().passthrough(),
+  activityType: z.string().nullable(),
+  chainId: z.number().nullable(),
+  previewText: z.union([microsoft_graph_itemBody, z.object({}).partial().passthrough()]),
+  teamsAppId: z.string().nullable(),
+  templateParameters: z.array(z.object({}).partial().passthrough()),
+  iconId: z.string().nullable()
+}).partial().passthrough();
 const microsoft_graph_wellknownListName = z.enum([
   "none",
   "defaultList",
@@ -4623,6 +4673,8 @@ const schemas = {
   microsoft_graph_chatMessageCollectionResponse,
   microsoft_graph_chatMessageHostedContentCollectionResponse,
   microsoft_graph_pinnedChatMessageInfoCollectionResponse,
+  get_presences_by_user_id_Body,
+  BaseCollectionPaginationCountResponse,
   microsoft_graph_outOfOfficeSettings,
   microsoft_graph_dateTimeTimeZone,
   microsoft_graph_presenceStatusMessage,
@@ -4669,7 +4721,6 @@ const schemas = {
   microsoft_graph_sensitivityLabelAssignment,
   microsoft_graph_extractSensitivityLabelsResult,
   share_drive_item_Body,
-  BaseCollectionPaginationCountResponse,
   ReferenceNumeric,
   create_drive_item_preview_Body,
   microsoft_graph_itemPreviewInfo,
@@ -4957,6 +5008,14 @@ const schemas = {
   microsoft_graph_plannerBucketTaskBoardTaskFormat,
   microsoft_graph_plannerTask,
   microsoft_graph_plannerTaskCollectionResponse,
+  set_my_presence_Body,
+  set_my_status_message_Body,
+  set_my_user_preferred_presence_Body,
+  microsoft_graph_associatedTeamInfo,
+  microsoft_graph_associatedTeamInfoCollectionResponse,
+  microsoft_graph_userScopeTeamsAppInstallation,
+  microsoft_graph_userScopeTeamsAppInstallationCollectionResponse,
+  send_my_activity_notification_Body,
   microsoft_graph_wellknownListName,
   microsoft_graph_taskStatus,
   microsoft_graph_attachmentBase,
@@ -5462,16 +5521,16 @@ const endpoints = makeApi([
   },
   {
     method: "post",
-    path: "/communications/presences",
+    path: "/communications/getPresencesByUserId",
     alias: "get-presences-by-user-id",
-    description: `Create new navigation property to presences for communications`,
+    description: `Get the presence information for multiple users.`,
     requestFormat: "json",
     parameters: [
       {
         name: "body",
-        description: `New navigation property`,
+        description: `Action parameters`,
         type: "Body",
-        schema: microsoft_graph_presence
+        schema: get_presences_by_user_id_Body
       }
     ],
     response: z.void()
@@ -11371,6 +11430,78 @@ getting the user's mailbox settings.`,
     ],
     response: z.void()
   },
+  {
+    method: "post",
+    path: "/me/presence/clearPresence",
+    alias: "clear-my-presence",
+    description: `Clear the application's presence session for a user. If it is the user's only presence session, the user's presence will change to Offline/Offline. For details about presences sessions, see presence: setPresence.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: z.object({ sessionId: z.string().nullable() }).partial().passthrough()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: "/me/presence/clearUserPreferredPresence",
+    alias: "clear-my-user-preferred-presence",
+    description: `Clear the preferred availability and activity status for a user.`,
+    requestFormat: "json",
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: "/me/presence/setPresence",
+    alias: "set-my-presence",
+    description: `Set the state of a user's presence session as an application. For more information about presence sessions, states permutations, and timeouts, see Manage presence state using the Microsoft Graph API.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: set_my_presence_Body
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: "/me/presence/setStatusMessage",
+    alias: "set-my-status-message",
+    description: `Set a presence status message for a user. An optional expiration date and time can be supplied.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: set_my_status_message_Body
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: "/me/presence/setUserPreferredPresence",
+    alias: "set-my-user-preferred-presence",
+    description: `Set the preferred availability and activity status for a user. If the preferred presence of a user is set, the user's presence shows as the preferred status. Preferred presence takes effect only when at least one presence session exists for the user. Otherwise, the user's presence shows as Offline. A presence session is created as a result of a successful setPresence operation, or if the user is signed in on a Microsoft Teams client. For more details, see presence sessions and time-out and expiration.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: set_my_user_preferred_presence_Body
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "post",
     path: "/me/sendMail",
@@ -11387,6 +11518,123 @@ getting the user's mailbox settings.`,
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/me/teamwork/associatedTeams",
+    alias: "list-my-associated-teams",
+    description: `Get the list of teams in Microsoft Teams that a user is associated with.
+Currently, a user can be associated with a team in two different ways:`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "$top",
+        type: "Query",
+        schema: z.number().int().gte(0).describe("Show only the first n items").optional()
+      },
+      {
+        name: "$skip",
+        type: "Query",
+        schema: z.number().int().gte(0).describe("Skip the first n items").optional()
+      },
+      {
+        name: "$search",
+        type: "Query",
+        schema: z.string().describe("Search items by search phrases").optional()
+      },
+      {
+        name: "$filter",
+        type: "Query",
+        schema: z.string().describe("Filter items by property values").optional()
+      },
+      {
+        name: "$count",
+        type: "Query",
+        schema: z.boolean().describe("Include count of items").optional()
+      },
+      {
+        name: "$orderby",
+        type: "Query",
+        schema: z.array(z.string()).describe("Order items by property values").optional()
+      },
+      {
+        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: "get",
+    path: "/me/teamwork/installedApps",
+    alias: "list-my-installed-teams-apps",
+    description: `The apps installed in the personal scope of this user.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "$top",
+        type: "Query",
+        schema: z.number().int().gte(0).describe("Show only the first n items").optional()
+      },
+      {
+        name: "$skip",
+        type: "Query",
+        schema: z.number().int().gte(0).describe("Skip the first n items").optional()
+      },
+      {
+        name: "$search",
+        type: "Query",
+        schema: z.string().describe("Search items by search phrases").optional()
+      },
+      {
+        name: "$filter",
+        type: "Query",
+        schema: z.string().describe("Filter items by property values").optional()
+      },
+      {
+        name: "$count",
+        type: "Query",
+        schema: z.boolean().describe("Include count of items").optional()
+      },
+      {
+        name: "$orderby",
+        type: "Query",
+        schema: z.array(z.string()).describe("Order items by property values").optional()
+      },
+      {
+        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: "post",
+    path: "/me/teamwork/sendActivityNotification",
+    alias: "send-my-activity-notification",
+    description: `Send an activity feed notification to a user. For more information, see sending Teams activity notifications.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: send_my_activity_notification_Body
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/me/todo/lists",

package/package.json

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

package/src/endpoints.json

@@ -1625,10 +1625,11 @@
     "llmTip": "Gets presence status for a specific user by their user ID or UPN (email). Returns availability and activity. Use list-users to find the user ID first."
   },
   {
-    "pathPattern": "/communications/presences",
+    "pathPattern": "/communications/getPresencesByUserId",
     "method": "post",
     "toolName": "get-presences-by-user-id",
     "workScopes": ["Presence.Read.All"],
+    "contentType": "application/json",
     "llmTip": "Gets presence for multiple users in a single call. Body: { ids: ['user-id-1', 'user-id-2', ...] }. Returns array of presence objects. More efficient than calling get-user-presence for each user. Maximum 650 user IDs per request."
   },
   {
@@ -2032,5 +2033,66 @@
     "workScopes": ["Notes.Read"],
     "contentType": "application/json",
     "llmTip": "Resolves a OneNote notebook from its web URL (the link a user copies from OneNote / SharePoint / Teams). Body: { webUrl: 'https://...' }. Returns a CopyNotebookModel with the notebook's id, displayName, sectionsUrl, sectionGroupsUrl, and isShared — you can then list its sections via list-onenote-notebook-sections. Accepts user notebooks, group notebooks, and SharePoint-hosted team notebooks. Personal Microsoft accounts are not supported."
+  },
+  {
+    "pathPattern": "/me/presence/setPresence",
+    "method": "post",
+    "toolName": "set-my-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Sets the user's presence session as an application. Body: { sessionId (your app's client/session id, required), availability ('Available' | 'Busy' | 'DoNotDisturb' | 'BeRightBack' | 'Away' | 'Offline'), activity ('Available' | 'InACall' | 'InAMeeting' | 'Presenting' | 'Busy' | 'Away' | 'OffWork' | 'Offline'), expirationDuration (ISO 8601 duration like 'PT1H' — defaults to PT5M, max PT24H) }. Note: if the user also wants to override their *visible* status regardless of activity, prefer set-my-user-preferred-presence. clear-my-presence ends the session."
+  },
+  {
+    "pathPattern": "/me/presence/clearPresence",
+    "method": "post",
+    "toolName": "clear-my-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Ends the application's presence session for the current user. Body: { sessionId } — must match the sessionId used in set-my-presence. If this was the user's only presence session, their status returns to Offline."
+  },
+  {
+    "pathPattern": "/me/presence/setUserPreferredPresence",
+    "method": "post",
+    "toolName": "set-my-user-preferred-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Sets the user's preferred (sticky) availability and activity — the value Teams clients display regardless of underlying activity. Body: { availability ('Available' | 'Busy' | 'DoNotDisturb' | 'BeRightBack' | 'Away' | 'Offline'), activity (same values), expirationDuration (ISO 8601 duration like 'PT2H' — omit for indefinite). Requires at least one active presence session (Teams client signed in or set-my-presence call). Use this for 'put me in Do Not Disturb for 2 hours' workflows. clear-my-user-preferred-presence reverts to actual presence."
+  },
+  {
+    "pathPattern": "/me/presence/clearUserPreferredPresence",
+    "method": "post",
+    "toolName": "clear-my-user-preferred-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "llmTip": "Clears any preferred (sticky) presence override set via set-my-user-preferred-presence. The user's visible status returns to their actual activity (e.g. Available when free, InAMeeting when in a call). No request body."
+  },
+  {
+    "pathPattern": "/me/presence/setStatusMessage",
+    "method": "post",
+    "toolName": "set-my-status-message",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Sets the user's Teams status message (the free-text note shown next to their name, e.g. 'Heads-down on Q3 plan'). Body: { statusMessage: { message: { content: 'text or HTML', contentType: 'text' | 'html' }, expiryDateTime: { dateTime: '2026-05-06T17:00:00', timeZone: 'UTC' } (optional) } }. Pass an empty object {} or message.content='' to clear. expiryDateTime is optional — omit for no expiration."
+  },
+  {
+    "pathPattern": "/me/teamwork/associatedTeams",
+    "method": "get",
+    "toolName": "list-my-associated-teams",
+    "workScopes": ["Team.ReadBasic.All"],
+    "llmTip": "Lists Teams the current user is associated with — both joined teams and host teams of shared channels the user is a direct member of. Returns associatedTeamInfo objects with id, displayName, and tenantId. Broader than list-joined-teams because it includes shared-channel host teams."
+  },
+  {
+    "pathPattern": "/me/teamwork/installedApps",
+    "method": "get",
+    "toolName": "list-my-installed-teams-apps",
+    "workScopes": ["TeamsAppInstallation.ReadForUser"],
+    "llmTip": "Lists Teams apps installed in the current user's personal scope (the apps pinned to the user's Teams sidebar / accessible without joining a team or chat). Use $expand=teamsApp,teamsAppDefinition for full app metadata (displayName, version, distributionMethod). Useful before send-my-activity-notification to discover the user's own teamsAppId."
+  },
+  {
+    "pathPattern": "/me/teamwork/sendActivityNotification",
+    "method": "post",
+    "toolName": "send-my-activity-notification",
+    "workScopes": ["TeamsActivity.Send"],
+    "contentType": "application/json",
+    "llmTip": "Sends a Teams activity feed notification to the current user (the badge + entry in their Activity tab). Body: { topic: { source: 'entityUrl' | 'text', value: <Graph URL or plain text>, webUrl?: <click-through URL when source=text> }, activityType: <one of the activity types declared in the calling app's Teams manifest>, previewText: { content: 'short preview' }, templateParameters?: [{ name, value }] (substituted into the manifest's localized notification template), teamsAppId?: <required when caller is not a Teams app — fetch via list-my-installed-teams-apps>, chainId?, iconId? }. Use to ping the user with 'action required' notifications from agentic workflows. activityType must exist in the Teams app manifest — see https://learn.microsoft.com/graph/teams-send-activityfeednotifications."
   }
 ]