brightspace-mcp-server 5.2.2 → 5.2.4

package/build/tools/get-dropbox-folders.js

@@ -44,8 +44,10 @@ export function registerGetDropboxFolders(server, apiClient) {
             }
             catch (error) {
                 if (error instanceof ApiError && error.status === 403) {
-                    return errorResponse("Instructor or TA access required for this course. This tool reads every student's " +
-                        "dropbox folder metadata, which Brightspace only grants to course staff.", "permission");
+                    return errorResponse("Brightspace refused to list this course's assignment folders (403). Students can " +
+                        "normally read this list, so the likely causes are that you are not enrolled in this " +
+                        "course (check the courseId with get_my_courses) or that the course hides its " +
+                        "Assignments tool from your role. Check the course in Brightspace.", "permission");
                 }
                 if (error instanceof ApiError && error.status === 404) {
                     return toolResponse({

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

@@ -45,14 +45,23 @@ export function registerGetMyGroups(server, apiClient) {
         try {
             log("DEBUG", "get_my_groups tool called", { args });
             const { courseId } = GetMyGroupsSchema.parse(args);
-            const { matches, categoriesUnavailable, unreadCategories } = await fetchMyGroupMemberships(apiClient, courseId);
+            const { matches, categoriesUnavailable, categoriesStatus, unreadCategories } = await fetchMyGroupMemberships(apiClient, courseId);
+            // An empty `groups` here means "not read", not "none": the field lets a
+            // caller tell the two apart without parsing the note (#442).
             if (categoriesUnavailable) {
                 return toolResponse({
                     courseId,
                     groups: [],
-                    note: "No groups are visible for this course (it may not use groups, or group info isn't accessible).",
+                    groupsUnavailable: { status: categoriesStatus ?? null },
+                    note: categoriesStatus === 403
+                        ? "Brightspace refused this course's group list (403), so whether the current user is in a group " +
+                            "is unknown. Don't tell them they have no group; they can check Groups in Brightspace."
+                        : "No groups are visible for this course (it may not use groups, or group info isn't accessible), " +
+                            "so whether the current user is in a group is unknown.",
                 });
             }
+            const unreadNames = unreadCategories.map((c) => c.Name || String(c.GroupCategoryId));
+            const unreadField = unreadNames.length > 0 ? { unreadCategories: unreadNames } : {};
             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.";
@@ -63,7 +72,7 @@ export function registerGetMyGroups(server, apiClient) {
                 });
             }
             if (matches.length === 0 && unreadNote) {
-                return toolResponse({ courseId, groups: [], note: unreadNote });
+                return toolResponse({ courseId, groups: [], ...unreadField, note: unreadNote });
             }
             if (matches.length === 0) {
                 log("INFO", `get_my_groups: User is not a member of any group in course ${courseId}`);
@@ -140,7 +149,7 @@ export function registerGetMyGroups(server, apiClient) {
                     : "Couldn't read this course's classlist, so member names are null; only user ids are listed" +
                         (pageNames.size > 0 ? ", except where memberNames lists a group's members from its member page." : ".");
             const note = [unreadNote, namesNote].filter(Boolean).join(" ") || undefined;
-            return toolResponse({ courseId, groups, ...(note ? { note } : {}) });
+            return toolResponse({ courseId, groups, ...unreadField, ...(note ? { note } : {}) });
         }
         catch (error) {
             return sanitizeError(error);

package/build/tools/get-rubrics-for-object.js

@@ -31,8 +31,10 @@ export function registerGetRubricsForObject(server, apiClient) {
             }
             catch (error) {
                 if (error instanceof ApiError && error.status === 403) {
-                    return errorResponse("Instructor or TA access required for this course. This tool reads dropbox rubric " +
-                        "metadata, which Brightspace only grants to course staff.", "permission");
+                    return errorResponse("Brightspace refused to list this course's assignment folders (403). Students can " +
+                        "normally read this list, so the likely causes are that you are not enrolled in this " +
+                        "course (check the courseId with get_my_courses) or that the course hides its " +
+                        "Assignments tool from your role. Check the course in Brightspace.", "permission");
                 }
                 if (error instanceof ApiError && error.status === 404) {
                     return toolResponse({

package/build/tools/group-membership.js

@@ -21,7 +21,12 @@ export async function fetchMyGroupMemberships(apiClient, courseId, categoryId) {
     }
     catch (error) {
         if (inaccessible(error)) {
-            return { matches: [], categoriesUnavailable: true, unreadCategories: [] };
+            return {
+                matches: [],
+                categoriesUnavailable: true,
+                categoriesStatus: error.status,
+                unreadCategories: [],
+            };
         }
         throw error;
     }
@@ -45,5 +50,5 @@ export async function fetchMyGroupMemberships(apiClient, courseId, categoryId) {
                 matches.push({ category, group });
         }
     }
-    return { matches, categoriesUnavailable: false, unreadCategories };
+    return { matches, categoriesUnavailable: false, categoriesStatus: undefined, unreadCategories };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brightspace-mcp-server",
-  "version": "5.2.2",
+  "version": "5.2.4",
   "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",