Built LMS Help Center
MCP Server

MCP Server

Connect customer-backend agents to Built LMS through the hosted MCP server.

MCP Server

Built LMS exposes a hosted Streamable HTTP MCP server for customer-backend agents at:

https://mcp.builtlms.com/mcp

The MCP server wraps the public REST API. Every listed tool maps to a public/v1 REST sibling, and tool discovery is filtered by OAuth scopes, the agent's toolsets, and active kill switches. An administrator can limit an agent to some toolsets (tool domains) when registering it; a call to a tool outside them returns a tool error.

Current Surface

  • Tools: 81, plus report_problem for every token
  • Prompts: 5
  • Runtime: Cloudflare Worker
  • Authentication: Better Auth OAuth client credentials
  • Tenant authority: organization_id token claim
  • Error behavior: validation and REST 4xx failures return MCP tool errors; REST 5xx, timeouts, and network failures return protocol errors.

Courses

ToolKindScopesHints
list_coursesReadcourses:readread-only
get_courseReadcourses:readread-only
save_courseWritecourses:writenon-destructive, idempotent
delete_courseWritecourses:managedestructive, idempotent
set_course_statusWritecourses:managedestructive, idempotent
list_course_modulesReadcourses:readread-only
get_moduleReadcourses:readread-only
save_moduleWritecourses:writenon-destructive, idempotent
delete_moduleWritecourses:writedestructive, idempotent
list_categoriesReadcourses:readread-only
search_course_contentReadcourses:readread-only
start_course_generationWriteai:managenon-destructive, idempotent
get_course_generationReadai:manageread-only
cancel_course_generationWriteai:managedestructive, idempotent

Course Builder

ToolKindScopesHints
list_cb_blocksReadcourses:readread-only
edit_cb_blockWritecourses:writedestructive, idempotent

Users

ToolKindScopesHints
list_usersReadpeople:readread-only
get_userReadpeople:readread-only
save_userWritepeople:writenon-destructive, idempotent
archive_userWritepeople:managedestructive, idempotent
bulk_user_operationWritepeople:writenon-destructive, idempotent
set_user_custom_fieldsWritepeople:writenon-destructive, idempotent
list_rolesReadpeople:readread-only

Progress

ToolKindScopesHints
get_user_progressReadenrollments:readread-only
get_enrollment_progressReadenrollments:readread-only

Groups

ToolKindScopesHints
list_groupsReadpeople:readread-only
get_groupReadpeople:readread-only
save_groupWritepeople:writenon-destructive, idempotent
delete_groupWritepeople:managedestructive, idempotent
set_group_membersWritepeople:writedestructive, idempotent

Enrollments

ToolKindScopesHints
list_enrollmentsReadenrollments:readread-only
get_enrollmentReadenrollments:readread-only
save_enrollmentWriteenrollments:writenon-destructive, idempotent
withdraw_enrollmentWriteenrollments:managedestructive, idempotent

Learning Paths

ToolKindScopesHints
list_learning_pathsReadcourses:readread-only
get_learning_pathReadcourses:readread-only
save_learning_pathWritecourses:writenon-destructive, idempotent
delete_learning_pathWritecourses:managedestructive, idempotent
set_path_statusWritecourses:managedestructive, idempotent
list_path_nodesReadcourses:readread-only
save_path_nodeWritecourses:writenon-destructive, idempotent
delete_path_nodeWritecourses:writedestructive, idempotent
list_path_depsReadcourses:readread-only
list_path_enrollmentsReadcourses:readread-only
get_path_enrollmentReadcourses:readread-only
save_path_enrollmentWriteenrollments:writenon-destructive, idempotent

Exams

ToolKindScopesHints
list_examsReadassessments:readread-only
get_examReadassessments:readread-only
save_examWriteassessments:writenon-destructive, idempotent
delete_examWriteassessments:managedestructive, idempotent
publish_examWriteassessments:managenon-destructive, idempotent

Questions

ToolKindScopesHints
list_question_banksReadassessments:readread-only
save_question_bankWriteassessments:writenon-destructive, idempotent
delete_question_bankWriteassessments:managedestructive, idempotent
list_questionsReadassessments:readread-only
save_questionWriteassessments:writenon-destructive, idempotent
delete_questionWriteassessments:managedestructive, idempotent

Exam Attempts

ToolKindScopesHints
list_exam_attemptsReadassessments:readread-only
get_exam_attemptReadassessments:readread-only
get_attempt_responsesReadassessments:readread-only

Grading

ToolKindScopesHints
list_exam_grading_queueReadassessments:readread-only
grade_exam_responseWriteassessments:writenon-destructive, idempotent
list_rubricsReadassessments:readread-only
create_rubricWriteassessments:writenon-destructive, idempotent
save_rubric_criterionWriteassessments:writenon-destructive, idempotent
delete_rubric_criterionWriteassessments:managedestructive, idempotent

Certifications

ToolKindScopesHints
list_certificatesReadcourses:readread-only
get_certificateReadcourses:readread-only
list_cert_issuancesReadcourses:readread-only
issue_certificateWritecourses:managenon-destructive, idempotent
revoke_certificateWritecourses:managedestructive, idempotent

Live Learning

ToolKindScopesHints
list_live_sessionsReadcourses:readread-only
get_live_sessionReadcourses:readread-only
save_live_sessionWritecourses:writenon-destructive, idempotent
cancel_live_sessionWritecourses:writedestructive, idempotent
list_live_attendanceReadcourses:readread-only

Reports

ToolKindScopesHints
list_reportsReadanalytics:readread-only
start_report_jobWriteanalytics:writenon-destructive, idempotent
get_report_jobReadanalytics:readread-only
download_reportReadanalytics:readread-only

Analytics

ToolKindScopesHints
get_analyticsReadanalytics:readread-only

Prompts

PromptDescription
onboard_new_hire_cohortCreate accounts for a cohort of new hires, put them in one group, and enroll each of them in an onboarding learning path.
assign_compliance_trainingEnroll every member of a group in a compliance course, then produce a completion report for that course.
find_learners_behindList the active enrollments in a course and flag learners whose progress is below a threshold.
grade_exam_queueWork through exam responses that wait for manual grading and record a score and feedback for each.
publish_course_after_reviewReview the modules of a course for gaps, then publish the course when the review passes.

On this page