brightspace-mcp-server 3.9.18 → 3.9.19

package/build/tools/get-announcements.js

@@ -130,6 +130,8 @@ export function registerGetAnnouncements(server, apiClient, config) {
                 code: item.OrgUnit.Code,
                 isActive: item.Access.IsActive,
                 canAccess: item.Access.CanAccess,
+                startDate: item.Access.StartDate,
+                endDate: item.Access.EndDate,
                 ...item,
             })), config.courseFilter);
             // Fetch announcements for each course (handle 403s gracefully)

package/build/tools/get-assignments.js

@@ -457,6 +457,8 @@ export function registerGetAssignments(server, apiClient, config) {
                 code: item.OrgUnit.Code,
                 isActive: item.Access.IsActive,
                 canAccess: item.Access.CanAccess,
+                startDate: item.Access.StartDate,
+                endDate: item.Access.EndDate,
                 ...item,
             })), config.courseFilter);
             // Fetch assignments for each course (handle 403s gracefully)

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

@@ -42,6 +42,8 @@ export function registerGetMyCourses(server, apiClient, config) {
                 role: item.Access.ClasslistRoleName,
                 isActive: item.Access.IsActive,
                 canAccess: item.Access.CanAccess,
+                startDate: item.Access.StartDate,
+                endDate: item.Access.EndDate,
                 lastAccessed: item.Access.LastAccessed,
             })), { ...config.courseFilter, activeOnly });
             log("INFO", `get_my_courses: Retrieved ${courses.length} courses`);

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

@@ -77,6 +77,8 @@ export function registerGetMyGrades(server, apiClient, config) {
                 code: item.OrgUnit.Code,
                 isActive: item.Access.IsActive,
                 canAccess: item.Access.CanAccess,
+                startDate: item.Access.StartDate,
+                endDate: item.Access.EndDate,
                 ...item,
             })), config.courseFilter);
             // Fetch grades for each course (handle 403s gracefully)

package/build/tools/resolve-courses.js

@@ -41,6 +41,8 @@ export async function resolveCourses(apiClient, config, courseId) {
         code: item.OrgUnit.Code,
         isActive: item.Access.IsActive,
         canAccess: item.Access.CanAccess,
+        startDate: item.Access.StartDate,
+        endDate: item.Access.EndDate,
     })), config.courseFilter);
     return filtered.map((course) => ({ id: course.id, name: course.name }));
 }

package/build/utils/config.js

@@ -67,6 +67,12 @@ export async function loadConfig() {
     const activeOnly = envBoolean(process.env.D2L_ACTIVE_ONLY, "D2L_ACTIVE_ONLY")
         ?? store?.activeOnly
         ?? true;
+    // Resolve currentOnly: env > store > default (false). When true, a course
+    // only passes the filter if Access.StartDate <= now <= Access.EndDate,
+    // matching Brightspace's "Current Courses" widget.
+    const currentOnly = envBoolean(process.env.D2L_CURRENT_ONLY, "D2L_CURRENT_ONLY")
+        ?? store?.currentOnly
+        ?? false;
     // D2L_ACCESS_TOKEN beats D2L_SESSION_COOKIE beats the normal stored-credential
     // browser flow; both are validated whenever present regardless of which one
     // wins, so a typo in the losing variable still fails loudly at startup.
@@ -100,6 +106,7 @@ export async function loadConfig() {
             includeCourseIds,
             excludeCourseIds,
             activeOnly,
+            currentOnly,
         },
     };
 }

package/build/utils/course-filter.js

@@ -4,18 +4,49 @@
  * Licensed under MIT — see LICENSE file for details.
  */
 import { log } from "./logger.js";
+/**
+ * True if `now` falls within [startDate, endDate].
+ *
+ * When both dates are null the course has no enrollment window at all — it's
+ * almost certainly an informational org unit (e.g. "Waterloo Campus",
+ * "Academic Integrity") rather than a term-bound course, so we return false.
+ * A single null side is treated as open-ended (start-only means "not yet
+ * ended", end-only means "already started"). A malformed date string is
+ * likewise treated as open-ended on that side rather than excluding the
+ * course outright.
+ *
+ * Adapted from LunaParker/brightspace-mcp-server (MIT), src/utils/course-filter.ts.
+ */
+function isCurrentlyInWindow(startDate, endDate, now) {
+    // Both null → undated org unit, not a current semester course.
+    if (!startDate && !endDate)
+        return false;
+    if (startDate) {
+        const start = Date.parse(startDate);
+        if (!Number.isNaN(start) && start > now)
+            return false;
+    }
+    if (endDate) {
+        const end = Date.parse(endDate);
+        if (!Number.isNaN(end) && end < now)
+            return false;
+    }
+    return true;
+}
 /**
  * Apply course filtering based on environment variable configuration.
  *
  * Filter priority:
  * 1. activeOnly — exclude inactive courses (default: true)
- * 2. includeCourseIds — whitelist (only these courses)
- * 3. excludeCourseIds — blacklist (remove these courses)
+ * 2. currentOnly — exclude courses outside their Access.StartDate/EndDate
+ *    window, matching Brightspace's "Current Courses" widget (default: false)
+ * 3. includeCourseIds — whitelist (only these courses)
+ * 4. excludeCourseIds — blacklist (remove these courses)
  *
  * Tool-level courseId params bypass this filter entirely —
  * if user explicitly requests courseId=X, honor it regardless of config.
  */
-export function applyCourseFilter(courses, config) {
+export function applyCourseFilter(courses, config, now = Date.now()) {
     let filtered = courses;
     const originalCount = courses.length;
     if (config.activeOnly) {
@@ -26,6 +57,9 @@ export function applyCourseFilter(courses, config) {
         // removes about 70 percent of the requests an all-courses call would make.
         filtered = filtered.filter(c => c.canAccess !== false);
     }
+    if (config.currentOnly) {
+        filtered = filtered.filter(c => isCurrentlyInWindow(c.startDate, c.endDate, now));
+    }
     if (config.includeCourseIds && config.includeCourseIds.length > 0) {
         filtered = filtered.filter(c => config.includeCourseIds.includes(c.id));
     }
@@ -35,6 +69,7 @@ export function applyCourseFilter(courses, config) {
     if (filtered.length !== originalCount) {
         log("DEBUG", `Course filter: ${originalCount} -> ${filtered.length} courses`, {
             activeOnly: config.activeOnly,
+            currentOnly: config.currentOnly,
             include: config.includeCourseIds,
             exclude: config.excludeCourseIds,
         });

package/package.json

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