Bragproof

← Reports

brightspace-d2l-mcp

Starts with no setup1.4.9npm

Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.

Needs to start: nothing
Returns a result when called with no setup: 0 of 5 tools tried
Contacts while installing and starting: nothing

17tools listed
0hosts contacted
0files written
0.3 sto start
110dependencies

Its tool definitions changed since version 1.4.8. If you approved the earlier ones, read them again.

What it contacted

Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.

Starting it

npx -y brightspace-d2l-mcp@1.4.9

Installing a package runs its code. Use a sandbox for anything you have not read.

Calling its tools

5 tools that take no input and look read-only were called once with nothing. 0 returned a result.

get_todoNo usable answer tool reported an error: Brightspace is not set up yet. Run `npx -y brightspace-d2l-mcp@latest setup` in a terminal.
get_my_coursesNo usable answer tool reported an error: Brightspace is not set up yet. Run `npx -y brightspace-d2l-mcp@latest setup` in a terminal.
get_upcoming_due_datesNo usable answer tool reported an error: Brightspace is not set up yet. Run `npx -y brightspace-d2l-mcp@latest setup` in a terminal.
get_my_gradesNo usable answer tool reported an error: Brightspace is not set up yet. Run `npx -y brightspace-d2l-mcp@latest setup` in a terminal.
get_announcementsNo usable answer tool reported an error: Brightspace is not set up yet. Run `npx -y brightspace-d2l-mcp@latest setup` in a terminal.

During the calls it contacted nothing it had not already contacted.

Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.

What its tools tell an agent

In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.

2 tools with commands in capitals or very long text
  • Gives the agent orders in download_file: e: "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 as
  • Gives the agent orders in get_syllabus: ample: "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 downloadPat

Common and usually harmless: it is how many makers stress how a tool should be used.

Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.

Tools

get_todo daysAhead, includeOverdueDays
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?"
get_my_courses activeOnly
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?"
get_upcoming_due_dates daysAhead, courseId, course
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?"
get_my_grades courseId, course
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?"
get_announcements courseId, course, count
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?"
12 more tools
get_assignments courseId, course
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?"
get_assignment_files courseId, folderId, fileId, extractText, maxChars
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?"
get_course_content courseId, typeFilter, moduleTitle, maxDepth
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?"
download_file courseId, topicId, folderId, fileId, downloadPath, customFilename
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.
get_classlist_emails courseId
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."
get_roster courseId, includeStudents, searchTerm, limit
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?"
get_syllabus courseId, downloadPath
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.
get_discussions courseId, forumId, topicId
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?"
get_grade_outlook courseId, targetPercent, totalWeight
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?"
export_due_dates_calendar daysAhead, courseId, includeSubmitted, downloadPath
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."
get_calendar_events daysAhead, daysBack, courseId, search
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?"
get_whats_new sinceDays, courseId
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?"

Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.

Install facts

LicenseMIT
Needsnode >=20.0.0
Sourcegithub.com/AnonymousOnyx22/brightspace-d2l-mcp
Install scriptsNone declared by it or anything installed with it.
Tarballsha512-GPsNCi5ytWtjG9tURBI41jeuDtFHjVj9rs4tK5lmlBOFlwxb9/TXfAObG1gAsGVS/TydZBrebSJPF4wfcX36OQ==

Versions reported

VersionRunResultTools
1.4.92026-11-16Starts with no setup17
1.4.82026-11-12Starts with no setup17

Check this report yourself

This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.

Show it on your README

Bragproof: Starts with no setup

[![Bragproof](https://bragproof.smaverk.com/badge/brightspace-d2l-mcp.svg)](https://bragproof.smaverk.com/r/brightspace-d2l-mcp)

New version out? Ask for a fresh report.