feat: add title annotations to all MCP tools

Add human-readable title annotations to all 111 tools as required
by Anthropic's MCP Connectors Directory submission guidelines.

Tools updated across all modules:
- room-management (10 tools)
- session-management (11 tools)
- analytics-tools (8 tools)
- live-session-controls (8 tools)
- communication-management (13 tools)
- poll-management (6 tools)
- webhook-management (6 tools)
- role-management (6 tools)
- export-tools (7 tools)
- library-management (26 tools)
- recording-tools-adapter (10 tools)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: ConalMullan

src/tools/analytics-tools/index.ts

@@ -25,7 +25,7 @@ export function registerAnalyticsTools(): Tool[] {
       name: "get-participant-statistics",
       description:
         '[Analytics] Get detailed participant statistics and behavior analytics. Use when users say: "show participant stats", "participant analytics", "user activity report", "attendee statistics", "who attended meetings", "participant engagement metrics". Optional filters for date range, room, or specific participant. Returns attendance, duration, and activity data.',
-      annotations: getToolAnnotations("get-participant-statistics"),
+      annotations: getToolAnnotations("get-participant-statistics", "Get Participant Statistics"),
       inputSchema: {
         type: "object",
         properties: {
@@ -57,7 +57,7 @@ export function registerAnalyticsTools(): Tool[] {
       name: "get-room-analytics",
       description:
         '[Analytics] Get comprehensive room usage analytics and performance metrics. Use when users say: "room analytics", "room usage statistics", "meeting room performance", "room activity report", "how is the room being used", "room metrics". Optional roomId for specific room or all rooms. Returns usage patterns, participant counts, session data.',
-      annotations: getToolAnnotations("get-room-analytics"),
+      annotations: getToolAnnotations("get-room-analytics", "Get Room Analytics"),
       inputSchema: {
         type: "object",
         properties: {
@@ -86,7 +86,7 @@ export function registerAnalyticsTools(): Tool[] {
       name: "get-usage-statistics",
       description:
         '[Analytics - TOOL] Get filtered platform usage statistics with specific date ranges and periods. Use when users need: "analytics for specific dates", "weekly/monthly analytics", "analytics for last week", "analytics between dates". For simple "show analytics" use digitalsamba://analytics/team resource instead. Returns sessions, participants, minutes filtered by your criteria.',
-      annotations: getToolAnnotations("get-usage-statistics"),
+      annotations: getToolAnnotations("get-usage-statistics", "Get Usage Statistics"),
       inputSchema: {
         type: "object",
         properties: {
@@ -112,7 +112,7 @@ export function registerAnalyticsTools(): Tool[] {
       name: "get-usage-analytics",
       description:
         '[Analytics - TOOL] Get platform usage statistics and growth trends. Use when users say: "usage trends", "platform growth", "total meeting minutes", "usage statistics", "growth metrics". This TOOL provides the same data as digitalsamba://analytics/usage resource. Supports date filters and period grouping. Returns total sessions, participants, minutes, and growth rates.',
-      annotations: getToolAnnotations("get-usage-analytics"),
+      annotations: getToolAnnotations("get-usage-analytics", "Get Usage Analytics"),
       inputSchema: {
         type: "object",
         properties: {
@@ -136,7 +136,7 @@ export function registerAnalyticsTools(): Tool[] {
       name: "get-live-analytics",
       description:
         '[Analytics - TOOL] Get real-time analytics for all active sessions. Use when users say: "live session data", "current activity", "real-time analytics", "active sessions", "live meeting stats". This TOOL provides the same data as digitalsamba://analytics/live resource. Returns current active sessions and participant counts.',
-      annotations: getToolAnnotations("get-live-analytics"),
+      annotations: getToolAnnotations("get-live-analytics", "Get Live Analytics"),
       inputSchema: {
         type: "object",
         properties: {
@@ -151,7 +151,7 @@ export function registerAnalyticsTools(): Tool[] {
       name: "get-live-room-analytics",
       description:
         '[Analytics - TOOL] Get real-time analytics for a specific room. Use when users say: "live room analytics", "current room activity", "real-time room data", "active room session", "live room stats". Requires roomId. This TOOL provides the same data as digitalsamba://analytics/live/{roomId} resource. Returns current session status and participant activity for that room.',
-      annotations: getToolAnnotations("get-live-room-analytics"),
+      annotations: getToolAnnotations("get-live-room-analytics", "Get Live Room Analytics"),
       inputSchema: {
         type: "object",
         properties: {
@@ -167,7 +167,7 @@ export function registerAnalyticsTools(): Tool[] {
       name: "get-session-analytics",
       description:
         '[Analytics - TOOL] Get detailed analytics for a specific session. Use when users say: "session analytics", "meeting analytics", "session performance data", "session metrics", "meeting statistics". Requires sessionId. This TOOL provides the same data as digitalsamba://analytics/sessions/{sessionId} resource. Returns comprehensive session analytics including participant engagement and activity patterns.',
-      annotations: getToolAnnotations("get-session-analytics"),
+      annotations: getToolAnnotations("get-session-analytics", "Get Session Analytics"),
       inputSchema: {
         type: "object",
         properties: {
@@ -183,7 +183,7 @@ export function registerAnalyticsTools(): Tool[] {
       name: "get-participant-analytics",
       description:
         '[Analytics - TOOL] Get analytics for a specific participant across sessions. Use when users say: "user analytics", "participant history", "individual user stats", "participant metrics", "user engagement data". Requires participantId. This TOOL provides the same data as digitalsamba://analytics/participants/{participantId} resource. Returns participant activity across all sessions they joined.',
-      annotations: getToolAnnotations("get-participant-analytics"),
+      annotations: getToolAnnotations("get-participant-analytics", "Get Participant Analytics"),
       inputSchema: {
         type: "object",
         properties: {

src/tools/communication-management/index.ts

@@ -57,7 +57,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "delete-session-chats",
       description:
         '[Communication Management] Delete all chat messages for a session. Use when users say: "delete session chat", "remove chat messages", "clear session chat history", "delete chat from session", "wipe chat messages". Requires sessionId. This permanently removes all chat data.',
-      annotations: getToolAnnotations("delete-session-chats"),
+      annotations: getToolAnnotations("delete-session-chats", "Delete Session Chats"),
       inputSchema: {
         type: "object",
         properties: {
@@ -73,7 +73,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "delete-room-chats",
       description:
         '[Communication Management] Delete all chat messages from ALL sessions in a room. Use when users say: "delete all room chats", "clear room chat history", "remove all chat messages from room", "wipe room chats". Requires roomId. Affects all past and current sessions.',
-      annotations: getToolAnnotations("delete-room-chats"),
+      annotations: getToolAnnotations("delete-room-chats", "Delete Room Chats"),
       inputSchema: {
         type: "object",
         properties: {
@@ -91,7 +91,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "delete-session-qa",
       description:
         '[Communication Management] Delete all Q&A (questions and answers) from a session. Use when users say: "delete session Q&A", "remove questions and answers", "clear Q&A history", "delete session questions", "wipe Q&A data". Requires sessionId. Removes all Q&A interactions.',
-      annotations: getToolAnnotations("delete-session-qa"),
+      annotations: getToolAnnotations("delete-session-qa", "Delete Session Q&A"),
       inputSchema: {
         type: "object",
         properties: {
@@ -107,7 +107,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "delete-room-qa",
       description:
         '[Communication Management] Delete all Q&A from ALL sessions in a room. Use when users say: "delete all room Q&A", "clear room questions", "remove all Q&A from room", "wipe room Q&A history". Requires roomId. Affects all sessions\' Q&A data.',
-      annotations: getToolAnnotations("delete-room-qa"),
+      annotations: getToolAnnotations("delete-room-qa", "Delete Room Q&A"),
       inputSchema: {
         type: "object",
         properties: {
@@ -125,7 +125,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "list-room-transcripts",
       description:
         '[Communication Management] Get closed captioning transcripts for a room. Use when users say: "get room transcripts", "show transcription", "list captions", "view closed captions", "get transcript history". Returns paginated list of transcript entries with participant info.',
-      annotations: getToolAnnotations("list-room-transcripts"),
+      annotations: getToolAnnotations("list-room-transcripts", "List Room Transcripts"),
       inputSchema: {
         type: "object",
         properties: {
@@ -153,7 +153,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "list-session-transcripts",
       description:
         '[Communication Management] Get closed captioning transcripts for a specific session. Use when users say: "get session transcript", "show meeting captions", "view session transcription". Returns paginated transcript entries for a single session.',
-      annotations: getToolAnnotations("list-session-transcripts"),
+      annotations: getToolAnnotations("list-session-transcripts", "List Session Transcripts"),
       inputSchema: {
         type: "object",
         properties: {
@@ -177,7 +177,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "export-room-transcripts",
       description:
         '[Communication Management] Export all room transcripts to a file format. Use when users say: "export room transcript", "download captions", "save transcript as text", "export closed captions". Supports txt or json format.',
-      annotations: getToolAnnotations("export-room-transcripts"),
+      annotations: getToolAnnotations("export-room-transcripts", "Export Room Transcripts"),
       inputSchema: {
         type: "object",
         properties: {
@@ -198,7 +198,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "delete-session-transcripts",
       description:
         '[Communication Management] Delete all transcription data from a session. Use when users say: "delete session transcript", "remove transcription", "clear transcript", "delete meeting transcript", "wipe transcription data". Requires sessionId. Permanently removes transcript records.',
-      annotations: getToolAnnotations("delete-session-transcripts"),
+      annotations: getToolAnnotations("delete-session-transcripts", "Delete Session Transcripts"),
       inputSchema: {
         type: "object",
         properties: {
@@ -214,7 +214,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "delete-room-transcripts",
       description:
         '[Communication Management] Delete all transcripts from a room. Use when users say: "delete all room transcripts", "clear room transcription history", "remove all transcripts from room", "wipe room transcripts". Requires roomId. Permanently removes all transcript records.',
-      annotations: getToolAnnotations("delete-room-transcripts"),
+      annotations: getToolAnnotations("delete-room-transcripts", "Delete Room Transcripts"),
       inputSchema: {
         type: "object",
         properties: {
@@ -232,7 +232,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "delete-session-summaries",
       description:
         '[Communication Management] Delete AI-generated summaries from a session. Use when users say: "delete session summary", "remove AI summary", "clear meeting summary", "delete session notes", "wipe summary data". Requires sessionId. Removes all AI-generated session summaries.',
-      annotations: getToolAnnotations("delete-session-summaries"),
+      annotations: getToolAnnotations("delete-session-summaries", "Delete Session Summaries"),
       inputSchema: {
         type: "object",
         properties: {
@@ -248,7 +248,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "delete-room-summaries",
       description:
         '[Communication Management] Delete all AI summaries from ALL sessions in a room. Use when users say: "delete all room summaries", "clear room AI summaries", "remove all summaries from room", "wipe room summary history". Requires roomId. Affects all sessions\' AI summaries.',
-      annotations: getToolAnnotations("delete-room-summaries"),
+      annotations: getToolAnnotations("delete-room-summaries", "Delete Room Summaries"),
       inputSchema: {
         type: "object",
         properties: {
@@ -266,7 +266,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "delete-session-recordings",
       description:
         '[Communication Management] Delete all recordings from a session. Use when users say: "delete session recordings", "remove session videos", "clear session recordings". Requires session_id. Permanently removes all recording data for the session.',
-      annotations: getToolAnnotations("delete-session-recordings"),
+      annotations: getToolAnnotations("delete-session-recordings", "Delete Session Recordings"),
       inputSchema: {
         type: "object",
         properties: {
@@ -282,7 +282,7 @@ export function registerCommunicationTools(): ToolDefinition[] {
       name: "delete-session-resources",
       description:
         '[Communication Management] Delete all shared resources from a session. Use when users say: "delete session resources", "remove session files", "clear session shared content". Requires session_id. Permanently removes all shared files/content.',
-      annotations: getToolAnnotations("delete-session-resources"),
+      annotations: getToolAnnotations("delete-session-resources", "Delete Session Resources"),
       inputSchema: {
         type: "object",
         properties: {

src/tools/export-tools/index.ts

@@ -219,7 +219,7 @@ export function registerExportTools(): Tool[] {
       name: "export-chat-messages",
       description:
         "[Export Tools] Export chat messages from a room. Use when users say: \"export chat\", \"download chat messages\", \"export room chat\", \"get chat history\", \"save chat messages\". Mirrors digitalsamba://exports/communications/{roomId}/chat resource for AI assistant compatibility. Requires roomId. Supports format (txt/json) and optional sessionId for specific sessions.",
-      annotations: getToolAnnotations("export-chat-messages"),
+      annotations: getToolAnnotations("export-chat-messages", "Export Chat Messages"),
       inputSchema: {
         type: "object",
         properties: {
@@ -244,7 +244,7 @@ export function registerExportTools(): Tool[] {
       name: "export-qa-data",
       description:
         "[Export Tools] Export questions and answers from a room. Use when users say: \"export Q&A\", \"download questions\", \"export Q&A data\", \"get question history\", \"save Q&A session\". Mirrors digitalsamba://exports/communications/{roomId}/qa resource for AI assistant compatibility. Requires roomId. Supports format and optional sessionId.",
-      annotations: getToolAnnotations("export-qa-data"),
+      annotations: getToolAnnotations("export-qa-data", "Export Q&A Data"),
       inputSchema: {
         type: "object",
         properties: {
@@ -269,7 +269,7 @@ export function registerExportTools(): Tool[] {
       name: "export-session-transcripts",
       description:
         "[Export Tools] Export transcription data from a session. Use when users say: \"export transcript\", \"download transcripts\", \"export transcription\", \"get transcript\", \"save meeting transcript\". Mirrors digitalsamba://exports/communications/{sessionId}/transcripts resource for AI assistant compatibility. Requires sessionId.",
-      annotations: getToolAnnotations("export-session-transcripts"),
+      annotations: getToolAnnotations("export-session-transcripts", "Export Session Transcripts"),
       inputSchema: {
         type: "object",
         properties: {
@@ -290,7 +290,7 @@ export function registerExportTools(): Tool[] {
       name: "export-poll-results",
       description:
         "[Export Tools] Export poll questions, options, and results from a room. Use when users say: \"export polls\", \"download poll results\", \"export poll data\", \"get poll results\", \"save poll information\". Mirrors digitalsamba://exports/polls/{roomId} resource for AI assistant compatibility. Requires roomId.",
-      annotations: getToolAnnotations("export-poll-results"),
+      annotations: getToolAnnotations("export-poll-results", "Export Poll Results"),
       inputSchema: {
         type: "object",
         properties: {
@@ -315,7 +315,7 @@ export function registerExportTools(): Tool[] {
       name: "export-recording-metadata",
       description:
         "[Export Tools] Get recording metadata and download information. Use when users say: \"export recording info\", \"get recording metadata\", \"recording export details\", \"recording information\", \"download recording details\". Mirrors digitalsamba://exports/recordings/{recordingId} resource for AI assistant compatibility. Requires recordingId.",
-      annotations: getToolAnnotations("export-recording-metadata"),
+      annotations: getToolAnnotations("export-recording-metadata", "Export Recording Metadata"),
       inputSchema: {
         type: "object",
         properties: {
@@ -331,7 +331,7 @@ export function registerExportTools(): Tool[] {
       name: "export-session-summary",
       description:
         "[Export Tools] Export comprehensive session summary with key metrics. Use when users say: \"export session summary\", \"get meeting report\", \"session overview\", \"meeting summary\", \"export session report\". Mirrors digitalsamba://exports/sessions/{sessionId}/summary resource for AI assistant compatibility. Requires sessionId.",
-      annotations: getToolAnnotations("export-session-summary"),
+      annotations: getToolAnnotations("export-session-summary", "Export Session Summary"),
       inputSchema: {
         type: "object",
         properties: {
@@ -347,7 +347,7 @@ export function registerExportTools(): Tool[] {
       name: "export-session-metadata",
       description:
         "[Export Tools] Export complete session metadata in JSON format. Use when users say: \"export session metadata\", \"get full session data\", \"complete session info\", \"session raw data\", \"export technical session data\". Mirrors digitalsamba://exports/sessions/{sessionId}/metadata resource for AI assistant compatibility. Requires sessionId.",
-      annotations: getToolAnnotations("export-session-metadata"),
+      annotations: getToolAnnotations("export-session-metadata", "Export Session Metadata"),
       inputSchema: {
         type: "object",
         properties: {