UAEU Blackboard MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BB_URL | No | Blackboard instance origin. Defaults to https://uaeu.blackboard.com. | |
| BB_COOKIE | No | Cookie header for non-interactive login. | |
| BB_LOG_LEVEL | No | Log level. Valid values are silent, error, warn, info, and debug. | |
| BB_PAGE_SIZE | No | Default list page size, from 1 to 200. Defaults to 50. | |
| BB_STATE_DIR | No | Session state directory. Defaults to %USERPROFILE%\.uaeu-blackboard-mcp. | |
| BB_TIMEOUT_MS | No | Total timeout per HTTP request including retries and backoff. Defaults to 30000. | |
| BB_CONCURRENCY | No | Number of parallel outline folder reads, from 1 to 8. Defaults to 4. | |
| BB_ALLOW_WRITES | No | Set to 1 to enable write tools. Write tools still require confirm: true. Without this flag the server is read-only and refuses every write action. | |
| BB_CACHE_TTL_MS | No | Identity, membership and outline cache lifetime. Defaults to 15000; set to 0 to disable caching. | |
| BB_DOWNLOAD_DIR | No | Directory where downloaded files are saved. Defaults to Downloads/blackboard. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| bb_whoamiA | Return the signed-in Blackboard user, the API surface in use, and session health. Start here to confirm authentication. |
| bb_list_coursesA | 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. |
| bb_get_courseA | Get one course by its internal id (e.g. _12345_1). Returns name, code, description, term, availability and enrolment settings. |
| bb_list_termsB | List academic terms configured on the Blackboard instance. |
| bb_list_assignmentsA | 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. |
| bb_get_assignmentB | Get one assignment: instructions, rubric hint, deadline, points, attempts allowed, submission status, your score, and any attached files. |
| bb_get_assignment_submissionB | List attempts and submission files on a gradebook column. Students see their own attempts; instructors see every attempt. |
| bb_submit_assignmentA | 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. |
| bb_list_discussionsA | List discussion forums in a course with ids, availability, posting rules and unread counts. Use the returned forumId with the other discussion tools. |
| bb_get_discussionB | Read the threads (top-level posts) in a discussion forum, with authors, bodies and reply counts. |
| bb_get_discussion_threadC | Read every reply to one discussion thread. |
| bb_create_discussion_threadB | Start a new thread in a forum where students may create threads. Requires BB_ALLOW_WRITES=1 and confirm:true. |
| bb_reply_to_discussionB | Reply to an existing discussion post. Requires BB_ALLOW_WRITES=1 and confirm:true. |
| bb_edit_discussion_postA | Edit a post you authored, where the forum allows edits. Requires BB_ALLOW_WRITES=1 and confirm:true. |
| bb_delete_discussion_postB | Delete a post you authored, where the forum allows deletion. Requires BB_ALLOW_WRITES=1 and confirm:true. |
| bb_list_conversationsC | List course message conversations with unread counts and participants. |
| bb_get_conversationC | Read every message in a conversation. |
| bb_message_summaryA | Unread message counts for every course, without opening each course. Useful for "do I have messages?" questions. |
| bb_send_messageA | Start a new conversation with one or more course participants. Requires BB_ALLOW_WRITES=1 and confirm:true. |
| bb_reply_messageB | Reply in an existing conversation. Requires BB_ALLOW_WRITES=1 and confirm:true. |
| bb_find_recipientsA | Search the participants of a course so you can obtain the user ids needed by bb_send_message. |
| bb_list_calendarA | List calendar items and deadlines in a date range (ISO 8601). Includes graded activity due dates and your personal events. |
| bb_create_calendar_eventA | Create an event on your personal Blackboard calendar. Requires BB_ALLOW_WRITES=1 and confirm:true. |
| bb_update_calendar_eventA | Update an event you created (personal calendar only). Requires BB_ALLOW_WRITES=1 and confirm:true. |
| bb_delete_calendar_eventA | Delete an event you created. Requires BB_ALLOW_WRITES=1 and confirm:true. |
| bb_list_groupsA | List the groups in a course, including your memberships, group sets, sign-up availability and member counts. |
| bb_get_groupB | Get one group with its members and shared resources. |
| bb_list_group_membersC | List members of one group. |
| bb_join_groupA | 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. |
| bb_upload_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. |
| bb_get_profileA | Return your profile: name, username, email, student id, avatar and which fields your account may edit. |
| bb_update_profileA | Update editable profile fields. Blackboard only permits fields flagged in editableFields (often just title). Requires BB_ALLOW_WRITES=1 and confirm:true. |
| bb_get_notification_prefsA | Read your Ultra notification and email preferences. Experimental: the internal endpoint varies by Learn release. |
| bb_list_contentA | 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. |
| bb_browse_courseB | Recursively flatten the entire course outline (modules, folders and items) with ids, handlers and visibility. |
| bb_get_contentA | Get one content item with its body text, file metadata, posted links, due date and permissions. Read file contents with bb_get_attachment. |
| bb_create_moduleA | Create a module/folder in the course outline. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor/designer role. |
| bb_create_pageA | Create a content page with HTML body inside a module/folder. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor/designer role. |
| bb_update_contentA | Update a content item title, body or visibility. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor/designer role. |
| bb_set_content_visibilityA | Change content visibility for students. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor/designer role. |
| bb_delete_contentA | Delete a content item. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor/designer role. |
| bb_list_announcementsB | List course announcements, newest first, with bodies and read state. |
| bb_create_announcementA | Create a course announcement, optionally scheduled with start/end dates. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role. |
| bb_update_announcementA | Edit an announcement title or body. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role. |
| bb_delete_announcementA | Delete an announcement. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role. |
| bb_list_assessmentsA | List graded assessments (assignments, tests) in a course with type, due date, points, attempts and visibility. |
| bb_get_assessmentB | Get one assessment (gradebook column + linked content + questions when available). |
| bb_create_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. |
| bb_set_assignment_deadlineA | Update an assignment due date on its gradebook column. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role. |
| bb_list_rubricsC | List rubrics available in a course. |
| bb_attach_rubricA | Associate a rubric with a gradebook column. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role. |
| bb_get_gradebookA | Return gradebook columns plus your own grades for a course. Instructors also see every column and its scoring settings. |
| bb_get_my_gradesB | Return your grades for one course, with points possible and submission state. |
| bb_list_column_attemptsB | List attempts on a gradebook column. Students see their own; instructors see all students. |
| bb_get_attemptB | Get one submission attempt, including files, receipt and submission text. |
| bb_grade_submissionA | Enter or change a grade and feedback for one student on a column. Requires BB_ALLOW_WRITES=1, confirm:true and a grading role. |
| bb_set_grade_exceptionB | Set a per-student exception (deadline extension or exemption) on a column. Requires BB_ALLOW_WRITES=1, confirm:true and an instructor role. |
| bb_list_rosterA | List enrollments and roles for a course. Instructors and authorized staff see the full roster; students see what Blackboard exposes. |
| bb_add_memberA | Enroll a user in a course with a role. Requires BB_ALLOW_WRITES=1, confirm:true and course management permission. |
| bb_update_member_roleA | Change a member's course role. Requires BB_ALLOW_WRITES=1, confirm:true and course management permission. |
| bb_remove_memberA | Remove an enrollment from a course. Requires BB_ALLOW_WRITES=1, confirm:true and course management permission. |
| bb_raw_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. |
| bb_list_attachmentsA | 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. |
| bb_get_attachmentA | 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. |
| bb_read_linkA | 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. |
| bb_get_assignment_contextA | 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. |
| bb_get_course_contentB | 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. |
| bb_get_upcoming_workA | 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. |
| bb_get_recent_updatesB | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.