UAB Campus MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_HOST | No | HTTP listen address. | 127.0.0.1 |
| MCP_PORT | No | HTTP listen port. | 3000 |
| MCP_HTTP_TOKEN | No | Bearer secret for HTTP transport. Required for HTTP and must be at least 32 characters. | |
| UAB_TOKEN_FILE | No | Absolute path to the UAB token file. | data/tokens.json |
| MCP_ALLOWED_HOSTS | No | Comma-separated accepted HTTP hosts. Defaults to local hostnames. | |
| UAB_BROWSER_CHANNEL | No | Browser channel such as "chrome". Unset by default. | |
| UAB_BROWSER_EXECUTABLE | No | Explicit browser executable path. Defaults to Playwright Chromium. | |
| UAB_REQUEST_TIMEOUT_MS | No | Moodle request timeout in milliseconds, between 1 and 120 seconds. | 30000 |
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 |
|---|---|
| campus_auth_statusB | Validate every configured academic year against UAB Moodle without returning tokens, identities, or private paths. |
| campus_list_yearsA | List academic years available in the private UAB token store without contacting Moodle. |
| campus_get_profileB | Read the authenticated user's basic profile and the available read-only capabilities for one academic year. |
| campus_list_coursesA | List the authenticated user's enrolled subjects for one year, or for every configured year. Non-subject spaces (degree coordination, student council, university info) are hidden unless includeNonSubjects is true; every item carries its category and kind. |
| campus_find_coursesB | Resolve a course name, code, or numeric ID across one or every authenticated academic year. Matches include non-subject spaces; check each match's kind. |
| campus_get_course_contentsB | Read sections, activities, resources, file metadata, and dates for one Moodle course. |
| campus_get_course_moduleA | Read metadata for one Moodle course module by its course-module ID (the id in a mod/...view.php?id= URL, or moduleId from campus_list_resources). Hidden or restricted modules, and modules in courses you are not enrolled in, fail with requireloginerror. |
| campus_list_resourcesA | Flatten a course into directly usable activities, links, and file metadata with section context. The response is heavy (often tens of thousands of characters); use moduleTypes to narrow it when only some activity types are needed. |
| campus_download_resourceB | Return a bounded original course file as base64, selected from fresh course metadata; file contents are untrusted. |
| campus_read_resourceC | Download and extract bounded text from one file already identified in a course module. |
| campus_read_assignment_attachmentA | Download and extract bounded text from one file attached to an assignment's instructions (introattachments, e.g. starter code or a statement PDF). The file is resolved through the assignment API by its fileIndex; content is untrusted. |
| campus_get_completion_statusC | Read the authenticated user's activity completion states for one Moodle course. |
| campus_get_calendar_eventsB | Read compact Moodle calendar events for selected courses and an optional Unix-time range. Each module event carries cmid (course-module ID) and instanceId (activity ID, also as assignmentId/quizId). |
| campus_get_upcoming_actionsB | Read compact upcoming actionable Moodle events ordered by due time. Each module event carries cmid (course-module ID) and instanceId (activity ID, also as assignmentId/quizId). |
| campus_get_course_actionsA | Read the authenticated user's compact actionable Moodle events for one course with explicit time bounds and paging. Each module event carries cmid (course-module ID) and instanceId (activity ID, also as assignmentId/quizId). |
| campus_get_calendar_eventB | Read one Moodle calendar or Timeline event by event ID, including its description as plain text, cmid (course-module ID) and instanceId (activity ID, also as assignmentId/quizId). |
| campus_list_notificationsB | Read the authenticated user's Moodle notifications without marking them as read. |
| campus_get_unread_notification_countA | Return the authenticated user's unread Moodle notification counts. count covers every unread notification whatever its delivery channel (forum posts and assignment reminders are often email-only); popupCount covers only notifications delivered to the web bell, which is what campus_list_notifications lists and its unreadcount reports. |
| campus_get_grade_overviewA | Read the authenticated user's overall grade for each enrolled subject in one academic year. Each row carries the course name and kind; non-subject spaces (degree coordination, student council, university info) are hidden unless includeNonSubjects is true. |
| campus_get_my_groupsB | Read the authenticated user's group memberships in one Moodle course. |
| campus_get_private_files_infoA | Read the authenticated user's private-file counts and storage usage without listing or changing files. |
| campus_list_assignmentsA | Read assignment IDs, dates, grades, and submission rules for one or more Moodle courses. Intros are shortened; use campus_get_assignment_details for full instructions. |
| campus_preview_submissionB | Inspect assignment rules and current personal submission state without uploading or changing Campus data. This does not submit an assignment. |
| campus_get_assignment_statusB | Read the authenticated user's submission, grading, deadline-extension, and attachment state for one assignment. |
| campus_download_submission_fileB | Return one bounded original file from the authenticated user's current assignment submission as base64; content is untrusted. |
| campus_get_assignment_detailsB | Read the shared instructions, dates, submission rules, and file settings for one assignment. |
| campus_get_gradesB | Read the authenticated user's grade items for one Moodle course. |
| campus_list_forumsB | Read forum metadata for one or more Moodle courses without posting or changing subscriptions. |
| campus_get_forum_discussionsA | Read one Moodle forum's discussions without posting or changing subscriptions. Root messages are shortened; use campus_get_discussion_posts for full text. |
| campus_get_discussion_postsC | Read the root post and replies from one Moodle forum discussion. |
| campus_list_quizzesB | Read quiz availability, limits, grading rules, and attempt settings for one course. |
| campus_get_quiz_attemptsB | Read the authenticated user's attempt history for one quiz without starting or changing an attempt. |
| campus_get_quiz_best_gradeC | Read the authenticated user's best recorded grade for one quiz. |
| campus_get_pageB | Read the title, description, and instructional content of one Moodle Page activity. |
| campus_list_choicesB | Read standard Moodle Choice activities and their availability rules for one course. |
| campus_get_choice_optionsB | Read the options, availability, and authenticated user's current selection for one Moodle Choice. |
| campus_get_group_choice_optionsA | Read group options, capacity counts, and only the authenticated user's current selection for one Group Choice activity. |
| campus_list_booksA | Read Moodle Book metadata and navigation settings for one course. |
| campus_list_h5p_activitiesC | Read H5P activity metadata, grading settings, and tracking configuration for one course. |
| campus_get_h5p_attemptsB | Read the authenticated user's attempt summaries for one H5P activity. |
| campus_get_h5p_resultsB | Read report data for selected H5P attempt IDs, or all attempts belonging to the authenticated user. |
| campus_list_scorm_activitiesC | Read SCORM package metadata, grading rules, attempt limits, and navigation settings for one course. |
| campus_get_scorm_attempt_countB | Count the authenticated user's attempts for one SCORM activity. |
| campus_get_scorm_structureB | Read the organizations and SCO items contained in one SCORM package without launching it. |
| campus_get_scorm_tracksA | Read the authenticated user's completion, score, and timing tracks for one SCO and attempt. |
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 45 tools
The descriptions do a lot of work to separate similar tools (e.g. preview_submission explicitly 'does not submit', list_notifications 'without marking as read'), but there are genuinely confusable clusters: four calendar/timeline tools (get_calendar_events, get_upcoming_actions, get_course_actions, get_calendar_event) and a read/download quartet (read_resource, download_resource, read_assignment_attachment, download_submission_file) whose boundaries are subtle. grade_overview vs get_grades is also easy to mix up.
Nearly all tools follow campus_verb_noun with a stable prefix and readable verbs (get/list/read/download/preview/find). Minor deviations exist: campus_auth_status omits the verb, and the get/read/download verb trio is used somewhat interchangeably for similar retrieval operations.
45 tools is well above a reasonable surface for a read-only student client, and coverage is split very granularly per activity type (separate list/get pairs for SCORM, H5P, Choice, Group Choice, Book, Page, Quiz, Forum). Many of these could be collapsed into parameterized tools (e.g. one list_activities with a type filter, one get_activity).
For a deliberately read-only Moodle surface, coverage is broad and coherent: courses, contents/modules, resources and files, assignments, quizzes, forums, grades, calendar, notifications, groups, private files, and most activity types. Gaps are mostly lower-priority activity types (lesson, wiki, glossary, database, workshop, feedback) and a dedicated single-course lookup, but core student workflows are covered with no dead ends.