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/mcpThe 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, plusreport_problemfor every token - Prompts:
5 - Runtime: Cloudflare Worker
- Authentication: Better Auth OAuth client credentials
- Tenant authority:
organization_idtoken claim - Error behavior: validation and REST 4xx failures return MCP tool errors; REST 5xx, timeouts, and network failures return protocol errors.
Courses
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_courses | Read | courses:read | read-only |
get_course | Read | courses:read | read-only |
save_course | Write | courses:write | non-destructive, idempotent |
delete_course | Write | courses:manage | destructive, idempotent |
set_course_status | Write | courses:manage | destructive, idempotent |
list_course_modules | Read | courses:read | read-only |
get_module | Read | courses:read | read-only |
save_module | Write | courses:write | non-destructive, idempotent |
delete_module | Write | courses:write | destructive, idempotent |
list_categories | Read | courses:read | read-only |
search_course_content | Read | courses:read | read-only |
start_course_generation | Write | ai:manage | non-destructive, idempotent |
get_course_generation | Read | ai:manage | read-only |
cancel_course_generation | Write | ai:manage | destructive, idempotent |
Course Builder
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_cb_blocks | Read | courses:read | read-only |
edit_cb_block | Write | courses:write | destructive, idempotent |
Users
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_users | Read | people:read | read-only |
get_user | Read | people:read | read-only |
save_user | Write | people:write | non-destructive, idempotent |
archive_user | Write | people:manage | destructive, idempotent |
bulk_user_operation | Write | people:write | non-destructive, idempotent |
set_user_custom_fields | Write | people:write | non-destructive, idempotent |
list_roles | Read | people:read | read-only |
Progress
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
get_user_progress | Read | enrollments:read | read-only |
get_enrollment_progress | Read | enrollments:read | read-only |
Groups
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_groups | Read | people:read | read-only |
get_group | Read | people:read | read-only |
save_group | Write | people:write | non-destructive, idempotent |
delete_group | Write | people:manage | destructive, idempotent |
set_group_members | Write | people:write | destructive, idempotent |
Enrollments
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_enrollments | Read | enrollments:read | read-only |
get_enrollment | Read | enrollments:read | read-only |
save_enrollment | Write | enrollments:write | non-destructive, idempotent |
withdraw_enrollment | Write | enrollments:manage | destructive, idempotent |
Learning Paths
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_learning_paths | Read | courses:read | read-only |
get_learning_path | Read | courses:read | read-only |
save_learning_path | Write | courses:write | non-destructive, idempotent |
delete_learning_path | Write | courses:manage | destructive, idempotent |
set_path_status | Write | courses:manage | destructive, idempotent |
list_path_nodes | Read | courses:read | read-only |
save_path_node | Write | courses:write | non-destructive, idempotent |
delete_path_node | Write | courses:write | destructive, idempotent |
list_path_deps | Read | courses:read | read-only |
list_path_enrollments | Read | courses:read | read-only |
get_path_enrollment | Read | courses:read | read-only |
save_path_enrollment | Write | enrollments:write | non-destructive, idempotent |
Exams
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_exams | Read | assessments:read | read-only |
get_exam | Read | assessments:read | read-only |
save_exam | Write | assessments:write | non-destructive, idempotent |
delete_exam | Write | assessments:manage | destructive, idempotent |
publish_exam | Write | assessments:manage | non-destructive, idempotent |
Questions
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_question_banks | Read | assessments:read | read-only |
save_question_bank | Write | assessments:write | non-destructive, idempotent |
delete_question_bank | Write | assessments:manage | destructive, idempotent |
list_questions | Read | assessments:read | read-only |
save_question | Write | assessments:write | non-destructive, idempotent |
delete_question | Write | assessments:manage | destructive, idempotent |
Exam Attempts
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_exam_attempts | Read | assessments:read | read-only |
get_exam_attempt | Read | assessments:read | read-only |
get_attempt_responses | Read | assessments:read | read-only |
Grading
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_exam_grading_queue | Read | assessments:read | read-only |
grade_exam_response | Write | assessments:write | non-destructive, idempotent |
list_rubrics | Read | assessments:read | read-only |
create_rubric | Write | assessments:write | non-destructive, idempotent |
save_rubric_criterion | Write | assessments:write | non-destructive, idempotent |
delete_rubric_criterion | Write | assessments:manage | destructive, idempotent |
Certifications
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_certificates | Read | courses:read | read-only |
get_certificate | Read | courses:read | read-only |
list_cert_issuances | Read | courses:read | read-only |
issue_certificate | Write | courses:manage | non-destructive, idempotent |
revoke_certificate | Write | courses:manage | destructive, idempotent |
Live Learning
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_live_sessions | Read | courses:read | read-only |
get_live_session | Read | courses:read | read-only |
save_live_session | Write | courses:write | non-destructive, idempotent |
cancel_live_session | Write | courses:write | destructive, idempotent |
list_live_attendance | Read | courses:read | read-only |
Reports
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
list_reports | Read | analytics:read | read-only |
start_report_job | Write | analytics:write | non-destructive, idempotent |
get_report_job | Read | analytics:read | read-only |
download_report | Read | analytics:read | read-only |
Analytics
| Tool | Kind | Scopes | Hints |
|---|---|---|---|
get_analytics | Read | analytics:read | read-only |
Prompts
| Prompt | Description |
|---|---|
onboard_new_hire_cohort | Create accounts for a cohort of new hires, put them in one group, and enroll each of them in an onboarding learning path. |
assign_compliance_training | Enroll every member of a group in a compliance course, then produce a completion report for that course. |
find_learners_behind | List the active enrollments in a course and flag learners whose progress is below a threshold. |
grade_exam_queue | Work through exam responses that wait for manual grading and record a score and feedback for each. |
publish_course_after_review | Review the modules of a course for gaps, then publish the course when the review passes. |