brightspace-mcp-server 3.9.9 → 3.9.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +67 -216
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,40 +6,31 @@
|
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
[](package.json)
|
|
8
8
|
|
|
9
|
-
**Official repo:** github.com/RohanMuppa/brightspace-mcp-server · [npm](https://www.npmjs.com/package/brightspace-mcp-server) — forks of this README are not maintained.
|
|
10
|
-
|
|
11
|
-
**Contents:** [Try It](#try-it) · [Install](#install) · [Supported schools](#supported-schools) ·
|
|
12
|
-
[Session Expired?](#session-expired) · [No browser?](#no-browser-paste-a-session-cookie-or-token) ·
|
|
13
|
-
[Troubleshooting](#troubleshooting) ·
|
|
14
|
-
[Does it work with ChatGPT, Cursor, Windsurf or Claude Code?](#does-it-work-with-chatgpt-cursor-windsurf-or-claude-code) ·
|
|
15
|
-
[Is my password safe?](#is-my-password-safe) · [Does my school work?](#does-my-school-work) ·
|
|
16
|
-
[Why do I have to approve MFA sometimes?](#why-do-i-have-to-approve-mfa-sometimes) ·
|
|
17
|
-
[What You Can Ask About](#what-you-can-ask-about)
|
|
18
|
-
|
|
19
9
|
> **By [Rohan Muppa](https://github.com/rohanmuppa), ECE @ Purdue**
|
|
20
10
|
|
|
21
|
-
|
|
11
|
+
Lets your AI see your Brightspace classes, so you can just ask:
|
|
22
12
|
|
|
23
|
-
|
|
13
|
+
> "What's due this week?" · "Am I passing all my classes?" · "Summarize today's announcements" · "Turn my lecture slides into flashcards"
|
|
24
14
|
|
|
25
|
-
|
|
15
|
+
Works with Claude Desktop, Claude Code, Cursor, ChatGPT Desktop, Windsurf, and any other app that supports [MCP](https://modelcontextprotocol.io) (the standard way to plug tools into an AI). It only **reads** your courses — it never submits, edits, or deletes anything.
|
|
26
16
|
|
|
27
17
|
<p align="center">
|
|
28
18
|
<img src="https://raw.githubusercontent.com/RohanMuppa/brightspace-mcp-server/main/docs/how-it-works.svg" alt="Architecture diagram" width="100%">
|
|
29
19
|
</p>
|
|
30
20
|
|
|
31
|
-
##
|
|
32
|
-
|
|
33
|
-
> "Download my lecture slides and turn them into interactive flashcards"
|
|
34
|
-
> "Grab every assignment rubric and build me a visual dashboard of what I need to hit for an A"
|
|
21
|
+
## Get started in 3 steps
|
|
35
22
|
|
|
36
|
-
|
|
23
|
+
1. **Install [Node.js](https://nodejs.org/)** (version 20 or newer) if you don't have it. Download, run the installer, done.
|
|
24
|
+
2. **Open a terminal and run the setup:**
|
|
25
|
+
```bash
|
|
26
|
+
npx -y brightspace-mcp-server@latest setup
|
|
27
|
+
```
|
|
28
|
+
It asks for your school's Brightspace address, your username and password, and how you normally do two-factor sign-in (phone approval, authenticator code, or a browser window). Your password goes into your computer's own password store (Keychain on Mac, Credential Manager on Windows), never into a file. At the end it connects itself to Claude Desktop, Cursor, Codex, or Claude Code if you have them.
|
|
29
|
+
3. **Restart your AI app and ask it something** — the first question signs you in. If your phone asks you to approve a sign-in, approve it and ask again.
|
|
37
30
|
|
|
38
|
-
|
|
31
|
+
At one of these schools, add the flag and skip typing the address: `--purdue`, `--suny`, `--western`, `--tudelft`, `--cuny`, `--leiden`.
|
|
39
32
|
|
|
40
|
-
**
|
|
41
|
-
|
|
42
|
-
Paste this into Claude Code, Cursor, Windsurf, Copilot, Codex, or any AI coding assistant:
|
|
33
|
+
**Rather have the AI install it for you?** Paste this into Claude Code, Cursor, Windsurf, Copilot, or Codex:
|
|
43
34
|
|
|
44
35
|
```
|
|
45
36
|
Install brightspace-mcp-server for me by following
|
|
@@ -47,220 +38,80 @@ https://github.com/RohanMuppa/brightspace-mcp-server/blob/main/LLMs.md
|
|
|
47
38
|
(use --purdue at Purdue, --suny at SUNY, --tudelft at TU Delft, --cuny at CUNY, or --leiden at Leiden).
|
|
48
39
|
```
|
|
49
40
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
```bash
|
|
53
|
-
npx -y brightspace-mcp-server@latest setup
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
Purdue students can add `--purdue` to skip entering the school URL:
|
|
57
|
-
|
|
58
|
-
```bash
|
|
59
|
-
npx -y brightspace-mcp-server@latest setup --purdue
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
SUNY campuses share one Brightspace site, so `--suny` also asks which campus
|
|
63
|
-
you're at and skips SUNY's campus picker when you sign in:
|
|
64
|
-
|
|
65
|
-
```bash
|
|
66
|
-
npx -y brightspace-mcp-server@latest setup --suny
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
TU Delft students can use `--tudelft` to select the Brightspace URL and NetID login:
|
|
70
|
-
|
|
71
|
-
```bash
|
|
72
|
-
npx -y brightspace-mcp-server@latest setup --tudelft
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
Use your NetID rather than your student email address. The TU Delft flow is headless NetID username and password sign-in only, including automatic re-authentication when the saved session expires; it does not support MFA or any other interactive step. If your account requires one, [open an issue](https://github.com/RohanMuppa/brightspace-mcp-server/issues) — that tenant isn't supported yet.
|
|
76
|
-
|
|
77
|
-
CUNY students can add `--cuny`. Sign in with your full CUNY Login address
|
|
78
|
-
(`firstname.lastname01@login.cuny.edu`); authentication asks in the terminal
|
|
79
|
-
for the 6-digit code from your authenticator app. CUNY asks for that code on
|
|
80
|
-
every full sign-in, so when your Brightspace session ends, run
|
|
81
|
-
`npx -y brightspace-mcp-server@latest auth` in a terminal again:
|
|
82
|
-
|
|
83
|
-
```bash
|
|
84
|
-
npx -y brightspace-mcp-server@latest setup --cuny
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
Leiden University students can use `--leiden`:
|
|
88
|
-
|
|
89
|
-
```bash
|
|
90
|
-
npx -y brightspace-mcp-server@latest setup --leiden
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
Sign in with your full Microsoft address (for example `s1234567@vuw.leidenuniv.nl`). The flow picks Leiden University (Entra) on SURFconext's account page, then uses the same Microsoft sign-in as Purdue. Leiden normally asks for a code from your authenticator app, which `auth` prompts for in the terminal.
|
|
94
|
-
|
|
95
|
-
The wizard saves your password in the native credential store and asks how you'll complete MFA: wait for approval or number matching, enter a terminal code from Google Authenticator or another app, or use a visible browser for other interactive methods. It can also configure Claude Desktop, Cursor, Codex Desktop and CLI, and Claude Code when installed — restart your AI client when it finishes.
|
|
96
|
-
|
|
97
|
-
Any other D2L school: run `setup` without a flag and paste your Brightspace URL (for example `https://yourschool.brightspace.com`).
|
|
98
|
-
|
|
99
|
-
<details>
|
|
100
|
-
<summary>Using a different client? Configure it manually.</summary>
|
|
101
|
-
|
|
102
|
-
Search your client's docs for how to add an MCP server. The server command to register is:
|
|
103
|
-
|
|
104
|
-
```
|
|
105
|
-
npx -y brightspace-mcp-server@latest
|
|
106
|
-
```
|
|
107
|
-
|
|
108
|
-
On **Windows**, npx must be wrapped: `cmd /c npx -y brightspace-mcp-server@latest`
|
|
109
|
-
|
|
110
|
-
You still need to run `npx -y brightspace-mcp-server@latest setup` first to save your credentials.
|
|
111
|
-
|
|
112
|
-
For Codex Desktop and Codex CLI, run:
|
|
41
|
+
Using a different AI app? Add the command `npx -y brightspace-mcp-server@latest` to its MCP settings (on Windows: `cmd /c npx -y brightspace-mcp-server@latest`). Exact steps for each app: [docs/troubleshooting.md](docs/troubleshooting.md).
|
|
113
42
|
|
|
114
|
-
|
|
115
|
-
codex mcp add brightspace -- npx -y brightspace-mcp-server@latest
|
|
116
|
-
```
|
|
117
|
-
|
|
118
|
-
Codex Desktop and CLI use the same user configuration on a computer. Restart the desktop app or start a new CLI session after registration.
|
|
43
|
+
## Does my school work?
|
|
119
44
|
|
|
120
|
-
|
|
45
|
+
If your school uses D2L Brightspace, yes. These have automatic sign-in built in:
|
|
121
46
|
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
47
|
+
| School | Sign-in | Flag |
|
|
48
|
+
|--------|---------|------|
|
|
49
|
+
| Purdue | Microsoft (phone approval, authenticator code, or browser) | `--purdue` |
|
|
50
|
+
| SUNY | Shared site with a campus picker | `--suny` |
|
|
51
|
+
| Western University | Microsoft | `--western` |
|
|
52
|
+
| TU Delft | NetID (no two-factor) | `--tudelft` |
|
|
53
|
+
| CUNY | CUNY Login, authenticator code each time | `--cuny` |
|
|
54
|
+
| Leiden University | SURFconext → Microsoft | `--leiden` |
|
|
55
|
+
| Any other D2L school | Paste your Brightspace address; if the login page isn't recognized, a browser window opens so you can sign in by hand | none |
|
|
125
56
|
|
|
126
|
-
|
|
57
|
+
School-specific quirks: [docs/sign-in.md](docs/sign-in.md#per-school-notes).
|
|
127
58
|
|
|
128
|
-
|
|
59
|
+
## Things to ask
|
|
129
60
|
|
|
130
|
-
|
|
61
|
+
| About | Try |
|
|
62
|
+
|-------|-----|
|
|
63
|
+
| Grades | "Am I passing all my classes?" · "Compare my grades across courses" |
|
|
64
|
+
| Due dates | "What's due in the next 48 hours?" · "Build me a study schedule for the week" |
|
|
65
|
+
| Assignments and rubrics | "What does the lab 4 spec actually ask for?" · "Why did I lose points on the analysis criterion?" |
|
|
66
|
+
| Quizzes and exams | "Which quizzes close this week?" · "Is there a midterm in the gradebook that isn't on my assignments list?" |
|
|
67
|
+
| Announcements | "Did any professor post something important today?" · "Read the file attached to today's announcement" |
|
|
68
|
+
| Course content | "Find the midterm review slides" · "Download every PDF from Module 5" · "Search this course for office hours" |
|
|
69
|
+
| People | "Who are the TAs for ECE 264?" · "Who is in my project group?" |
|
|
70
|
+
| Discussions | "Summarize the latest posts in the final project thread" |
|
|
71
|
+
| Lecture videos | "What did the professor say about pinch-off in Tuesday's recording?" (Kaltura and YouTube) |
|
|
72
|
+
| Calendar | "When is my midterm?" · "Is lab cancelled on Thursday?" |
|
|
131
73
|
|
|
132
|
-
|
|
74
|
+
## Prompts
|
|
133
75
|
|
|
134
|
-
|
|
76
|
+
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:
|
|
135
77
|
|
|
136
|
-
|
|
|
137
|
-
|
|
138
|
-
|
|
|
139
|
-
|
|
|
140
|
-
|
|
|
141
|
-
|
|
|
142
|
-
| CUNY | CUNY Login, with an authenticator code on every full sign-in | `--cuny` |
|
|
143
|
-
| Leiden University | SURFconext → Microsoft Entra | `--leiden` |
|
|
144
|
-
| Any other D2L school | Paste your Brightspace URL; unsupported login pages fall back to the visible browser | run `setup` with no flag |
|
|
78
|
+
| Prompt | Arguments | What it asks for |
|
|
79
|
+
|--------|-----------|------------------|
|
|
80
|
+
| `weekly_briefing` | — | A 7-day rollup of what's due, what's new, and what changed in your grades, across every course |
|
|
81
|
+
| `grade_audit` | `courseId` (optional) | Analyzes grades for one course, or all of them, and flags missing or low-scoring items |
|
|
82
|
+
| `study_planner` | `daysAhead` (optional, default 7) | Plans study time from upcoming due dates and calendar events |
|
|
83
|
+
| `course_summary` | `courseId` (required) | Syllabus, content outline, assignments, and grades for one course |
|
|
145
84
|
|
|
146
|
-
##
|
|
85
|
+
## Settings you might want
|
|
147
86
|
|
|
148
|
-
|
|
87
|
+
All optional, set in your AI app's MCP `env` config or your shell. The full list is in [LLMs.md](LLMs.md).
|
|
149
88
|
|
|
150
|
-
|
|
89
|
+
| Setting | What it does |
|
|
90
|
+
|---------|--------------|
|
|
91
|
+
| `D2L_REMEMBER_MFA=true` | Tick Microsoft's "Don't ask again" box so later sign-ins skip the second factor (off by default; not for shared computers) |
|
|
92
|
+
| `D2L_HEADLESS=false` | Show the browser window during sign-in, for MFA methods that need a click |
|
|
93
|
+
| `D2L_DUO_PASSCODE=1` | On Duo, type a passcode instead of waiting for a push |
|
|
94
|
+
| `D2L_SESSION_COOKIE` / `D2L_ACCESS_TOKEN` | Skip the browser entirely with a pasted cookie or token ([how](docs/sign-in.md#no-browser-paste-a-session-cookie-or-token)) |
|
|
95
|
+
| `D2L_INCLUDE_COURSES` / `D2L_EXCLUDE_COURSES` | Limit which courses the AI sees, by course id |
|
|
96
|
+
| `D2L_ACTIVE_ONLY=false` | Include courses whose enrollment has ended |
|
|
97
|
+
| `D2L_NO_UPDATE_CHECK=1` | Turn off the new-version notice |
|
|
151
98
|
|
|
152
|
-
|
|
99
|
+
## When it asks you to sign in
|
|
153
100
|
|
|
154
|
-
|
|
101
|
+
There's no separate login — asking a question signs you in, and it stays signed in on its own most days. When your school wants two-factor again, the number to approve shows up right in the answer; approve it on your phone and ask again. If it ever gets stuck, run this in a terminal:
|
|
155
102
|
|
|
156
103
|
```bash
|
|
157
104
|
npx -y brightspace-mcp-server@latest auth
|
|
158
105
|
```
|
|
159
106
|
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
## No browser? Paste a session cookie or token
|
|
163
|
-
|
|
164
|
-
The normal setup drives a real (usually hidden) browser through sign-in, which doesn't work in Docker, headless Linux, WSL without a display, or on a tenant whose MFA requires a hardware security key. Two environment variables skip the browser entirely; set one and leave the normal setup untouched:
|
|
165
|
-
|
|
166
|
-
- **`D2L_SESSION_COOKIE`** — the `d2lSessionVal` and `d2lSecureSessionVal` cookies from a browser tab where you're already signed in to Brightspace. In Chrome DevTools: open your Brightspace site, **F12 → Application → Cookies**, find `d2lSessionVal` and `d2lSecureSessionVal`, and set the variable to either form:
|
|
167
|
-
```bash
|
|
168
|
-
export D2L_SESSION_COOKIE="d2lSessionVal=<value>; d2lSecureSessionVal=<value>"
|
|
169
|
-
# or just the two values, in that order:
|
|
170
|
-
export D2L_SESSION_COOKIE="<d2lSessionVal>;<d2lSecureSessionVal>"
|
|
171
|
-
```
|
|
172
|
-
- **`D2L_ACCESS_TOKEN`** — a pre-issued Bearer token (an admin-issued Valence token, or one minted by a TA script):
|
|
173
|
-
```bash
|
|
174
|
-
export D2L_ACCESS_TOKEN="<token>"
|
|
175
|
-
```
|
|
176
|
-
|
|
177
|
-
Set either in your MCP client's `env` config instead of a shell export if you're not running the server from a terminal. If both are set, `D2L_ACCESS_TOKEN` wins.
|
|
178
|
-
|
|
179
|
-
If this is a Docker or other headless setup with no `~/.brightspace-mcp/config.json` on disk, also set **`D2L_BASE_URL`** to your school's Brightspace URL — with no config file to read it from, the server otherwise defaults to Purdue's.
|
|
180
|
-
|
|
181
|
-
**The catch:** neither one renews itself. A pasted session cookie dies at D2L's own idle timeout (the same timeout that would eventually log you out in a browser), and a pre-issued token dies whenever it expires or is revoked. When that happens the server does **not** fall back to a browser login — it answers with an error telling you to paste a fresh value. There's no in-between: this is a deliberate escape hatch for environments that can't run a browser at all, not a way to skip typing your password once.
|
|
182
|
-
|
|
183
|
-
## Troubleshooting
|
|
184
|
-
|
|
185
|
-
**Where to find logs:** MCP clients log the server's stderr themselves. On **macOS**, Claude Desktop writes to `~/Library/Logs/Claude/mcp*.log` (one file per server, plus `mcp.log` for the client itself). On **Windows**, it's `%APPDATA%\Claude\logs`. Other clients vary — check their own logs or output panel for the `brightspace-mcp-server` process.
|
|
186
|
-
|
|
187
|
-
**Works in a terminal but not in the client:** the client launches the server as its own subprocess, which doesn't inherit your shell's environment. Common causes: the native credential store is locked (a GUI app started before you unlocked your keyring or logged into macOS won't get a Keychain prompt the way a terminal does), `HOME` or `PATH` differ for GUI-launched processes versus your shell, or `npx` resolves a different cached version than the one on your `PATH`. To check, run the exact registered command (`npx -y brightspace-mcp-server@latest`, or `cmd /c npx -y brightspace-mcp-server@latest` on Windows) from a fresh terminal with no extra environment set, and compare.
|
|
188
|
-
|
|
189
|
-
**Which version am I running:** ask the assistant anything that calls `get_server_info` — it reports the running version, Node runtime, and config/session paths with no network call. If you're on a source checkout instead of the published npm package, that version comes from the local `build/` output, so it only reflects your latest `npm run build`, not what's on npm.
|
|
190
|
-
|
|
191
|
-
## Does it work with ChatGPT, Cursor, Windsurf or Claude Code?
|
|
192
|
-
|
|
193
|
-
Yes — it's a standard MCP server, so it works with Claude Desktop, Claude Code, Cursor, ChatGPT Desktop,
|
|
194
|
-
Windsurf, Codex, and any other MCP client. The setup wizard auto-configures Claude Desktop, Cursor, and
|
|
195
|
-
Codex Desktop/CLI, and uses `claude mcp add` for Claude Code, when it detects them on your machine. Any
|
|
196
|
-
other client just needs the same `npx -y brightspace-mcp-server@latest` command added to its MCP config
|
|
197
|
-
(see "Using a different client?" above for exact steps).
|
|
198
|
-
|
|
199
|
-
## Is my password safe?
|
|
200
|
-
|
|
201
|
-
Your password is saved in your operating system's native credential store (macOS Keychain, Windows
|
|
202
|
-
Credential Manager, or Linux Secret Service) — never in a plaintext file. Session state on disk is
|
|
203
|
-
encrypted with AES-256-GCM. None of the server's tools submit, edit, or delete anything in your
|
|
204
|
-
courses; they only read grades, assignments, and course content. The second factor itself (an
|
|
205
|
-
approval tap, a number match, or a TOTP code) stays on your phone or authenticator app — the server
|
|
206
|
-
never sees or stores it.
|
|
207
|
-
|
|
208
|
-
## Does my school work?
|
|
209
|
-
|
|
210
|
-
If your school runs D2L Brightspace, yes. Purdue, SUNY, Western University, TU Delft, CUNY, and Leiden
|
|
211
|
-
have dedicated setup presets with automated sign-in; see [Supported schools](#supported-schools) above
|
|
212
|
-
for which flag to use. Any other Brightspace school works too — run `setup` without a flag and paste
|
|
213
|
-
your school's Brightspace URL, and an unsupported login page falls back to a visible browser window
|
|
214
|
-
you complete by hand.
|
|
215
|
-
|
|
216
|
-
## Why do I have to approve MFA sometimes?
|
|
217
|
-
|
|
218
|
-
How often you're asked is your school's sign-in frequency setting, not something this server controls —
|
|
219
|
-
the same approval you'd see signing in through a regular browser. Set `D2L_REMEMBER_MFA=true` to have
|
|
220
|
-
the server tick Microsoft's "Don't ask again" box during sign-in so later logins can skip the second
|
|
221
|
-
factor for as long as your school's tenant allows; it's opt-in and off by default, so leave it off on a
|
|
222
|
-
shared machine.
|
|
223
|
-
|
|
224
|
-
## What You Can Ask About
|
|
225
|
-
|
|
226
|
-
| Topic | Examples |
|
|
227
|
-
|-------|---------|
|
|
228
|
-
| Grades | "Am I passing all my classes?" · "Compare my grades across all courses" |
|
|
229
|
-
| Assignments | "What's due in the next 48 hours?" · "Summarize every assignment I haven't turned in yet" · "Give me the link to submit HW 4" |
|
|
230
|
-
| Quizzes | "Which quizzes close this week?" · "Is Quiz 3 timed, and does it have a grace period?" |
|
|
231
|
-
| Assignment files | "What does the lab 4 spec actually ask for?" · "Summarize the rubric attached to the project" |
|
|
232
|
-
| Rubrics | "What does the rubric for Lab 4 actually want?" · "Why did I lose points on the analysis criterion?" — `get_assignment_rubric` returns the full criteria groups, levels, and point values for a dropbox assignment, plus your own graded outcome per criterion when the tenant exposes it |
|
|
233
|
-
| Exams | "Is there a midterm in the gradebook that isn't on my assignments list?" |
|
|
234
|
-
| Announcements | "Did any professor post something important today?" · "What did my CS prof announce this week?" · "Any announcements since last Monday?" · "Read the file attached to today's announcement" · "Save the rubric my prof attached to that announcement" |
|
|
235
|
-
| Course content | "Find the midterm review slides" · "Download every PDF from Module 5" · "What's new in this course since I last checked?" |
|
|
236
|
-
| Roster | "Who are the TAs for ECE 264?" · "Get me my instructor's email" |
|
|
237
|
-
| Groups | "Who is in my project group?" · "List my lab group members for this course" |
|
|
238
|
-
| Discussions | "What are people saying in the final project thread?" · "Summarize the latest discussion posts" |
|
|
239
|
-
| Search | "Search this course for the midterm review slides" · "Has anyone posted about office hours?" — searches content, announcements, and discussions by keyword in one call instead of reading the whole content tree |
|
|
240
|
-
| 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 |
|
|
241
|
-
| Troubleshooting | "Which version of the Brightspace server am I running?" · "Where is my Brightspace config file?" · "What timezone are my due dates being computed in?" — `get_server_info` reports the version, Node runtime, platform, config and session paths, school URL, whether a credential is stored, the server's local timezone and UTC offset (`localTimezone`, `utcOffsetMinutes`), who the session is signed in as when known (`signedInAs: { uniqueName, displayName }`), what Microsoft remembered (`microsoftSession`: stay-signed-in and its expiry, plus whether "Don't ask again" was ticked, already on, not offered, or left off because `D2L_REMEMBER_MFA` isn't set), and `requests` (lightweight counters: responses by status class, network errors, cache hits/misses, coalesced in-flight joins, and token refreshes), without contacting Brightspace or revealing secrets |
|
|
242
|
-
| Calendar | "When is my midterm?" · "What's on my calendar this week?" · "Is lab cancelled on Thursday?" — reads exams, labs, review sessions, and deadlines instructors put only on the course calendar |
|
|
243
|
-
| Planning | "Build me a study schedule based on my upcoming due dates" · "Which class needs the most attention right now?" — pulls from assignments, quizzes, graded discussion topics (any topic with a due date), and course calendar events such as exams and labs |
|
|
244
|
-
|
|
245
|
-
### Prompts
|
|
246
|
-
|
|
247
|
-
Clients that show server-provided prompts (e.g. Claude Desktop's prompt picker) can also start from one of
|
|
248
|
-
four canned prompts instead of typing a question from scratch:
|
|
249
|
-
|
|
250
|
-
| Prompt | Arguments | What it asks for |
|
|
251
|
-
|--------|-----------|-------------------|
|
|
252
|
-
| `weekly_briefing` | — | A 7-day rollup of what's due, what's new, and what's changed in grades, across every course |
|
|
253
|
-
| `grade_audit` | `courseId` (optional) | Analyzes grades for one course, or all of them, and flags missing or low-scoring items |
|
|
254
|
-
| `study_planner` | `daysAhead` (optional, default 7) | Plans study time from upcoming due dates and calendar events |
|
|
255
|
-
| `course_summary` | `courseId` (required) | Syllabus, content outline, assignments, and grades for one course |
|
|
256
|
-
|
|
257
|
-
Each prompt is a single starter message built from the tools above — it doesn't add any new capability on
|
|
258
|
-
its own, just a one-click way to ask for a common combination of them.
|
|
107
|
+
How often you're asked is up to your school, not this tool. Everything else about sign-in — Duo, authenticator codes, visible-browser mode, and running without a browser at all (Docker, WSL, hardware keys) — is in [docs/sign-in.md](docs/sign-in.md).
|
|
259
108
|
|
|
260
|
-
|
|
109
|
+
## Something not working?
|
|
261
110
|
|
|
262
|
-
|
|
111
|
+
- **It works in the terminal but not in the app:** the app starts it separately and may not see your password store yet — see [docs/troubleshooting.md](docs/troubleshooting.md).
|
|
112
|
+
- **Which version do I have?** Ask your AI "which version of the Brightspace server am I running?"
|
|
113
|
+
- **Still stuck?** [Open an issue](https://github.com/RohanMuppa/brightspace-mcp-server/issues) and paste what the terminal printed.
|
|
263
114
|
|
|
264
|
-
|
|
115
|
+
## For developers
|
|
265
116
|
|
|
266
|
-
Licensed under the MIT License.
|
|
117
|
+
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/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "brightspace-mcp-server",
|
|
3
|
-
"version": "3.9.
|
|
3
|
+
"version": "3.9.11",
|
|
4
4
|
"mcpName": "io.github.rohanmuppa/brightspace",
|
|
5
5
|
"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.",
|
|
6
6
|
"type": "module",
|