UAEU Blackboard MCP
Reads Google Drive files, Colab notebooks, and Google Docs/Slides/Sheets exports linked from Blackboard course content or announcements, with optional separate Google sign-in for private files.
Reads Google Docs linked from Blackboard course content and announcements, including exported document text.
Retrieves title and channel metadata for YouTube links posted in Blackboard; it does not provide transcripts.
Best-effort reads page text or captions from Zoom recording pages linked in Blackboard; protected recording APIs and live meetings are not supported.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@UAEU Blackboard MCP What assignments are due this week?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
UAEU Blackboard MCP
An MCP server for UAEU Blackboard Learn (https://uaeu.blackboard.com) that gives an AI
assistant your courses, assignments, discussions, messages, calendar, groups, content and
grades — plus the write actions Blackboard actually permits for your role.
Quick install · Agent installation prompt · Download v0.1.0
It uses the same internal Ultra API the Blackboard web app calls, authenticated with your own SSO session. No administrator-issued OAuth application is required.
$ uaeu-blackboard-mcp login
A browser window is open. Sign in to UAEU Blackboard (SSO + MFA).
Signed in as Example Student
Instance: https://uaeu.blackboard.com
API mode: internalCoverage
Area | Read | Write | Live status |
Assignments | instructions, deadlines, points, attempts, submission status, submission files | submit text/files, resubmit | read verified; submit implemented, needs one real attempt to confirm |
Discussions | forums, threads, replies, authors, read state | create thread, reply, edit/delete own posts | read verified; create/reply payload captured from the UI |
Messages | conversations, message history, per-course unread summary, recipient search | send message, reply | read verified; send payload captured from the UI |
Calendar | deadlines and personal events, date filtering | create, update, delete personal events | create → list → delete verified end-to-end |
Groups | groups, group sets, members, sign-up state | join (self sign-up), upload group file | read verified; writes experimental |
Profile & settings | profile, editable-field permissions | update permitted profile fields, read notification prefs | read verified |
Course content (instructor) | outline, modules, pages, files, visibility | create module/page, edit, show/hide, delete | read verified; writes require an instructor role |
Announcements (instructor) | announcements, read state | create, schedule, edit, delete | read verified; writes require an instructor role |
Assessments (instructor) | assessment list, settings, questions, rubrics | create assignment, change deadline, attach rubric | read verified; writes require an instructor role |
Grading (instructor) | gradebook, grades, attempts, submissions | enter grades and feedback, grant extensions/exemptions | read verified; writes require a grading role |
Course management | roster, roles, permissions | enroll, change role, remove member | read verified; writes require course management permission |
Instructor-only writes are implemented against Blackboard's documented request shapes but could not be exercised from a student account. They fail closed with a permission error when your role does not allow them.
Related MCP server: blackboard-mcp
Reading files and course links
The local connector also provides these read-only tools:
Tool | Purpose |
| Find files and posted links across the outline, with created/modified dates |
| Resolve downloadable files attached to a content item |
| Download a file and return its extracted text, saved path and limitations |
| Read a link posted in the specified course content or announcement |
| Combine upcoming deadlines and recently overdue work across courses |
| Combine changed content, announcements, assignments and grades on changed columns |
| Package assignment instructions, status, files, links, rubric associations and related announcements |
For example, find the newest lecture with bb_get_course_content, then pass its courseId
and contentId to bb_get_attachment. Continue long documents by returning nextOffset
as offset. Pages default to 20,000 characters. Extraction results are cached in memory
for ten minutes to make continuation calls cheap.
Supported files: PDF text by page, PPTX slides and speaker notes, DOCX paragraphs and notes,
XLSX as CSV per worksheet, Jupyter notebook source, HTML and plain text/code. Notebook cells
are never executed. Spreadsheets show cached formula results without recalculation. Images,
slide diagrams, scanned PDFs, animations and legacy .ppt/.doc/.xls formats are not
interpreted. Scans need a separate OCR reader. Files are limited to 50 MiB, expanded Office
XML to 100 MiB, and returned document text to two million characters; limits are reported.
Downloads go to BB_DOWNLOAD_DIR, defaulting to Downloads/blackboard, and keep the original
filename (with filesystem-invalid characters sanitized). If a different file already uses
that name, a numbered suffix is added, such as Lecture (1).pptx. Identical existing files
are reused. These tools never submit work or modify Blackboard.
bb_read_link verifies the URL against the supplied course source. Pass contentId or
announcementId for an exact source, or omit both to search that course's outline and first
100 announcements. It supports Google Docs/Slides/Sheets exports, Drive files, Colab notebooks,
ordinary web pages and linked files. Public same-origin HTML caption tracks can be read.
YouTube returns title/channel metadata, not a transcript. Zoom and other recording pages are
best-effort page text/captions; protected recording APIs, Syracuse-specific video services,
live meetings and interactive LTI tools are not implemented. Private files require access
on their own service. Sign in yourself from a terminal when needed:
node dist/cli.js connect google
node dist/cli.js connect zoomThe CLI opens a separate browser profile and saves linked-site cookies locally, separately from Blackboard. It does not copy the user's Chrome profile. Google may refuse automated sign-in. Sessions expire normally, and access failures are returned explicitly. Each HTTPS redirect is checked, DNS is pinned to public addresses, and cookies stay domain/path scoped.
Upcoming work uses Asia/Dubai day boundaries and preserves unknown submission states. Cross-course sweeps check at most 20 available courses and report skipped courses/source failures. Recent update dates indicate edits as well as uploads; grades entered on unchanged older columns can be missed. Deadlines outside Blackboard are not included.
After rebuilding an already-running MCP, reconnect the connector or restart its host so the
client discovers the new tools. Run npm test for the extraction/reading regression suite.
Requirements
Node.js 20 or newer
Microsoft Edge or Google Chrome (used once, for the SSO sign-in)
A UAEU Blackboard account
Quick install — no clone or build
Install Node.js 20+ and Edge or Chrome, then sign in once:
npx --yes --package=https://github.com/AhmTb/uaeu-blackboard-mcp/releases/download/v0.1.0/uaeu-blackboard-mcp-0.1.0.tgz uaeu-blackboard-mcp loginComplete UAEU SSO and MFA in the browser that opens. The prebuilt package is downloaded from this repository's GitHub release and cached by npm. It needs no Git installation or TypeScript compiler. Each account signs in separately; students and instructors use the same package.
Automatic client configuration with add-mcp
add-mcp can register the released server
for you, without editing client configuration files. After signing in above, run this
on Windows to choose the client interactively:
npx --yes add-mcp "cmd /d /c npx --yes --package=https://github.com/AhmTb/uaeu-blackboard-mcp/releases/download/v0.1.0/uaeu-blackboard-mcp-0.1.0.tgz uaeu-blackboard-mcp" --name uaeu-blackboard --globalOn macOS or Linux:
npx --yes add-mcp "npx --yes --package=https://github.com/AhmTb/uaeu-blackboard-mcp/releases/download/v0.1.0/uaeu-blackboard-mcp-0.1.0.tgz uaeu-blackboard-mcp" --name uaeu-blackboard --globalTo target a specific client without prompts, append --agent codex --yes.
Other client IDs include claude-code, cursor, claude-desktop, and vscode.
Omit --global to configure only the current project where the client supports it.
Writes stay disabled unless you append --env BB_ALLOW_WRITES=1; individual write
tools still require confirmation. Restart or reconnect the client after registration.
Registration saves the launch command; npm downloads the server when it runs.
Codex
On Windows (PowerShell):
codex mcp add uaeu-blackboard --env BB_ALLOW_WRITES=1 -- cmd /d /c npx --yes --package=https://github.com/AhmTb/uaeu-blackboard-mcp/releases/download/v0.1.0/uaeu-blackboard-mcp-0.1.0.tgz uaeu-blackboard-mcpOn macOS or Linux:
codex mcp add uaeu-blackboard --env BB_ALLOW_WRITES=1 -- npx --yes --package=https://github.com/AhmTb/uaeu-blackboard-mcp/releases/download/v0.1.0/uaeu-blackboard-mcp-0.1.0.tgz uaeu-blackboard-mcpCheck registration with codex mcp get uaeu-blackboard. Reopen Codex if needed, then ask it
to run bb_whoami and list your courses. The first download can take longer than a cached
launch; run the login command before registering the server so the package is already cached.
Claude Code
On Windows:
claude mcp add --scope user --env BB_ALLOW_WRITES=1 --transport stdio uaeu-blackboard -- cmd /d /c npx --yes --package=https://github.com/AhmTb/uaeu-blackboard-mcp/releases/download/v0.1.0/uaeu-blackboard-mcp-0.1.0.tgz uaeu-blackboard-mcpOn macOS or Linux, use the same command with -- npx --yes ... instead of
-- cmd /d /c npx --yes .... Check registration with claude mcp get uaeu-blackboard.
Cursor, Claude Desktop and other local MCP clients
Merge this entry into the client's mcpServers configuration. Cursor supports a user-wide
~/.cursor/mcp.json. Other clients can use their MCP settings screen to enter the same
command, arguments and environment. Existing server entries should remain intact.
{
"mcpServers": {
"uaeu-blackboard": {
"command": "npx",
"args": ["--yes", "--package=https://github.com/AhmTb/uaeu-blackboard-mcp/releases/download/v0.1.0/uaeu-blackboard-mcp-0.1.0.tgz", "uaeu-blackboard-mcp"],
"env": { "BB_ALLOW_WRITES": "1" }
}
}
}On Windows, use "command": "cmd" and prepend "/d", "/c", "npx" to args.
If a client requires a transport field, set "type": "stdio".
VS Code uses a servers wrapper in its MCP configuration instead of mcpServers. Use
MCP: Add Server, choose a local command, and enter the command above, or use:
{
"servers": {
"uaeu-blackboard": {
"type": "stdio",
"command": "npx",
"args": ["--yes", "--package=https://github.com/AhmTb/uaeu-blackboard-mcp/releases/download/v0.1.0/uaeu-blackboard-mcp-0.1.0.tgz", "uaeu-blackboard-mcp"],
"env": { "BB_ALLOW_WRITES": "1" }
}
}
}Apply the same Windows command adjustment when needed. This is a local stdio server; clients that accept only remote HTTP servers need a separate local bridge.
Client references: Codex, Claude Code, Cursor, VS Code.
Agent installation prompt
Copy this prompt into an AI coding agent that can run terminal commands and edit local settings:
Install UAEU Blackboard MCP for the AI client I am using.
Repository: https://github.com/AhmTb/uaeu-blackboard-mcp
Package: https://github.com/AhmTb/uaeu-blackboard-mcp/releases/download/v0.1.0/uaeu-blackboard-mcp-0.1.0.tgz
1. Read this repository's README. Detect my OS and the current AI client. Check
Node.js 20+, npm/npx, and Edge or Chrome. Report any missing prerequisite.
2. Run `npx --yes --package=<Package URL> uaeu-blackboard-mcp --help`
to verify the prebuilt download works.
Git and a TypeScript build are unnecessary for the release package.
3. Run `npx --yes --package=<Package URL> uaeu-blackboard-mcp login`.
I will complete UAEU SSO and MFA in the
browser. Wait for successful login. Keep passwords, cookies, tokens and the
browser profile out of chat and MCP configuration.
4. Register a local stdio server named `uaeu-blackboard` for my current client
with BB_ALLOW_WRITES=1. Use its supported configuration format, preserving
existing entries. Prefer user scope. On Windows use command `cmd` with args
`/d`, `/c`, `npx`, `--yes`, `--package=<Package URL>`, `uaeu-blackboard-mcp`.
On macOS/Linux use command `npx` with args `--yes`, `--package=<Package URL>`,
`uaeu-blackboard-mcp`. Set startup timeout to 60 seconds
if the client supports it. Ask which client only if it cannot be detected.
5. Verify the saved server entry and a real MCP initialization. Run `bb_whoami`
and `bb_list_courses` when the tools are available. Use read-only checks;
leave submissions, messages, grades and other writes untouched during setup.
6. Report the configuration location and connection result. If the running
client needs a restart, give the exact restart/reload step and distinguish
saved configuration from tools actually available in this session.
Keep this setup limited to my client and account. The server's existing
confirm:true requirement remains enabled for write actions.Install from source
git clone https://github.com/AhmTb/uaeu-blackboard-mcp.git
cd uaeu-blackboard-mcp
npm ci
npm run build
npm run login # opens Edge; sign in with SSO + MFA
npm run doctor # confirms the session and API surfaceEach student or instructor signs in with their own UAEU account. The available actions follow that account's Blackboard permissions; installing this server does not grant instructor access.
The session is stored at ~/.uaeu-blackboard-mcp/session.json (on Windows,
%USERPROFILE%\.uaeu-blackboard-mcp\session.json). It contains live credentials and must stay private.
The login browser profile and browser-session.json are stored alongside it. The latter
preserves session-only SSO cookies across browser restarts. Keep all three private.
Before making a request, the server picks up newer sessions saved by another local process.
When a tool call finds a missing or expired session, it first tries the saved SSO browser
profile in a hidden browser for up to twenty seconds. If SSO can renew the session, the read
continues without a login prompt. Otherwise, an Edge or Chrome login window opens. Complete
SSO and MFA there; cookies are captured and saved automatically, and the interrupted read
retries once. No copied cookies or terminal command is needed.
Concurrent requests share one login window. Startup and background keep-alives do not open it.
Closing the window or failing to sign in within ten minutes returns an error; call the tool again
to retry. Writes are never replayed automatically after sign-in; check Blackboard before retrying.
You can still sign in explicitly with npm run login.
The server pings a keep-alive endpoint while it is running and saves renewed cookie expiry
times. Blackboard and UAEU still control session lifetimes and when MFA is required.
Headless / CI sign-in
Copy the Cookie: header from any request to uaeu.blackboard.com in DevTools and run:
node dist\cli.js login --cookie "BbRouter=...; JSESSIONID=..."Connect it to your assistant
Add this to your MCP client's configuration:
{
"mcpServers": {
"uaeu-blackboard": {
"command": "node",
"args": ["/absolute/path/to/uaeu-blackboard-mcp/dist/index.js"],
"env": {
"BB_ALLOW_WRITES": "1"
}
}
}
}Replace the example path with the absolute path to your cloned repository. On Windows, use
forward slashes such as C:/path/to/uaeu-blackboard-mcp/dist/index.js, or escape backslashes
in JSON. The server uses stdio, so the client starts it automatically.
For Codex, run this from the cloned repository after building and signing in:
codex mcp add uaeu-blackboard --env BB_ALLOW_WRITES=1 -- node "$((Get-Location).Path)/dist/index.js"Or edit Codex's ~/.codex/config.toml:
[mcp_servers.uaeu-blackboard]
command = "node"
args = ["/absolute/path/to/uaeu-blackboard-mcp/dist/index.js"]
env = { BB_ALLOW_WRITES = "1" }Without BB_ALLOW_WRITES=1 the server is read-only and refuses every write action.
Restart your MCP client if the tools are not visible after adding the configuration. Start with
bb_whoami or ask your assistant to list your courses to check the connection.
Write safety
Every write tool requires both:
BB_ALLOW_WRITES=1in the server environment, andconfirm: truein the individual tool call.
Without the flag, the tool returns:
Write actions are disabled. Set BB_ALLOW_WRITES=1 in the MCP server environment to enable them.Without confirmation:
Refusing to submit this assignment without confirmation. Pass confirm: true to proceed.Submitting an assignment, sending a message or entering a grade has real consequences. Review the arguments before confirming.
Tool catalogue
Courses and identity — bb_whoami, bb_list_courses, bb_get_course, bb_list_terms
Assignments — bb_list_assignments, bb_get_assignment, bb_get_assignment_submission,
bb_submit_assignment
Discussions — bb_list_discussions, bb_get_discussion, bb_get_discussion_thread,
bb_create_discussion_thread, bb_reply_to_discussion, bb_edit_discussion_post,
bb_delete_discussion_post
Messages — bb_list_conversations, bb_get_conversation, bb_message_summary,
bb_send_message, bb_reply_message, bb_find_recipients
Calendar — bb_list_calendar, bb_create_calendar_event, bb_update_calendar_event,
bb_delete_calendar_event
Groups — bb_list_groups, bb_get_group, bb_list_group_members, bb_join_group,
bb_upload_group_file
Profile — bb_get_profile, bb_update_profile, bb_get_notification_prefs
Course content — bb_list_content, bb_browse_course, bb_get_content, bb_create_module,
bb_create_page, bb_update_content, bb_set_content_visibility, bb_delete_content
Announcements — bb_list_announcements, bb_create_announcement, bb_update_announcement,
bb_delete_announcement
Assessments — bb_list_assessments, bb_get_assessment, bb_create_assignment,
bb_set_assignment_deadline, bb_list_rubrics, bb_attach_rubric
Grading — bb_get_gradebook, bb_get_my_grades, bb_list_column_attempts, bb_get_attempt,
bb_grade_submission, bb_set_grade_exception
Course management — bb_list_roster, bb_add_member, bb_update_member_role,
bb_remove_member
Escape hatch — bb_raw_request (any /learn/api/... path; GET is always allowed)
Most tools accept a courseId that can be an internal id (_12345_1), a course code
(COURSE101_12345_Fall_2026), or a unique name fragment ("algorithms").
Configuration
Variable | Meaning |
| Instance origin, default |
|
|
| Session directory, default |
| Default list page size, 1–200, default 50 |
| Total timeout per HTTP request including retries and backoff, default 30000 |
| Identity, membership and outline cache lifetime, default 15000; 0 disables caching |
| Parallel outline folder reads, default 4; range 1–8 |
|
|
| Cookie header for non-interactive login |
Performance and response size
Identical simultaneous JSON reads share one HTTP request. Each caller receives an independent object. Raw/download responses are never shared.
Identity, memberships and outline pages use a bounded, in-memory cache (up to 64 responses). Every write clears cached reads before and after its request, including failed writes. Grades, assignment detail, raw requests and
bb_whoamiare fresh reads by default.Course traversal reads up to
BB_CONCURRENCYfolders together, follows folder pagination, deduplicates items and rejects pagination loops instead of silently returning incomplete results.Assignment detail and submission preparation fetch the specific assignment directly rather than traversing the entire course.
JSON output is compact.
bb_list_assignmentsdefaults to 50 summaries without instruction bodies; passlimit,offset, orincludeInstructions: trueas needed. Responses exposetotalandnextOffsetso more results can be requested explicitly.bb_get_assignmentreturns its normalized details; useincludeRaw: truefor the full original response.bb_list_contentacceptslimit,offsetandincludeDescriptions: true, and returns continuation information.bb_browse_courseacceptslimit/offsetwithtotal/nextOffset.
Transient GET failures retry up to three times within one timeout budget, respecting numeric or
HTTP-date Retry-After. Writes are sent once: a lost response could mean Blackboard already
performed the action. Connection failures report an unknown outcome rather than replaying a write.
Submission files are checked before an attempt is created; failures after creation identify the
attempt to inspect before trying again. Expired sessions and outages are surfaced instead of being
converted to empty assignment lists.
How it works
Blackboard exposes two API surfaces:
/learn/api/public/v1— the documented REST API. It requires an OAuth application registered by the institution, which students and most staff cannot obtain./learn/api/v1— the internal Ultra API used by the web client. It authenticates with theBbRoutersession cookie from SSO.
Both surfaces accept the BbRouter session on this instance. The server uses the internal Ultra
API for data the public API does not expose (discussions, conversations, calendar, Ultra content),
and the documented public API for documented CRUD (announcements, content, gradebook, enrollments).
Write requests carry the x-blackboard-xsrf token, which is embedded in the BbRouter cookie
value, so no extra bootstrap request is needed.
At sign-in the server probes both surfaces and records the result; npm run doctor shows both.
Verification
Live-verified against uaeu.blackboard.com running Blackboard Learn 4001.4.0, with a student
account:
authentication, enrolled courses, terms
assignments with real deadlines, points, attempts and submission state
discussion forums, threads and replies (including a correctly denied restricted forum)
conversations and message history
calendar deadlines and personal events
groups, roster, profile, gradebook, content outline
personal calendar create → list → delete (test event removed afterwards)
The server speaks MCP over stdio. Startup, tool discovery and student reads have been verified. Instructor writes and assignment submission still require verification with the corresponding role.
Security and privacy
Session credentials are stored locally and sent to the configured Blackboard host for authentication.
The session file and login browser profile contain live credentials; keep their directory private.
Tool results are passed to your connected AI client. Its data handling settings apply to that content.
Reads are limited to what your account can already see in the browser; Blackboard enforces permissions on every request.
Writes are disabled unless explicitly enabled, and each one needs confirmation.
Grades and feedback are personal data. Only request what you need.
Limitations
This is an unofficial integration. Blackboard can change the internal API without notice.
On expiry, the next tool call tries saved SSO before opening an interactive login window.
Ultra courses expose the full tool set. Classic courses expose less;
bb_raw_requestis the fallback.Group join/upload and instructor write paths are experimental until exercised with the relevant role.
Assignment submission is implemented as attempt → upload → post. Confirm the result in Blackboard the first time you use it.
Troubleshooting
Missing or expired session — a tool call tries saved SSO, then opens a login window if needed. Sign in there
and the read resumes. If the window was closed, call the tool again. If browser launch is blocked,
run npm run login on the same machine or use the headless sign-in command above.
Your Blackboard account is not permitted to perform this action — the tool needs a role your
account does not have (for example grading as a student), or the item is restricted.
A discussion returns 403 — the forum exists but is hidden from you by adaptive release or group membership.
spawn EPERM during login — the environment blocks browser processes; use login --cookie
with a copied cookie header instead.
Development
npm run build # tsc
npm run typecheck
node dist\cli.js doctorSource layout:
src/
index.ts MCP server and tool registration
cli.ts login / status / probe / doctor
auth/login.ts Playwright SSO capture
bb/client.ts HTTP client, cookies, XSRF, pagination, retries
bb/api.ts Blackboard domain operations
tools/*.ts One module per feature areaLegal
Not affiliated with or endorsed by United Arab Emirates University, Anthology or Blackboard. Use it with your own account and within UAEU's acceptable-use policy.
Available Tools
69 toolsbb_add_memberEnroll a memberAIdempotent
Enroll a user in a course with a role. Requires BB_ALLOW_WRITES=1, confirm:true and course management permission.
Inputs: role (required), userId (required), courseId (required), confirm.
bb_attach_rubricAttach rubric to assessmentAIdempotent
Associate a rubric with a gradebook column. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role.
Inputs: columnId (required), courseId (required), rubricId (required), confirm.
bb_browse_courseBrowse full course outlineBRead-only
Recursively flatten the entire course outline (modules, folders and items) with ids, handlers and visibility.
Inputs: courseId (required), limit, offset.
bb_create_announcementCreate announcementA
Create a course announcement, optionally scheduled with start/end dates. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role.
Inputs: body (required), title (required), courseId (required), confirm, +2 more.
bb_create_assignmentCreate assignmentA
Create a graded assignment (content + gradebook column) with instructions, due date, points and attempts. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role.
Inputs: title (required), courseId (required), confirm, dueDate, +4 more.
bb_create_calendar_eventCreate personal calendar eventA
Create an event on your personal Blackboard calendar. Requires BB_ALLOW_WRITES=1 and confirm:true.
Inputs: title (required), endDate (required), startDate (required), confirm, +2 more.
bb_create_discussion_threadCreate discussion threadB
Start a new thread in a forum where students may create threads. Requires BB_ALLOW_WRITES=1 and confirm:true.
Inputs: body (required), forumId (required), subject (required), courseId (required), +2 more.
bb_create_moduleCreate module or folderA
Create a module/folder in the course outline. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor/designer role.
Inputs: title (required), courseId (required), kind, confirm, +1 more.
bb_create_pageCreate pageA
Create a content page with HTML body inside a module/folder. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor/designer role.
Inputs: body (required), title (required), courseId (required), confirm, +1 more.
bb_delete_announcementDelete announcementADestructive
Delete an announcement. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role.
Inputs: courseId (required), announcementId (required), confirm.
bb_delete_calendar_eventDelete personal calendar eventADestructive
Delete an event you created. Requires BB_ALLOW_WRITES=1 and confirm:true.
Inputs: itemId (required), confirm.
bb_delete_contentDelete content itemADestructive
Delete a content item. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor/designer role.
Inputs: courseId (required), contentId (required), confirm.
bb_delete_discussion_postDelete own discussion postBDestructive
Delete a post you authored, where the forum allows deletion. Requires BB_ALLOW_WRITES=1 and confirm:true.
Inputs: forumId (required), courseId (required), messageId (required), boardId, +1 more.
bb_edit_discussion_postEdit own discussion postAIdempotent
Edit a post you authored, where the forum allows edits. Requires BB_ALLOW_WRITES=1 and confirm:true.
Inputs: body (required), forumId (required), courseId (required), messageId (required), +2 more.
bb_find_recipientsFind message recipientsARead-only
Search the participants of a course so you can obtain the user ids needed by bb_send_message.
Inputs: courseId (required), query.
bb_get_assessmentGet assessment settingsBRead-only
Get one assessment (gradebook column + linked content + questions when available).
Inputs: columnId (required), courseId (required).
bb_get_assignmentGet assignment detailsBRead-only
Get one assignment: instructions, rubric hint, deadline, points, attempts allowed, submission status, your score, and any attached files.
Inputs: courseId (required), contentId (required), includeRaw.
bb_get_assignment_contextRead full assignment contextARead-only
Return assignment instructions, scoring/submission status, available files, posted links, rubric associations when exposed, and related announcements in one call. Read files with bb_get_attachment.
Inputs: courseId (required), contentId (required).
bb_get_assignment_submissionGet assignment submissionsBRead-only
List attempts and submission files on a gradebook column. Students see their own attempts; instructors see every attempt.
Inputs: columnId (required), courseId (required).
bb_get_attachmentRead course attachment contentsARead-only
Download and read PDF, PPTX (slide text and speaker notes), DOCX, XLSX (CSV per sheet), Jupyter notebooks, HTML and text. Returns extracted text plus savedPath and limitations. Continue long files with nextOffset. No code execution or OCR. Does not submit or modify Blackboard.
Inputs: courseId (required), contentId (required), fileId, offset, +1 more.
bb_get_attemptGet attempt detailBRead-only
Get one submission attempt, including files, receipt and submission text.
Inputs: courseId (required), attemptId (required).
bb_get_contentGet content itemARead-only
Get one content item with its body text, file metadata, posted links, due date and permissions. Read file contents with bb_get_attachment.
Inputs: courseId (required), contentId (required).
bb_get_conversationRead conversationCRead-only
Read every message in a conversation.
Inputs: courseId (required), conversationId (required).
bb_get_courseGet courseARead-only
Get one course by its internal id (e.g. _12345_1). Returns name, code, description, term, availability and enrolment settings.
Inputs: courseId (required).
bb_get_course_contentBrowse course files and linksBRead-only
Flatten the course outline with modification dates, attachment metadata and posted links. Use this to find the latest uploaded lecture, then bb_get_attachment to read it.
Inputs: courseId (required), limit, offset.
bb_get_discussionRead discussion threadsBRead-only
Read the threads (top-level posts) in a discussion forum, with authors, bodies and reply counts.
Inputs: forumId (required), courseId (required), boardId.
bb_get_discussion_threadRead discussion repliesCRead-only
Read every reply to one discussion thread.
Inputs: forumId (required), courseId (required), messageId (required), boardId.
bb_get_gradebookGet gradebookARead-only
Return gradebook columns plus your own grades for a course. Instructors also see every column and its scoring settings.
Inputs: courseId (required).
bb_get_groupGet groupBRead-only
Get one group with its members and shared resources.
Inputs: groupId (required), courseId (required).
bb_get_my_gradesGet my gradesBRead-only
Return your grades for one course, with points possible and submission state.
Inputs: courseId (required).
bb_get_notification_prefsGet notification preferencesARead-only
Read your Ultra notification and email preferences. Experimental: the internal endpoint varies by Learn release.
Inputs: no named parameters.
bb_get_profileGet my profileARead-only
Return your profile: name, username, email, student id, avatar and which fields your account may edit.
Inputs: no named parameters.
bb_get_recent_updatesGet recent course updatesBRead-only
New or changed content, announcements, assignments and grades on recently modified gradebook columns. Default last seven days. Dates, files and links identify latest lectures for bb_get_attachment. Grades on older unchanged columns may be missed.
Inputs: since, courseId.
bb_get_upcoming_workGet upcoming work across coursesARead-only
Assignments due soon across courses, submission status, recently overdue items and undated counts. Default seven days ahead through end of the last day in Asia/Dubai, plus three days overdue. Unknown submission status never means confirmed missing work.
Inputs: days, courseId.
bb_grade_submissionGrade a submissionAIdempotent
Enter or change a grade and feedback for one student on a column. Requires BB_ALLOW_WRITES=1, confirm:true and a grading role.
Inputs: userId (required), columnId (required), courseId (required), score, +3 more.
bb_join_groupJoin a groupAIdempotent
Join a group that offers self sign-up. Requires BB_ALLOW_WRITES=1 and confirm:true. Experimental: Blackboard may restrict self-enrolment to the web UI.
Inputs: groupId (required), courseId (required), confirm.
bb_list_announcementsList announcementsBRead-only
List course announcements, newest first, with bodies and read state.
Inputs: courseId (required), limit.
bb_list_assessmentsList assessmentsARead-only
List graded assessments (assignments, tests) in a course with type, due date, points, attempts and visibility.
Inputs: courseId (required).
bb_list_assignmentsList assignmentsARead-only
List assignments and graded activities in a course with due dates, points, allowed attempts, and whether the student has submitted. Accepts a course id, course code (e.g. COURSE101_12345_Fall_2026) or unique name fragment.
Inputs: courseId (required), limit, offset, includeSubmitted, +1 more.
bb_list_attachmentsList downloadable course filesARead-only
Resolve downloadable files and posted links for a content item, including inline Ultra files and assignment attachments. Use bb_get_attachment to read file contents.
Inputs: courseId (required), contentId (required).
bb_list_calendarList calendarARead-only
List calendar items and deadlines in a date range (ISO 8601). Includes graded activity due dates and your personal events.
Inputs: since, until, courseId, onlyPersonal.
bb_list_column_attemptsList gradebook attemptsBRead-only
List attempts on a gradebook column. Students see their own; instructors see all students.
Inputs: columnId (required), courseId (required).
bb_list_contentList course contentARead-only
List one level of a course outline (modules, folders, pages, files, links, assignments). Use parentId ROOT for the main outline or INTERACTIVE for participation activities.
Inputs: courseId (required), limit, offset, parentId, +1 more.
bb_list_conversationsList conversationsCRead-only
List course message conversations with unread counts and participants.
Inputs: courseId (required), limit.
bb_list_coursesList my coursesARead-only
List every course the signed-in user is enrolled in, with the internal course id (e.g. _12345_1), display name, course code and role. Course ids from here are required by the other tools.
Inputs: includeHidden.
bb_list_discussionsList discussionsARead-only
List discussion forums in a course with ids, availability, posting rules and unread counts. Use the returned forumId with the other discussion tools.
Inputs: courseId (required).
bb_list_group_membersList group membersCRead-only
List members of one group.
Inputs: groupId (required), courseId (required).
bb_list_groupsList groupsARead-only
List the groups in a course, including your memberships, group sets, sign-up availability and member counts.
Inputs: courseId (required).
bb_list_rosterList course membersARead-only
List enrollments and roles for a course. Instructors and authorized staff see the full roster; students see what Blackboard exposes.
Inputs: courseId (required), role.
bb_list_rubricsList rubricsCRead-only
List rubrics available in a course.
Inputs: courseId (required).
bb_list_termsList termsBRead-only
List academic terms configured on the Blackboard instance.
Inputs: no named parameters.
bb_message_summaryMessage unread summaryARead-only
Unread message counts for every course, without opening each course. Useful for "do I have messages?" questions.
Inputs: no named parameters.
bb_raw_requestRaw Blackboard API requestA
Escape hatch: call any Blackboard API path on the configured instance, for operations not covered by a dedicated tool. GET is always allowed; POST/PUT/PATCH/DELETE require BB_ALLOW_WRITES=1 and confirm:true. Returns the parsed JSON response.
Inputs: path (required), body, query, method, +1 more.
bb_read_linkRead a link posted in a courseARead-only
Read a professor-posted course or announcement link. Supports Google Docs/Slides/Sheets exports, Drive files, Colab notebooks, web pages, PDFs, video captions when exposed and YouTube metadata. Requires a link present in the specified Blackboard course. Protected sites may need CLI connect. Text is paginated; limitations are explicit.
Inputs: url (required), courseId (required), offset, pageSize, +2 more.
bb_remove_memberRemove a memberADestructive
Remove an enrollment from a course. Requires BB_ALLOW_WRITES=1, confirm:true and course management permission.
Inputs: userId (required), courseId (required), confirm.
bb_reply_messageReply to conversationB
Reply in an existing conversation. Requires BB_ALLOW_WRITES=1 and confirm:true.
Inputs: body (required), courseId (required), conversationId (required), confirm.
bb_reply_to_discussionReply to discussion threadB
Reply to an existing discussion post. Requires BB_ALLOW_WRITES=1 and confirm:true.
Inputs: body (required), forumId (required), courseId (required), messageId (required), +2 more.
bb_send_messageSend course messageA
Start a new conversation with one or more course participants. Requires BB_ALLOW_WRITES=1 and confirm:true.
Inputs: body (required), courseId (required), participantIds (required), confirm, +1 more.
bb_set_assignment_deadlineChange assignment deadlineAIdempotent
Update an assignment due date on its gradebook column. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role.
Inputs: dueDate (required), columnId (required), courseId (required), confirm.
bb_set_content_visibilityShow or hide contentAIdempotent
Change content visibility for students. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor/designer role.
Inputs: visible (required), courseId (required), contentId (required), confirm.
bb_set_grade_exceptionGrant extension or exemptionBIdempotent
Set a per-student exception (deadline extension or exemption) on a column. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role.
Inputs: userId (required), columnId (required), courseId (required), exempt, +2 more.
bb_submit_assignmentSubmit assignmentADestructive
Submit work to an assignment: creates an attempt, uploads files, and posts it for grading. Requires BB_ALLOW_WRITES=1 and confirm:true. Experimental: verify the attempt in Blackboard after the first use.
Inputs: courseId (required), contentId (required), text, confirm, +1 more.
bb_update_announcementUpdate announcementAIdempotent
Edit an announcement title or body. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role.
Inputs: courseId (required), announcementId (required), body, title, +1 more.
bb_update_calendar_eventUpdate personal calendar eventAIdempotent
Update an event you created (personal calendar only). Requires BB_ALLOW_WRITES=1 and confirm:true.
Inputs: itemId (required), title, confirm, endDate, +3 more.
bb_update_contentUpdate content itemAIdempotent
Update a content item title, body or visibility. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor/designer role.
Inputs: courseId (required), contentId (required), body, title, +2 more.
bb_update_member_roleChange member roleAIdempotent
Change a member's course role. Requires BB_ALLOW_WRITES=1, confirm:true and course management permission.
Inputs: role (required), userId (required), courseId (required), confirm.
bb_update_profileUpdate my profileAIdempotent
Update editable profile fields. Blackboard only permits fields flagged in editableFields (often just title). Requires BB_ALLOW_WRITES=1 and confirm:true.
Inputs: title, confirm, givenName, familyName, +1 more.
bb_upload_group_fileUpload group fileA
Upload a file to a group file area. Requires BB_ALLOW_WRITES=1 and confirm:true. Experimental: depends on the group tool being enabled.
Inputs: groupId (required), courseId (required), filePath (required), confirm.
bb_whoamiWho am IARead-only
Return the signed-in Blackboard user, the API surface in use, and session health. Start here to confirm authentication.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 69 tools
Several clusters overlap heavily: bb_get_course_content, bb_list_content, bb_browse_course and bb_get_content all browse the same course outline; bb_list_column_attempts and bb_get_assignment_submission both list attempts on a gradebook column; and bb_list_assignments, bb_list_assessments, bb_get_gradebook and bb_get_my_grades overlap around assignments and grades. Descriptions add nuance, but an agent can still easily choose the wrong tool in these clusters.
Almost all tools use the bb_ prefix with snake_case verb_noun names, such as bb_list_courses, bb_get_assignment and bb_create_announcement. There are minor deviations like bb_whoami, bb_message_summary and bb_raw_request, and similar concepts are named inconsistently (bb_list_column_attempts vs bb_get_assignment_submission), but the pattern is largely predictable.
Sixty-nine tools is far beyond the 50-tool threshold and is excessive for a Blackboard MCP surface, especially with a bb_raw_request escape hatch available. Many tools cluster around the same resources, suggesting the set should have been consolidated into fewer, more general operations.
The surface covers a very broad LMS domain: courses, content, assignments, assessments, gradebook, discussions, messages, groups, calendar, announcements, roster and profile. Some lifecycle gaps remain, such as no clear update/delete for assignments or assessments beyond deadline changes and limited group lifecycle operations, but bb_raw_request provides a workaround for many missing operations.
Maintenance
Related MCP Connectors
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Connect a user's Google Calendar, Gmail, Drive, Notion or Slack so your agent reads their data.
Connect authorized ad accounts to AI assistants for audits, reporting, and approval-gated changes.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with D2L Brightspace LMS, providing access to assignments, grades, course content, calendar events, and announcements through automated SSO authentication.1213 npm12MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to read a student's own Blackboard (Ultra) data—courses, assignments, grades, announcements, and attachments—through their existing logged-in browser session, read-only and locally.1043 npm9MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to access IE Connects community and Blackboard coursework through guided local sign-in, with tools for classes, events, deadlines, grades, and more.34MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to access and manage academic course information, assignments, submissions, grades, calendars, materials, recordings, and announcements through authenticated LMS sessions.MIT