brightspace-d2l-mcp 1.4.1 → 1.4.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.4.3
+
+- Add README section on switching from brightspace-mcp-server
+
+## 1.4.2
+
+- Bump dependencies and assert version sync in release tests
+
 ## 1.4.1
 
 - Make expired-session errors actionable in src/api/errors.ts

package/README.md

@@ -64,6 +64,52 @@ People usually weigh a few Brightspace MCP servers before picking one. Here are
 
 "No target-grade tool in its published list" means we could not find one in each project's public README and tool list as of October 2026, not that it can never be added. Spot a mistake in the table? Open an issue and it will be fixed.
 
+## Switching from brightspace-mcp-server
+
+If you are running [brightspace-mcp-server](https://www.npmjs.com/package/brightspace-mcp-server) by RohanMuppa and want to try this one, you only change the package name. Everything else stays where it is.
+
+In your MCP config, find the `brightspace` entry inside `mcpServers` and swap the command:
+
+```json
+{
+  "mcpServers": {
+    "brightspace": {
+      "command": "npx",
+      "args": ["-y", "brightspace-d2l-mcp@latest"]
+    }
+  }
+}
+```
+
+On Windows, wrap the launch in `cmd /c` the same way you do now:
+
+```json
+{
+  "mcpServers": {
+    "brightspace": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "brightspace-d2l-mcp@latest"]
+    }
+  }
+}
+```
+
+Then restart the app. If you would rather not edit files, run `npx brightspace-d2l-mcp setup`: it asks for your school, opens a browser window so you sign in, and writes this entry for you. You can also print the exact JSON for any app with `npx brightspace-d2l-mcp config`.
+
+### What carries over and what doesn't
+
+| | Status |
+|---|---|
+| The `brightspace` server name in `mcpServers` | Same here, so a config entry and any saved prompt that points at the `brightspace` server still lines up |
+| Tool names | They differ. See which tools this one has in the [Tools](#tools) table above and ask your AI for those names instead |
+| Your Brightspace account and courses | Nothing to move. This server signs in as you and sees the courses you are enrolled in, same as before |
+| A `D2L_INCLUDE_COURSES` or `D2L_EXCLUDE_COURSES` setting | Both names are read here too, so a course filter in your env block keeps working. `D2L_ACTIVE_ONLY` behaves the same way and is read here as well |
+| Whatever the first server saved on your computer | It is left alone. This server stores its own settings and session in `~/.brightspace-d2l-mcp/`, so nothing there changes unless you remove it yourself |
+
+Want to go back? Put the old command back in the same spot. Both servers can even be configured side by side under two different server names, but one AI app talking to two Brightspace servers at once tends to be more confusing than it is worth.
+
+A few things the first server does are not done here: it can sign you in without a browser window by saving your password in your computer's credential store, and it ships presets for several named schools. This server always opens a normal browser window where you sign in yourself, which is what makes any single sign-on work, and all it keeps afterward is your browser session.
+
 ## What you can ask
 
 | | Try asking |
@@ -284,6 +330,12 @@ Yes. Local agents and SDKs launch it with `npx -y brightspace-d2l-mcp@latest`, a
 No. Brightspace API keys normally require an administrator. This uses your own student sign-in instead, so it sees exactly what you see in Brightspace, and nobody at your school has to set anything up.
 </details>
 
+<details>
+<summary><b>How do I switch from brightspace-mcp-server to this one?</b></summary>
+
+Change the package name in your MCP config: replace `brightspace-mcp-server` with `brightspace-d2l-mcp` in the same `brightspace` entry, then restart the app. Or run `npx brightspace-d2l-mcp setup` and let it write the entry for you. [Switching from brightspace-mcp-server](#switching-from-brightspace-mcp-server) covers what carries over and what does not.
+</details>
+
 <details>
 <summary><b>Does it work with Duo, Microsoft Authenticator or text-message codes?</b></summary>
 

package/llms.txt

@@ -1,6 +1,6 @@
 # Brightspace D2L MCP Server
 
-> MCP server that gives AI assistants and agents read access to D2L Brightspace. It returns due dates with real submission status, grades, assignments, rubrics, course content, announcements, discussions and class lists. It works at any school that uses D2L Brightspace, including schools with Microsoft, Duo, Okta or Shibboleth sign-in. It is read only and never stores a password. Current version: 1.4.1.
+> MCP server that gives AI assistants and agents read access to D2L Brightspace. It returns due dates with real submission status, grades, assignments, rubrics, course content, announcements, discussions and class lists. It works at any school that uses D2L Brightspace, including schools with Microsoft, Duo, Okta or Shibboleth sign-in. It is read only and never stores a password. Current version: 1.4.3.
 
 ## Install
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brightspace-d2l-mcp",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "mcpName": "io.github.AnonymousOnyx22/brightspace-d2l-mcp",
   "description": "Brightspace MCP server for D2L: connect Brightspace to Claude, ChatGPT, Cursor, Copilot and any AI agent. One-command setup at any school with normal browser sign-in (SSO, Duo, MFA). Due dates with real submission status, exam and calendar events, what's new catch-up, grades and target-grade calculator, calendar export, assignments, content, announcements.",
   "type": "module",