brightspace-mcp-server 3.3.0 → 3.4.0

package/README.md

@@ -117,6 +117,7 @@ npx -y brightspace-mcp-server@latest auth
 | Roster | "Who are the TAs for ECE 264?" · "Get me my instructor's email" |
 | Discussions | "What are people saying in the final project thread?" · "Summarize the latest discussion posts" |
 | Video transcripts | "What did the professor say about pinch-off in Tuesday's lecture recording?" · "Summarize last week's BoilerCast video" — works for Kaltura and YouTube embeds; other platforms report that they aren't supported yet |
+| Troubleshooting | "Which version of the Brightspace server am I running?" · "Where is my Brightspace config file?" — `get_server_info` reports the version, Node runtime, platform, config and session paths, school URL, and whether a credential is stored, without contacting Brightspace or revealing secrets |
 | Planning | "Build me a study schedule based on my upcoming due dates" · "Which class needs the most attention right now?" — pulls from assignments, quizzes, and graded discussion topics (any topic with a due date) |
 
 

package/build/index.js

@@ -16,7 +16,7 @@ import { startUpdateChecks } from "./utils/update-checker.js";
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, resolve } from "node:path";
-import { registerGetMyCourses, registerGetUpcomingDueDates, registerGetMyGrades, registerGetAnnouncements, registerGetAssignments, registerGetAssignmentFiles, registerGetCourseContent, registerDownloadFile, registerGetClasslistEmails, registerGetRoster, registerGetSyllabus, registerGetDiscussions, registerGetVideoTranscript, } from "./tools/index.js";
+import { registerGetMyCourses, registerGetUpcomingDueDates, registerGetMyGrades, registerGetAnnouncements, registerGetAssignments, registerGetAssignmentFiles, registerGetCourseContent, registerDownloadFile, registerGetClasslistEmails, registerGetRoster, registerGetSyllabus, registerGetDiscussions, registerGetVideoTranscript, registerGetServerInfo, } from "./tools/index.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const PKG_VERSION = (() => {
@@ -113,11 +113,12 @@ else {
             registerGetSyllabus(server, apiClient);
             registerGetDiscussions(server, apiClient);
             registerGetVideoTranscript(server, apiClient);
-            log("DEBUG", "MCP tools registered (13 tools)");
+            registerGetServerInfo(server, config, PKG_VERSION);
+            log("DEBUG", "MCP tools registered (14 tools)");
             // Connect stdio transport
             const transport = new StdioServerTransport();
             await server.connect(transport);
-            log("INFO", "Brightspace MCP Server by Rohan Muppa — running on stdio (13 tools registered)");
+            log("INFO", "Brightspace MCP Server by Rohan Muppa — running on stdio (14 tools registered)");
             log("INFO", "Setup: see README.md for MCP client configuration (Claude Desktop, ChatGPT Desktop, Cursor, etc.)");
         }
         catch (error) {

package/build/tools/get-server-info.js

@@ -0,0 +1,32 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2026 Rohan Muppa. All rights reserved.
+ * Licensed under MIT — see LICENSE file for details.
+ */
+import { getConfigStorePath } from "../utils/config-store.js";
+import { GetServerInfoSchema } from "./schemas.js";
+import { toolResponse } from "./tool-helpers.js";
+/**
+ * Register get_server_info tool.
+ *
+ * Answers from the startup config alone: no network call, so it can never
+ * trigger a sign-in. hasStoredCredential reflects the keychain lookup made at
+ * startup, which is the credential this process actually holds. Nothing
+ * secret — password, username, token, cookie — is ever included.
+ */
+export function registerGetServerInfo(server, config, version) {
+    server.registerTool("get_server_info", {
+        title: "Get Server Info",
+        description: "Report which version of the Brightspace MCP server is running, the Node.js runtime, platform, config file path, session state directory, configured school URL, and whether a credential is stored. Use this for troubleshooting or when the user asks which version they have. Never contacts Brightspace and never returns secrets.",
+        inputSchema: GetServerInfoSchema,
+    }, async () => toolResponse({
+        version,
+        node: process.version,
+        platform: process.platform,
+        arch: process.arch,
+        configPath: getConfigStorePath(),
+        sessionStatePath: config.sessionDir,
+        schoolUrl: config.baseUrl,
+        hasStoredCredential: config.password !== undefined,
+    }));
+}

package/build/tools/index.js

@@ -17,6 +17,7 @@ export { registerGetRoster } from "./get-roster.js";
 export { registerGetSyllabus } from "./get-syllabus.js";
 export { registerGetDiscussions } from "./get-discussions.js";
 export { registerGetVideoTranscript } from "./get-video-transcript.js";
+export { registerGetServerInfo } from "./get-server-info.js";
 // Re-export shared helpers and schemas for convenience
 export { toolResponse, errorResponse, sanitizeError } from "./tool-helpers.js";
 export * from "./schemas.js";

package/build/tools/schemas.js

@@ -113,3 +113,4 @@ export const GetRosterSchema = z.object({
     limit: z.coerce.number().int().positive().max(1000).default(100)
         .describe("Maximum users to return. Default 100. The response reports the true total and whether it was truncated."),
 });
+export const GetServerInfoSchema = z.object({});

package/package.json

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