Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
BB_URLNoBlackboard instance origin. Defaults to https://uaeu.blackboard.com.
BB_COOKIENoCookie header for non-interactive login.
BB_LOG_LEVELNoLog level. Valid values are silent, error, warn, info, and debug.
BB_PAGE_SIZENoDefault list page size, from 1 to 200. Defaults to 50.
BB_STATE_DIRNoSession state directory. Defaults to %USERPROFILE%\.uaeu-blackboard-mcp.
BB_TIMEOUT_MSNoTotal timeout per HTTP request including retries and backoff. Defaults to 30000.
BB_CONCURRENCYNoNumber of parallel outline folder reads, from 1 to 8. Defaults to 4.
BB_ALLOW_WRITESNoSet 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_MSNoIdentity, membership and outline cache lifetime. Defaults to 15000; set to 0 to disable caching.
BB_DOWNLOAD_DIRNoDirectory 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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

ActivityNo data
ResponsivenessOutdated data