brightspace-d2l-mcp 1.4.4 → 1.4.6

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.4.6
+
+- Add a Prompts and example questions section to the README, with an example question and the tools used for each of the 9 MCP prompts.
+- Add a Related queries section to llms.txt so searches in students' own words, such as what is due this week, point at the right tool.
+- `get_grade_outlook` now returns a clear error, pointing to `get_my_grades`, when a course has nothing graded yet. A course graded only in points still returns its current percent, as before.
+
+## 1.4.5
+
+- No change to the server itself. The tests now check that the README tools and prompts tables list exactly what the server offers, so the docs cannot drift from the code.
+
 ## 1.4.4
 
 - Make a stale course id actionable: the error now says to call `get_my_courses` to list valid course IDs, and a course tool that finds no enrollments at all points at running `npx brightspace-d2l-mcp setup` again

package/README.md

@@ -164,10 +164,21 @@ This one checks your actual submission for every assignment:
 | `get_calendar_events` | Exams, tests, labs, classes and other events from your course calendars |
 | `get_whats_new` | Catch-up across every course: new announcements, newly marked work, unread discussions and untried quizzes |
 
-### Built-in prompts
-
-Apps that support MCP prompts show these as one-click shortcuts or slash commands:
-`what_should_i_do_now` · `plan_my_week` · `weekly_digest` · `grade_target` · `exam_prep` · `summarize_assignment` · `put_deadlines_in_my_calendar` · `catch_me_up` · `when_are_my_exams`
+## Prompts and example questions
+
+Apps that support MCP prompts show these as one click shortcuts or slash commands. You do not have to remember the names: typing the example question in a normal chat works too, because each prompt simply tells the AI which tools to call.
+
+| Prompt | Example question | Tools it uses |
+|---|---|---|
+| `what_should_i_do_now` | "What should I work on right now?" | `get_todo` |
+| `plan_my_week` | "What should my week look like?" | `get_todo` |
+| `weekly_digest` | "Can you give me a weekly digest of deadlines, events and grades?" | `get_todo`, `get_calendar_events`, `get_whats_new`, `get_my_grades` |
+| `grade_target` | "What do I need on the final to get an 80?" | `get_my_courses`, `get_grade_outlook`, `get_syllabus` |
+| `exam_prep` | "Can you help me get ready for my networking exam next Friday?" | `get_my_courses`, `get_syllabus`, `get_course_content`, `get_announcements`, `get_todo` |
+| `summarize_assignment` | "Can you summarize the Lab 3 instructions and rubric?" | `get_assignments`, `get_assignment_files` |
+| `put_deadlines_in_my_calendar` | "Can you put my deadlines in my calendar?" | `export_due_dates_calendar` |
+| `catch_me_up` | "What's new, and did anything get graded?" | `get_whats_new`, `get_my_grades` |
+| `when_are_my_exams` | "When are my exams?" | `get_calendar_events`, `get_announcements`, `get_syllabus` |
 
 ## Works at any Brightspace school
 
