Skip to main content
Glama
D2L BrightSpace MCP

D2L BrightSpace MCP

An MCP (Model Context Protocol) server that gives AI assistants and agents read access to your Brightspace courses: 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 single sign-on.

Which tool to use

If you ask about

Use this tool

What to do now / what's due today

get_todo

What I need on remaining work for a target grade

get_grade_outlook

What's new across courses

get_whats_new

Upcoming deadlines with submission status

get_upcoming_due_dates

Exams, tests, labs or classes

get_calendar_events

Grades and instructor comments

get_my_grades

Assignments and quizzes with rubrics

get_assignments

Files attached to an assignment

get_assignment_files

Course modules, slides, files and links

get_course_content

Syllabus and course overview

get_syllabus

Recent announcements

get_announcements

Discussion forums and posts

get_discussions

Instructors and TAs with contact info

get_roster

Email addresses for a course

get_classlist_emails

Saving a course file or submission

download_file

Exporting unfinished deadlines to a calendar

export_due_dates_calendar

Enrolled courses

get_my_courses

Related MCP server: Brightspace MCP Server

Quick start

You need Node.js 20 or newer and Google Chrome or Microsoft Edge.

npx brightspace-d2l-mcp setup

That's it. Setup asks for your school, opens a browser so you can sign in, and connects every AI app it finds. Then ask your AI:

"What should I work on right now?"

New to this? The step-by-step setup guide walks through everything with pictures of each step. Using a specific app? See the guides for Claude and ChatGPT, or how this compares to other Brightspace MCP servers.

How it compares

People usually weigh a few Brightspace MCP servers before picking one. Here are the three differences that come up most, with the full comparison for the rest:

Server

Submission status

Sign-in (SSO)

Target grade

Brightspace MCP (this repo, brightspace-d2l-mcp)

Every due date says whether you already handed the work in, and the to-do list skips what is done

Real browser window where you sign in yourself, so any SSO works: Microsoft, Duo, Okta, Shibboleth. No password stored

get_grade_outlook gives your current percentage, your best and worst possible final grade, and what you need on the remaining work to hit any target

brightspace-mcp-server by RohanMuppa

Shown in its assignments tool

Automated sign-in that saves your password in Keychain or Credential Manager, with presets for nine schools

No target-grade tool in its published list

brightspace-mcp by JhostinAleck

Lists the files you submitted

Configured automation: HTTP login, headless browser with a Microsoft preset, Duo push, or pasted cookies

grade_audit answers "what you need to pass"

@n35da/brightspace-mcp

Shown on each dropbox folder

Real browser window where you sign in with your school's SSO

No target-grade tool in its published list

@exhabition/brightspace-mcp (Rust)

Has assignment and submission readers

Visible Chromium window, Microsoft SSO only

No target-grade tool in its published list

"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 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:

{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": ["-y", "brightspace-d2l-mcp@latest"]
    }
  }
}

On Windows, wrap the launch in cmd /c the same way you do now:

