brightspace-mcp-server 3.9.10 → 3.9.12

package/README.md

@@ -6,8 +6,6 @@
 [![License: MIT](https://img.shields.io/github/license/RohanMuppa/brightspace-mcp-server.svg)](LICENSE)
 [![Node >= 20](https://img.shields.io/node/v/brightspace-mcp-server.svg)](package.json)
 
-**Official repo:** github.com/RohanMuppa/brightspace-mcp-server · [npm](https://www.npmjs.com/package/brightspace-mcp-server) — forks of this README are not maintained.
-
 > **By [Rohan Muppa](https://github.com/rohanmuppa), ECE @ Purdue**
 
 Lets your AI see your Brightspace classes, so you can just ask:
@@ -73,25 +71,16 @@ School-specific quirks: [docs/sign-in.md](docs/sign-in.md#per-school-notes).
 | Lecture videos | "What did the professor say about pinch-off in Tuesday's recording?" (Kaltura and YouTube) |
 | Calendar | "When is my midterm?" · "Is lab cancelled on Thursday?" |
 
-Apps with a prompt picker (like Claude Desktop) also offer four ready-made prompts: `weekly_briefing`, `grade_audit`, `study_planner`, and `course_summary`.
-
-## What it can do
-
-Nineteen read-only tools behind those questions. The ones worth knowing about:
+## Prompts
 
-- **Grades** — every course's gradebook with instructor comments, and the hidden "exam" items that only appear in the gradebook.
-- **Assignments** — due dates with a plain-words `dueIn` ("in 3 days"), your submissions and the feedback on them, rubric names, and quizzes with attempt counts. While sign-in is still pending it says so instead of returning an empty list.
-- **Rubrics** — the full criteria, levels, and points for an assignment, plus your own graded outcome per criterion when your school exposes it.
-- **Due dates and calendar** — upcoming deadlines from assignments, quizzes, graded discussions, and the course calendar (exams, labs, review sessions).
-- **Announcements** — with attachments you can read or save.
-- **Course content** — modules and topics as markdown, file download (PDF, Office, and more), and release windows: it tells you when something opens, has ended, or is hidden instead of a bare error.
-- **Search** — content, announcements, and discussions by keyword in one call.
-- **Lecture videos** — transcripts for Kaltura and YouTube embeds.
-- **People** — roster, instructor and TA emails, and your project or lab groups.
-- **Discussions** — forums and topics.
-- **Diagnostics** — `get_server_info`: version, timezone, who you're signed in as, whether Microsoft remembered your device, and request counters, all without touching Brightspace.
+Apps with a prompt picker (like Claude Desktop) also offer four ready-made prompts, so you can start from one click instead of typing a question:
 
-Sign-in is automatic: silent renewal most days, the MFA number shown in-chat when needed, Duo and authenticator-code support, a visible-browser mode for anything else, an opt-in "remember this device" for Microsoft, and a browser-free mode (paste a session cookie or token) for Docker, WSL, and hardware-key accounts. Links in course content have D2L's session tokens stripped before they reach the AI.
+| Prompt | Arguments | What it asks for |
+|--------|-----------|------------------|
+| `weekly_briefing` | — | A 7-day rollup of what's due, what's new, and what changed in your grades, across every course |
+| `grade_audit` | `courseId` (optional) | Analyzes grades for one course, or all of them, and flags missing or low-scoring items |
+| `study_planner` | `daysAhead` (optional, default 7) | Plans study time from upcoming due dates and calendar events |
+| `course_summary` | `courseId` (required) | Syllabus, content outline, assignments, and grades for one course |
 
 ## Settings you might want
 
@@ -123,10 +112,6 @@ How often you're asked is up to your school, not this tool. Everything else abou
 - **Which version do I have?** Ask your AI "which version of the Brightspace server am I running?"
 - **Still stuck?** [Open an issue](https://github.com/RohanMuppa/brightspace-mcp-server/issues) and paste what the terminal printed.
 
-## Is it safe?
-
-Your password is kept in your operating system's password store, never in a plain file. Saved sign-in state is encrypted. Your second factor (the phone tap or code) stays on your phone — this tool never sees or stores it. And it can only read your courses, never change them.
-
 ## For developers
 
 Tool reference, response fields, and environment variables: [LLMs.md](LLMs.md). What's safe to build against: [STABILITY.md](STABILITY.md). Licensed under the MIT License.

package/build/tools/get-roster.js

@@ -13,6 +13,14 @@ import { log } from "../utils/logger.js";
 // Discover by fetching classlist for a known course and inspecting RoleId values.
 const INSTRUCTOR_ROLE_ID = 109;
 const TA_ROLE_ID = 135;
+// When the role-ID fast path above returns nothing — a non-Purdue tenant
+// where those IDs belong to different roles or none at all — staff are found
+// instead by matching the role name the tenant itself reports. Role-name
+// fallback adapted from matthewliu10/brightspace-mcp-server (MIT).
+const TEACHING_ROLE_NAME = /\b(instructor|professor|lecturer|teaching assistant|coordinator|grader|ta)\b/i;
+function isTeachingRoleByName(user) {
+    return TEACHING_ROLE_NAME.test(user.ClasslistRoleDisplayName ?? "");
+}
 /**
  * Fetch every classlist user matching the optional filters, across all pages.
  *
@@ -48,6 +56,7 @@ export function registerGetRoster(server, apiClient) {
             // Parse and validate input
             const { courseId, includeStudents, searchTerm, limit } = GetRosterSchema.parse(args);
             const allUsers = [];
+            let roleFallbackUsed = false;
             if (!includeStudents) {
                 // Fetch instructors and TAs in parallel
                 const [instructorResult, taResult] = await Promise.allSettled([
@@ -77,6 +86,20 @@ export function registerGetRoster(server, apiClient) {
                         error: taResult.reason,
                     });
                 }
+                // Purdue's role IDs found nobody — on a non-Purdue tenant they
+                // likely mean a different role, or none. Fall back to one
+                // unfiltered classlist fetch and match on the role display name
+                // the tenant itself reports instead of an institution-specific ID.
+                // A genuine failure of this fetch is intentionally not caught
+                // here: it should surface as a tool error rather than silently
+                // producing an empty staff list.
+                if (allUsers.length === 0) {
+                    const everyone = await fetchClasslistUsers(apiClient, courseId, {
+                        searchTerm,
+                    });
+                    allUsers.push(...everyone.filter(isTeachingRoleByName));
+                    roleFallbackUsed = true;
+                }
             }
             else {
                 // Fetch all users
@@ -110,6 +133,11 @@ export function registerGetRoster(server, apiClient) {
                 ...(truncated
                     ? { note: `Showing ${users.length} of ${total}. Raise the limit argument to see more.` }
                     : {}),
+                ...(roleFallbackUsed
+                    ? {
+                        roleFilter: "No users matched the default instructor/TA role IDs, so staff were found by matching role display names (instructor, professor, lecturer, teaching assistant, coordinator, grader, TA) instead.",
+                    }
+                    : {}),
                 users,
             });
         }

package/package.json

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