@@ -401,6 +412,9 @@ All free, open source and read only where they touch your accounts. Browse the f
 | [Citations MCP](https://github.com/AnonymousOnyx22/student-citations-mcp) | APA, MLA and Chicago citations from a DOI, an ISBN or typed details. No account. |
 | [Study Planner MCP](https://github.com/AnonymousOnyx22/study-planner-mcp) | Exam study schedules, spaced repetition dates, pomodoro plans and assignment milestones. Works offline. |
 | [Paper Finder MCP](https://github.com/AnonymousOnyx22/paper-finder-student-mcp) | Search scholarly papers, find open access copies and related work through OpenAlex. No key needed. |
+| [BibTeX Reference Manager MCP](https://github.com/AnonymousOnyx22/bibtex-reference-manager-mcp) | BibTeX reference manager MCP server for AI apps. Ask your AI to parse, clean, convert, dedupe, lint and format BibTeX, RIS and CSL JSON reference lists, and to make consistent cite keys. Works offline with no account. |
+| [Open Textbook Finder MCP](https://github.com/AnonymousOnyx22/open-textbook-finder-mcp) | Open textbook finder MCP server for AI apps. Give it a textbook title, an ISBN or a course topic and it finds free legal copies on OpenStax, the Directory of Open Access Books and Open Library, looks up editions by ISBN and suggests cheaper older editions. No API key needed. |
+| [STEM Calculator MCP](https://github.com/AnonymousOnyx22/stem-calc-student-mcp) | Chemistry and physics homework math: molar mass, balancing equations, grams to moles, unit conversion and significant figures. Works offline. |
 
 ## License
 

package/build/tools/get-grade-outlook.js

@@ -1,6 +1,6 @@
 import { DEFAULT_CACHE_TTLS } from "../api/index.js";
 import { GetGradeOutlookSchema } from "./schemas.js";
-import { toolResponse, sanitizeError } from "./tool-helpers.js";
+import { toolResponse, errorResponse, sanitizeError } from "./tool-helpers.js";
 import { computeGradeOutlook } from "../utils/grade-math.js";
 export function registerGetGradeOutlook(server, apiClient) {
     server.registerTool("get_grade_outlook", {
@@ -25,6 +25,11 @@ export function registerGetGradeOutlook(server, apiClient) {
                 weightedNumerator: value.WeightedNumerator,
                 weightedDenominator: value.WeightedDenominator,
             })), { targetPercent, totalWeight });
+            // a course graded only in points still gets its current percent; only a course with nothing graded is an error
+            if (outlook.mode === "none") {
+                return errorResponse("This course has no graded items yet, so there is nothing to base a target grade on. " +
+                    "Try get_my_grades for the raw grade items.");
+            }
             return toolResponse({ courseId, ...outlook });
         }
         catch (error) {

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.4.
+> 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.6.
 
 ## Install
 
@@ -73,6 +73,23 @@ Short routing: due today -> get_todo, target grade -> get_grade_outlook, catch u
 | Exporting unfinished deadlines to a calendar | export_due_dates_calendar |
 | Enrolled courses | get_my_courses |
 
+## Related queries
+
+Searches this page answers, in the words students use:
+
+- what is due this week Brightspace
+- Brightspace due dates and submission status
+- Brightspace grade calculator
+- what do I need on the final to get an 80
+- Brightspace target grade calculator
+- Brightspace exam dates
+- Brightspace assignment rubric
+- Brightspace unread discussions
+- Brightspace calendar export
+- D2L MCP
+- D2L Brightspace MCP server
+- connect Brightspace to Claude Desktop
+
 ## Other commands
 
 - npx brightspace-d2l-mcp login signs in again

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brightspace-d2l-mcp",
-  "version": "1.4.4",
+  "version": "1.4.6",
   "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",
@@ -56,68 +56,32 @@
     "url": "https://github.com/AnonymousOnyx22/brightspace-d2l-mcp/issues"
   },
   "keywords": [
+    "brightspace",
+    "brightspace-mcp",
+    "brightspace mcp",
     "mcp",
     "mcp-server",
     "model-context-protocol",
-    "brightspace",
     "d2l",
     "desire2learn",
-    "d2l-brightspace",
     "brightspace-api",
-    "d2l-api",
-    "valence",
     "lms",
     "learning-management-system",
     "student",
-    "students",
-    "education",
-    "edtech",
-    "university",
-    "college",
-    "ai-agent",
-    "agent",
-    "claude",
-    "claude-desktop",
-    "claude-code",
-    "chatgpt",
-    "cursor",
-    "copilot",
-    "windsurf",
-    "llm",
     "assignments",
     "grades",
     "due-dates",
-    "homework",
-    "sso",
-    "brightspace-mcp",
+    "calendar",
     "d2l-mcp",
+    "d2l-brightspace",
     "brightspace-ai",
-    "d2l-ai",
-    "desire2learn-api",
-    "gemini",
-    "github-copilot",
-    "vscode",
-    "ai-assistant",
-    "study",
-    "school",
-    "course-content",
-    "announcements",
+    "claude",
+    "claude-desktop",
+    "cursor",
+    "homework",
     "rubrics",
-    "grade-calculator",
     "target-grade",
-    "calendar",
-    "ics",
-    "google-calendar",
-    "mcp-prompts",
-    "study-planner",
-    "homework-planner",
-    "d2l-calendar",
-    "brightspace-calendar",
-    "brightspace-grades",
-    "exams",
-    "exam-schedule",
-    "whats-new",
-    "unread-feedback",
-    "brightspace-calendar-events"
+    "grade-calculator",
+    "brightspace-grade-calculator"
   ]
 }