Skip to main content
Glama

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

Coverage

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

The local connector also provides these read-only tools:

Tool

Purpose

bb_get_course_content

Find files and posted links across the outline, with created/modified dates

bb_list_attachments

Resolve downloadable files attached to a content item

bb_get_attachment

Download a file and return its extracted text, saved path and limitations

bb_read_link

Read a link posted in the specified course content or announcement

bb_get_upcoming_work

Combine upcoming deadlines and recently overdue work across courses

bb_get_recent_updates

Combine changed content, announcements, assignments and grades on changed columns

bb_get_assignment_context

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 zoom

The 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 login

Complete 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 --global

On 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 --global

To 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-mcp

On 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-mcp

Check 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-mcp

On 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 surface

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

  1. BB_ALLOW_WRITES=1 in the server environment, and

  2. confirm: true in 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

BB_URL

Instance origin, default https://uaeu.blackboard.com

BB_ALLOW_WRITES

1 enables write tools (still require confirm: true)

BB_STATE_DIR

Session directory, default %USERPROFILE%\.uaeu-blackboard-mcp

BB_PAGE_SIZE

Default list page size, 1–200, default 50

BB_TIMEOUT_MS

Total timeout per HTTP request including retries and backoff, default 30000

BB_CACHE_TTL_MS

Identity, membership and outline cache lifetime, default 15000; 0 disables caching

BB_CONCURRENCY

Parallel outline folder reads, default 4; range 1–8

BB_LOG_LEVEL

silent, error, warn, info, debug

BB_COOKIE

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_whoami are fresh reads by default.

  • Course traversal reads up to BB_CONCURRENCY folders 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_assignments defaults to 50 summaries without instruction bodies; pass limit, offset, or includeInstructions: true as needed. Responses expose total and nextOffset so more results can be requested explicitly.

  • bb_get_assignment returns its normalized details; use includeRaw: true for the full original response. bb_list_content accepts limit, offset and includeDescriptions: true, and returns continuation information. bb_browse_course accepts limit/offset with total/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 the BbRouter session 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_request is 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 doctor

Source 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 area

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 tools
bb_add_memberEnroll a memberA
Idempotent

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 assessmentA
Idempotent

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 outlineB
Read-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 announcementA
Destructive

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 eventA
Destructive

Delete an event you created. Requires BB_ALLOW_WRITES=1 and confirm:true.

Inputs: itemId (required), confirm.

bb_delete_contentDelete content itemA
Destructive

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 postB
Destructive

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 postA
Idempotent

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 recipientsA
Read-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 settingsB
Read-only

Get one assessment (gradebook column + linked content + questions when available).

Inputs: columnId (required), courseId (required).

bb_get_assignmentGet assignment detailsB
Read-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 contextA
Read-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 submissionsB
Read-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 contentsA
Read-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 detailB
Read-only

Get one submission attempt, including files, receipt and submission text.

Inputs: courseId (required), attemptId (required).

bb_get_contentGet content itemA
Read-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 conversationC
Read-only

Read every message in a conversation.

Inputs: courseId (required), conversationId (required).

bb_get_courseGet courseA
Read-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 linksB
Read-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 threadsB
Read-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 repliesC
Read-only

Read every reply to one discussion thread.

Inputs: forumId (required), courseId (required), messageId (required), boardId.

bb_get_gradebookGet gradebookA
Read-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 groupB
Read-only

Get one group with its members and shared resources.

Inputs: groupId (required), courseId (required).

bb_get_my_gradesGet my gradesB
Read-only

Return your grades for one course, with points possible and submission state.

Inputs: courseId (required).

bb_get_notification_prefsGet notification preferencesA
Read-only

Read your Ultra notification and email preferences. Experimental: the internal endpoint varies by Learn release.

Inputs: no named parameters.

bb_get_profileGet my profileA
Read-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 updatesB
Read-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 coursesA
Read-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 submissionA
Idempotent

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 groupA
Idempotent

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 announcementsB
Read-only

List course announcements, newest first, with bodies and read state.

Inputs: courseId (required), limit.

bb_list_assessmentsList assessmentsA
Read-only

List graded assessments (assignments, tests) in a course with type, due date, points, attempts and visibility.

Inputs: courseId (required).

bb_list_assignmentsList assignmentsA
Read-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 filesA
Read-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 calendarA
Read-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 attemptsB
Read-only

List attempts on a gradebook column. Students see their own; instructors see all students.

Inputs: columnId (required), courseId (required).

bb_list_contentList course contentA
Read-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 conversationsC
Read-only

List course message conversations with unread counts and participants.

Inputs: courseId (required), limit.

bb_list_coursesList my coursesA
Read-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 discussionsA
Read-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 membersC
Read-only

List members of one group.

Inputs: groupId (required), courseId (required).

bb_list_groupsList groupsA
Read-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 membersA
Read-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 rubricsC
Read-only

List rubrics available in a course.

Inputs: courseId (required).

bb_list_termsList termsB
Read-only

List academic terms configured on the Blackboard instance.

Inputs: no named parameters.

bb_message_summaryMessage unread summaryA
Read-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_remove_memberRemove a memberA
Destructive

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 deadlineA
Idempotent

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 contentA
Idempotent

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 exemptionB
Idempotent

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 assignmentA
Destructive

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 announcementA
Idempotent

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 eventA
Idempotent

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 itemA
Idempotent

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 roleA
Idempotent

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 profileA
Idempotent

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 IA
Read-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

    B3.1/5.0

    Scored across 69 tools

    Disambiguation2/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers