Skip to main content

Blackboard MCP Server Tool Guide

Item

Detail

Last updated

13 November 2026

Catalog

40 tools: 20 read, 20 write, no delete

Update schedule

Blackboard adds and updates tools continuously, outside the monthly Blackboard LMS release. This page always shows the current catalog. See What's changed at the end.

How to read this guide

You don't call these tools by name. You describe what you want, and the AI model behind your assistant picks the right tool. The names help you predict what it will do and tell your AI tool administrator which tools to put behind an approval.

  • You act as yourself. Every tool runs with your Blackboard LMS role and permissions. Tools for instructors or administrators only work if your account has that role in the course or system.

  • Read tools return information and change nothing. Write tools create or change data in Blackboard LMS. Nothing in the catalog deletes.

Important

Where to put a person in the loop. Let read tools run under your AI tool's automatic screening. Require a person to approve write tools, and check the scope of every bulk tool before you approve it.

For everyone

Tool

What it does

Type

identity

Shows who you are signed in as in Blackboard LMS. Good for checking your connection.

Read

get_my_courses

Lists the courses you're enrolled in.

Read

get_my_assignments

Lists your assignments and their submission status. Without a course, it checks all your active courses.

Read

Try: "Who am I signed in as?" "Show me everything I still need to submit, and when it's due."

For instructors and designers

Engagement and rosters

Tool

What it does

Type

get_unsubmitted_students

Lists students with at least one unsubmitted assignment in a course.

Read

get_enrollments_by_course

Lists everyone enrolled in a course.

Read

get_course_roles

Lists the course roles available, built-in and custom.

Read

Announcements and discussions

Tool

What it does

Type

get_course_announcements

Lists the announcements in a course.

Read

create_course_announcement

Posts a new announcement in a course.

Write

patch_course_announcement

Updates an existing announcement.

Write

get_discussions

Lists the discussions in a course.

Read

create_discussion

Creates a new discussion in a course.

Write

update_discussion

Updates an existing discussion.

Write

Course content

Tool

What it does

Type

get_course_contents

Lists the items at one level of a course, or inside a folder. The assistant walks deeper one level at a time.

Read

get_content

Reads one item, including the text of a document.

Read

get_content_attachments

Lists the files attached to an uploaded-file item, by name and type.

Read

get_content_attachment

Shows the name and type of one attached file.

Read

create_content

Creates a folder, a document or a link. To hold documents, the assistant creates a page folder first.

Write

patch_content

Updates an item's title, text, availability, position or link address.

Write

  • Tests, assignments, learning modules and uploaded files can be read but not created.

  • Attached files are listed by name and type. Their contents can't be read, downloaded or uploaded.

  • When it edits a document, the assistant reads the full formatted version first so headings, tables and embedded images are kept.

Try: "Which students haven't submitted the midterm essay in BIO-201?" "What's in the Week 1 folder of my ethics course? Is anything hidden from students?" "Draft a reminder announcement and show it to me before you post it."

For administrators

Courses

Tool

What it does

Type

get_all_courses

Lists courses, filtered by fields such as term or availability.

Read

search_courses

Searches the course catalog by name.

Read

create_course

Creates a course. Needs a course ID and a name.

Write

patch_course_by_id

Updates a course, for example its name, term or availability.

Write

copy_course

Copies an existing course into a new one.

Write

Users

Tool

What it does

Type

get_all_users

Lists users, filtered by exact values.

Read

get_user_by_id

Looks up one user.

Read

search_users

Searches users by username or last name.

Read

create_user

Creates a user account.

Write

update_user_by_id

Updates a user account.

Write

Enrollments

Tool

What it does

Type

get_enrollments_by_user

Lists every course a user is enrolled in.

Read

enroll_student

Enrolls a user in a course as a student.

Write

enroll_user_in_course

Enrolls a user in a course with the role you choose.

Write

Terms

Tool

What it does

Type

search_terms

Searches terms by name.

Read

get_term_by_id

Looks up one term.

Read

create_term

Creates a term, such as a semester or session.

Write

update_term_by_id

Updates a term.

Write

Bulk setup and testing

Caution

Use with care. Bulk tools create many records at once and are meant for setting up test sites or batch provisioning. Each request is capped at 100 items. Check the scope before you approve.

Tool

What it does

Type

create_bulk_users

Creates many user accounts at once.

Write

create_bulk_courses

Creates many courses at once.

Write

create_bulk_enrollments

Enrolls a range of users into a range of courses. Every user in the range goes into every course in the range.

Write

create_bulk_announcements

Creates many announcements at once.

Write

create_bulk_discussions

Creates many discussions at once.

Write

Try: "Find jdoe and list their enrollments." "Create a Spring 2027 term running January through May." "Copy BIO-101-MASTER into a new sandbox course and enroll me as instructor."

Read and write at a glance

Area

Read: let these run

Write: require approval

You

identity, get_my_courses, get_my_assignments

None

Engagement and rosters

get_unsubmitted_students, get_enrollments_by_course, get_course_roles

None

Communication

get_course_announcements, get_discussions

Create and update announcements and discussions

Content

get_course_contents, get_content, get_content_attachments, get_content_attachment

create_content, patch_content

Courses

get_all_courses, search_courses

create_course, patch_course_by_id, copy_course

Users

get_all_users, get_user_by_id, search_users

create_user, update_user_by_id

Enrollments

get_enrollments_by_user

enroll_student, enroll_user_in_course

Terms

search_terms, get_term_by_id

create_term, update_term_by_id

Bulk

None

All five create_bulk_* tools

Delete

None

None. There are no delete tools.

What's changed

Date

Change

December 2026

Initial release with the Blackboard LMS release 4001.7. 40 tools.