{
  "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 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

✅ What's left

"What should I work on right now?" · "What haven't I submitted yet?"

📅 Deadlines

"What's due this week?" · "Anything due tomorrow?"

📊 Grades

"What are my grades?" · "Am I passing Calculus?"

📢 Announcements

"Did any professor post something today?"

📚 Course content

"Find the midterm review slides" · "Summarize the Lab 3 instructions"

📎 Assignment files

"What does the rubric for the project ask for?"

💬 Discussions

"What are people saying in the final project thread?"

👥 Class list

"Who's the TA for my networking course?"

🎯 Target grade

"What do I need on the final to get an 80?" · "Can I still pass?"

🗓️ Calendar

"Put my deadlines in my calendar"

📝 Exams

"When is my midterm?" · "What's on my schedule this week?"

🔔 What's new

"Catch me up" · "Did anything get graded?"

It knows what you've already handed in

Most tools only see due dates, so they keep telling you to do work you've finished. This one checks your actual submission for every assignment:

Status

Meaning

submitted / graded

Done. Never suggested as a to-do.

not_submitted / draft

Still needs doing.

not_open_yet

The dropbox hasn't opened; shows when it will.

closed / past_due

You can no longer submit.

unknown

Quizzes: Brightspace doesn't show students their quiz attempts, so your AI will ask you.

Tools

17 MCP tools for D2L Brightspace. Everything reads from Brightspace and nothing is ever changed there:

Tool

What it does

get_todo

Prioritized to-do list across every course: what's due soon, overdue, not open yet, and already done

get_upcoming_due_dates

Upcoming deadlines with the real submission status of each assignment, for all courses or one course by name or code

get_my_courses

Your enrolled courses with names, codes and ids

get_my_grades

Grade breakdown per course with points, percentages and instructor comments, for all courses or one course by name or code

get_assignments

Assignments (dropboxes) and quizzes with due dates, status and rubrics

get_assignment_files

Reads the instructions, handouts and rubric files attached to an assignment

get_course_content

Course modules, lecture slides, files and links

get_syllabus

Course syllabus and overview

get_announcements

Recent announcements (news) from your instructors

get_discussions

Discussion forums, topics and posts

get_roster

Instructors and TAs with contact info, optionally the full class list

get_classlist_emails

Email addresses for everyone in a course

download_file

Saves a course file or submission to a folder you choose

get_grade_outlook

Where you stand in a course and what you need on the remaining work to hit a target grade

export_due_dates_calendar

Builds a calendar file (.ics) of your unfinished deadlines for Google Calendar, Apple Calendar and Outlook

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

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

Every school signs in differently: Microsoft, ADFS, Duo, Shibboleth, Okta, Google, campus pickers, or Brightspace's own form. Instead of guessing how your school works, setup opens a normal browser window and you sign in exactly like you do every day, text codes and authenticator apps included.

After that it stays signed in quietly in the background. If your school ever asks you to sign in again, the browser window simply pops up and closes by itself when you're done.

Does my school work?

If your school uses D2L Brightspace, yes. Setup opens a normal browser window so any sign-in works, including Microsoft, Duo, Okta and Shibboleth.

School

Status

One college

Tested by the author

Any other D2L school

Should work. Open an issue with yours and I will add it here

Works with your AI app or agent

Connected automatically by setup: Claude Desktop · Claude Code · Cursor · VS Code (GitHub Copilot) · Windsurf · OpenAI Codex · Gemini CLI · Cline · Roo Code · OpenCode · Zed · LM Studio · Kiro

One copy-paste away: ChatGPT (developer mode) · Continue · Goose · JetBrains AI Assistant · Warp · Amp · Msty · Jan · AnythingLLM

Agent frameworks: OpenAI Agents SDK · Claude Agent SDK · LangChain / LangGraph · Vercel AI SDK · Mastra · CrewAI · Pydantic AI · LlamaIndex

It runs over stdio for local apps and streamable HTTP (serve --http) for ChatGPT and hosted agents. See docs/agents.md for copy-paste setup for every one of these.

Install it with your AI

Paste this into Claude Code, Cursor, Windsurf, Copilot or Codex and it will set everything up for you.

Install brightspace-d2l-mcp for me by following
https://github.com/AnonymousOnyx22/brightspace-d2l-mcp/blob/main/llms.txt

Commands

Command

What it does

npx brightspace-d2l-mcp setup

Pick your school, sign in, connect your AI apps. On Windows the window closes by itself when done (--keep-open to stop that)

npx brightspace-d2l-mcp login

Sign in again

npx brightspace-d2l-mcp status

Show your school, whether you're signed in, and connected apps

npx brightspace-d2l-mcp doctor

Check Node, your school, sign-in and connected apps, and say how to fix anything wrong

npx brightspace-d2l-mcp logout

Delete the saved session

npx brightspace-d2l-mcp uninstall

Remove from all AI apps and delete all local data

npx brightspace-d2l-mcp serve --http

Run over HTTP for ChatGPT and HTTP-based agents

npx brightspace-d2l-mcp config

Print the MCP config JSON for any other app

When a newer version is out, commands ask whether to update first. Set BRIGHTSPACE_NO_UPDATE_CHECK=1 to turn that off.

npx brightspace-d2l-mcp setup --school yourschool.brightspace.com   # skip the school question
npx brightspace-d2l-mcp setup --apps claude-desktop,cursor          # only connect these apps
npx brightspace-d2l-mcp setup --skip-login                          # sign in later, on first use
npx brightspace-d2l-mcp setup --yes                                 # accept every default

App ids: claude-desktop, claude-code, cursor, vscode, windsurf, codex, gemini-cli, cline, roo-code, opencode, zed, lm-studio, kiro.

Privacy and security

  • Your password is never seen or stored. You type it into your school's own sign-in page in a real browser.

  • Read-only. It can't submit, post, or change anything in Brightspace. No tool sends anything but GET requests, the API client has no write methods at all, and a test fails the build if one is ever added. See how read-only is enforced.

  • Local only. Everything runs on your computer and talks only to your school's Brightspace. There's no server in between, and no analytics.

  • Uses the official Brightspace API with the same access you have in your browser.

  • Your session is saved in ~/.brightspace-d2l-mcp/, readable only by your user account. logout deletes it; uninstall deletes everything.

Troubleshooting

Something not working? docs/troubleshooting.md walks through an app that shows no Brightspace tools, a setup window that never opens, and a single sign on that keeps failing, with the exact message each one prints. It starts with npx brightspace-d2l-mcp doctor.

Install Google Chrome or use Microsoft Edge (already on Windows). Or install a private copy of Chromium with npx playwright install chromium.

Sign in to Brightspace in your browser, then copy the address from the address bar (any page works). If it says your site "runs Blackboard" or "Canvas", your school doesn't use Brightspace.

Fully quit Claude Desktop (tray icon → Quit, not just closing the window), then run setup again. Claude Desktop rewrites its settings while it's open, so setup offers to restart it for you.

Some schools end sessions every few hours. When that happens a browser window opens so you can sign in again. Run npx brightspace-d2l-mcp doctor to find out what is wrong, status for a quick look, or login to sign in right away. If you'd rather it never opens a window on its own, add "autoLogin": false to ~/.brightspace-d2l-mcp/config.json.

Add course ids to ~/.brightspace-d2l-mcp/config.json:

{ "excludeCourses": [123456, 789012] }

Or keep only specific ones with "includeCourses". Ask your AI "list my courses with their ids" to find them.

FAQ

Run npx brightspace-d2l-mcp setup. It connects Claude Desktop and Claude Code automatically. Then ask Claude about your courses.

Yes. This connects Brightspace to the AI app you already use (Claude, ChatGPT, Cursor, GitHub Copilot, Gemini and others), so you can ask about deadlines, grades and course files in plain English instead of clicking through every course.

Run npx brightspace-d2l-mcp serve --http, expose it with a tunnel, and add the URL as a connector in ChatGPT developer mode. docs/agents.md walks through each step.

Run npx brightspace-d2l-mcp setup. It finds Cursor, VS Code, Windsurf and 10 other apps and connects them for you.

Yes. Local agents and SDKs launch it with npx -y brightspace-d2l-mcp@latest, and ChatGPT or HTTP-based agents use npx brightspace-d2l-mcp serve --http. docs/agents.md has copy-paste setup for ChatGPT, the OpenAI Agents SDK, Claude Agent SDK, LangChain, Vercel AI SDK and more.

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.

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 covers what carries over and what does not.

Yes. You sign in yourself in a real browser window, so any sign-in method your school uses works.

Yes. Ask "what do I need on the final to get an 80 in Calculus?" and get_grade_outlook uses the weights Brightspace reports to give your current percentage, your best and worst possible final grade, and the average you need on everything left.

Yes. Ask your AI to put your deadlines in your calendar. export_due_dates_calendar makes an .ics file with a link back to Brightspace and a one day reminder on each event, and only includes work you have not handed in.

Any school on D2L Brightspace, whether the address looks like yourschool.brightspace.com, yourschool.desire2learn.com, or a custom domain like learn.yourschool.edu.

No. It's read-only on purpose.

Yes. D2L, short for Desire2Learn, is the company, and Brightspace is its learning platform. Schools use the names loosely, and older school addresses often end in desire2learn.com. This server works with all of them.

Not directly. Brightspace Pulse is D2L's student mobile app, and this server does not connect to it or to any phone. It reads the same courses, due dates and grades from your school's Brightspace site on your computer, so you can ask your AI app about what Pulse would show you.

It is read only. It can look at your courses, grades, files and class lists, but it cannot submit work, post to a discussion, edit anything or change a grade. See how read only is enforced.

No. It's an independent open-source project that uses the official Brightspace API with your own sign-in. It isn't affiliated with or endorsed by D2L.

Development

git clone https://github.com/AnonymousOnyx22/brightspace-d2l-mcp.git
cd brightspace-d2l-mcp
npm install
npm run build
npm test
node build/index.js setup     # connects your AI apps to this local build

Tools live in src/tools/, sign-in in src/auth/, and setup in src/cli/. Issues and pull requests are welcome.

More free student MCP servers

All free, open source and read only where they touch your accounts. Browse the full list at brightspacemcp.com/more-mcps.

Server

What it does

Canvas MCP

Canvas LMS for AI, read only. Due dates, missing work, grades and announcements.

Moodle MCP

Moodle for AI, read only. Due dates, overdue work, grades and announcements.

Google Classroom MCP

Google Classroom for AI, read only. Todos, due dates, missing work and grades.

GPA Calculator MCP

GPA, grade conversion and the grade you need on the final, for AI. Works offline, no account.

Citations MCP

APA, MLA and Chicago citations from a DOI, an ISBN or typed details. No account.

Study Planner MCP

Exam study schedules, spaced repetition dates, pomodoro plans and assignment milestones. Works offline.

Paper Finder MCP

Search scholarly papers, find open access copies and related work through OpenAlex. No key needed.

BibTeX Reference Manager MCP

Clean, convert, dedupe and lint BibTeX, RIS and CSL JSON reference lists, and make cite keys. Works offline.

Open Textbook Finder MCP

Find free legal copies of textbooks on OpenStax, DOAB and Open Library, look up editions by ISBN and suggest cheaper older ones.

STEM Calculator MCP

Chemistry and physics homework math: molar mass, balancing equations, grams to moles, unit conversion and significant figures. Works offline.

Essay Stats MCP

Offline writing metrics for essays. Word and page counts, readability scores, passive voice, repeated openers, filler words, long sentences and word limit checks, so students can check their work against assignment requirements. No account, no network.

Syllabus to Calendar MCP

Syllabus to calendar MCP server. Extract dates from syllabus text, build an ics calendar, expand recurring classes and merge calendars. Works offline, no account.

Job Application Tracker MCP

Job application tracker MCP server. Track internships, jobs, interviews and deadlines offline, see what is coming up, and export your list as CSV or Markdown. No account and no API keys.

License

MIT © AnonymousOnyx22

D2L and Brightspace are trademarks of D2L Corporation. This project is not affiliated with D2L.

Available Tools

17 tools
download_fileDownload FileA

Download a file from course content or assignment submissions to a local directory. Use this when the user wants to download, save, or get a file from Brightspace course content or dropbox submissions. Example: "Save the week 4 problem set PDF to my homework folder." IMPORTANT: You MUST ask the user where they want to save the file before calling this tool. Never guess or assume a download directory. After identifying the file to download, suggest a clean readable filename to the user (e.g., 'Lecture 7 - Memory Management.pdf' instead of 'L07_CS251_2026SP_v2.pdf') and ask if they'd like to rename it. Pass their preferred name as customFilename, or omit it to keep the original.

Inputs: courseId (required), downloadPath (required), fileId, topicId, +2 more.

export_due_dates_calendarExport Due Dates To CalendarA
Idempotent

Builds an iCalendar (.ics) file of upcoming assignments and quizzes that opens in Google Calendar, Apple Calendar and Outlook. Each event has a link back to Brightspace and a one day reminder. By default only unfinished work is included. Pass downloadPath (an absolute folder) to save the file, otherwise the calendar text is returned. Example: "Put my upcoming due dates in Google Calendar."

Inputs: courseId, daysAhead, downloadPath, includeSubmitted.

get_announcementsGet AnnouncementsA
Read-only

Fetch recent announcements (news items) from your courses in D2L Brightspace. Can filter to a specific course or get announcements across all courses. Pass course with a name or code when you know it, or courseId when you have the ID. Use this when the user asks about announcements, news, news items, updates from instructors, recent posts, or what professors said in Brightspace or D2L. Example: "Did my professors post anything new?"

Inputs: count, course, courseId.

get_assignment_filesGet Assignment FilesA
Read-only

Read the files an instructor attached to an assignment: the spec or instructions PDF, a starter workbook, a rubric document. Call it with just courseId to see which assignments have attachments, then with folderId and fileId to read one. Use this when the user asks what an assignment requires, what the instructions say, or to summarize a handout. Returns the text itself. Use download_file instead when the user wants the file saved to disk. Example: "What does the lab report assignment ask for?"

Inputs: courseId (required), fileId, folderId, maxChars, +1 more.

get_assignmentsGet AssignmentsA
Read-only

Fetch assignments and quizzes for a specific course or all enrolled courses in D2L Brightspace. Shows dropbox (assignment) submissions and quizzes with due dates, status, and rubric info. Use this when the user asks about assignments, homework, dropboxes, dropbox folders, what to submit, quizzes, or assignment details and rubrics in Brightspace or D2L. Pass course with a name or code when you know it, or courseId when you have the ID. This is not get_assignment_files: it lists assignments and their status, it does not read the instruction PDFs or handouts attached to them. Example: "What assignments do I have in Calculus this week?"

Inputs: course, courseId.

get_calendar_eventsGet Calendar EventsA
Read-only

Events from the Brightspace course calendar: exams, tests, labs, classes, office hours and other dated events that instructors post, plus due-date events. Use this when the user asks when an exam or test is, what is on their schedule, or what is happening on a day. For what work is left to hand in, use get_todo instead. Example: "When is my final exam?"

Inputs: search, courseId, daysBack, daysAhead.

get_classlist_emailsGet Classlist EmailsA
Read-only

Fetch all email addresses for everyone in a course: instructors, TAs, and students. Use this when the user wants a list of emails for a class, needs to email the whole class, or wants contact info for everyone enrolled. Returns emails only, with no names or roles. For names, roles or finding a specific instructor or TA, use get_roster instead. Example: "Give me everyone's email in my Biology course."

Inputs: courseId (required).

get_course_contentGet Course ContentA
Read-only

Fetch the content tree for a course showing modules, topics, files, and links. Use this when the user asks about course materials, lecture slides, uploaded files, content structure, or what's in a course module. Use moduleTitle to filter to a specific module (e.g. 'Labs', 'Staff', 'Homeworks') instead of fetching the entire tree. Use maxDepth to limit recursion depth for a table-of-contents view. Example: "Where are the lecture slides for week 4?"

Inputs: courseId (required), maxDepth, typeFilter, moduleTitle.

get_discussionsGet DiscussionsA
Read-only

Fetch discussion board content for a course including forums, topics, and posts. Use this when the user asks about discussion boards, forum posts, class discussions, or wants to see what's been posted. Provide just courseId to list all forums and their topics. Add forumId to get topics and posts for a specific forum. Add both forumId and topicId to get all posts in a specific discussion topic. Example: "What have people posted in this week's discussion board?"

Inputs: courseId (required), forumId, topicId.

get_grade_outlookGrade Outlook And Target CalculatorA
Read-only

Works out where the user stands in one course and what they need on the remaining work to reach a target grade. Returns the current percentage, the best and worst possible final grade, and the average they must score on everything left to hit targetPercent. Use for "can I still pass?" or "am I on track?". For the raw grade items, use get_my_grades instead. Example: "What do I need on the final to get an 80?"

Inputs: courseId (required), totalWeight, targetPercent.

get_my_coursesGet My CoursesA
Read-only

Fetch your enrolled Brightspace courses with names, codes, and IDs. Use this when the user asks about their courses, enrolled classes, what they're taking this semester, or needs a course ID for other queries. Example: "What courses am I taking this term?"

Inputs: activeOnly.

get_my_gradesGet My GradesA
Read-only

Fetch your grade breakdown for a specific course or all enrolled courses in D2L Brightspace. Shows grade items (grade columns) with points, percentages, and comments. Pass course with a name or code when you know it, or courseId when you have the ID. Use this when the user asks about grades, grade items, grade item, scores, marks, GPA, academic performance, or how they're doing in a class in Brightspace or D2L. Example: "What's my current grade in Calculus?"

Inputs: course, courseId.

get_rosterGet Course RosterA
Read-only

Fetch the roster for a course including instructors, TAs, and optionally students with their names, emails, and roles. Use this when the user asks about classmates, instructor contact info, TA emails, professor names, or who's in a class. By default returns only instructors and TAs for privacy. Use includeStudents to get full class list. This is not get_classlist_emails: for just a plain list of email addresses to copy or email everyone, use that tool instead. Example: "Who's the TA for my Chemistry class and what's their email?"

Inputs: courseId (required), limit, searchTerm, includeStudents.

get_syllabusGet Course SyllabusA
Read-only

Fetch the syllabus/overview text and optional attachment for a course. Returns the course overview description as markdown. If downloadPath is provided, also downloads the syllabus attachment (e.g. PDF). Example: "What's the grading breakdown in my Physics course?" IMPORTANT: You MUST ask the user where they want to save the file before calling this tool with a downloadPath.

Inputs: courseId (required), downloadPath.

get_todoWhat To Do NowA
Read-only

Prioritized to-do list across all courses: unfinished work due soon, recently overdue work, work not open yet, items to double-check (quizzes), and work already submitted. Use this first when the user asks what to work on, what's left, or what they should do now. This is not get_upcoming_due_dates: for a plain chronological list of deadlines or a custom date range, use that tool instead. Example: "What should I work on right now?"

Inputs: daysAhead, includeOverdueDays.

get_upcoming_due_datesGet Upcoming Due DatesA
Read-only

Upcoming due dates across all courses, with whether each assignment is already submitted (submissionStatus: submitted, graded, draft, not_submitted, not_open_yet, closed, past_due, restricted, unknown). Dates are UTC ISO strings; convert to the user's local time. Use for deadlines, what's due and date ranges, in date order. Pass course with a name or code to filter without looking up an ID. For advice on what to do first, use get_todo instead. Example: "What's due next week?"

Inputs: course, courseId, daysAhead.

get_whats_newWhat's NewA
Read-only

One catch-up summary across all courses: new announcements, unread assignment feedback (newly marked work), unread discussion posts and quizzes not attempted yet. Use this when the user asks what's new, what they missed, whether anything was graded or posted, or for a daily or weekly catch-up. Example: "What did I miss in my courses this week?"

Inputs: courseId, sinceDays.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 17 tools

    Disambiguation4/5

    Most tools target clearly different resources (grades, roster, syllabus, discussions, content tree, files), and several descriptions explicitly fence off neighbors (get_todo vs get_upcoming_due_dates, get_roster vs get_classlist_emails, get_assignments vs get_assignment_files). The remaining overlap is real but manageable: get_todo/get_upcoming_due_dates/get_whats_new/get_calendar_events all answer slightly different flavors of 'what's going on', and an agent must read carefully to pick correctly.

    Naming Consistency4/5

    Nearly everything is snake_case with a get_ verb prefix, giving a strong predictable pattern. Two outliers (download_file, export_due_dates_calendar) break the get_ prefix but are still verb_noun and self-explanatory.

    Tool Count4/5

    17 tools is on the heavy side but each maps to a distinct LMS surface area (courses, todo, grades, outlook, assignments, files, content, roster, syllabus, discussions, calendar, announcements, exports), so there is little obvious redundancy. It sits just at the upper edge of comfortable scoping.

    Completeness4/5

    Read/lifecycle coverage for a student view of Brightspace is thorough: courses, work, deadlines, grades plus projections, materials, discussions, roster, syllabus, and export. The notable gap is any write action (submitting an assignment, posting/reply to a discussion, marking items complete), which forces the agent to hand off to the web UI.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers