brightspace-mcp-server 4.0.0 → 4.0.2

package/build/tools/get-my-groups.js

@@ -27,7 +27,7 @@ export function registerGetMyGroups(server, apiClient) {
         try {
             log("DEBUG", "get_my_groups tool called", { args });
             const { courseId } = GetMyGroupsSchema.parse(args);
-            const { matches, categoriesUnavailable } = await fetchMyGroupMemberships(apiClient, courseId);
+            const { matches, categoriesUnavailable, unreadCategories } = await fetchMyGroupMemberships(apiClient, courseId);
             if (categoriesUnavailable) {
                 return toolResponse({
                     courseId,
@@ -35,6 +35,18 @@ export function registerGetMyGroups(server, apiClient) {
                     note: "No groups are visible for this course (it may not use groups, or group info isn't accessible).",
                 });
             }
+            const unreadNote = unreadCategories.length === 0 ? undefined
+                : `Couldn't read the groups in ${unreadCategories.map((c) => `"${c.Name || c.GroupCategoryId}"`).join(", ")}, ` +
+                    "so any group the current user has there is not listed.";
+            if (unreadNote) {
+                log("INFO", "get_my_groups: Some group categories could not be read", {
+                    courseId,
+                    categoryIds: unreadCategories.map((c) => c.GroupCategoryId),
+                });
+            }
+            if (matches.length === 0 && unreadNote) {
+                return toolResponse({ courseId, groups: [], note: unreadNote });
+            }
             if (matches.length === 0) {
                 log("INFO", `get_my_groups: User is not a member of any group in course ${courseId}`);
                 return toolResponse({
@@ -78,7 +90,7 @@ export function registerGetMyGroups(server, apiClient) {
                 };
             });
             log("INFO", `get_my_groups: Found ${groups.length} groups for course ${courseId}`);
-            return toolResponse({ courseId, groups });
+            return toolResponse({ courseId, groups, ...(unreadNote ? { note: unreadNote } : {}) });
         }
         catch (error) {
             return sanitizeError(error);

package/build/tools/group-membership.js

@@ -20,19 +20,24 @@ export async function fetchMyGroupMemberships(apiClient, courseId, categoryId) {
             : [{ GroupCategoryId: categoryId, Name: "" }];
     }
     catch (error) {
-        if (inaccessible(error))
-            return { matches: [], categoriesUnavailable: true };
+        if (inaccessible(error)) {
+            return { matches: [], categoriesUnavailable: true, unreadCategories: [] };
+        }
         throw error;
     }
     const matches = [];
+    // Categories whose groups answered 403/404: membership there is unknown, not "none".
+    const unreadCategories = [];
     for (const category of categories) {
         let groups;
         try {
             groups = await apiClient.get(apiClient.lp(`/${courseId}/groupcategories/${category.GroupCategoryId}/groups/`), { ttl: DEFAULT_CACHE_TTLS.roster });
         }
         catch (error) {
-            if (inaccessible(error))
+            if (inaccessible(error)) {
+                unreadCategories.push(category);
                 continue;
+            }
             throw error;
         }
         for (const group of groups) {
@@ -40,5 +45,5 @@ export async function fetchMyGroupMemberships(apiClient, courseId, categoryId) {
                 matches.push({ category, group });
         }
     }
-    return { matches, categoriesUnavailable: false };
+    return { matches, categoriesUnavailable: false, unreadCategories };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brightspace-mcp-server",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "mcpName": "io.github.RohanMuppa/brightspace",
   "description": "MCP server for Brightspace (D2L). Check grades, due dates, assignments, announcements, syllabus, rosters and more via Claude, ChatGPT, Cursor, Windsurf, or any MCP client.",
   "type": "module",