mcp-moodle
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MOODLE_URL | Yes | The URL of the Moodle instance | |
| MOODLE_TOKEN | Yes | The personal web service token for Moodle |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| site_infoA | Return Moodle site info and the authenticated user's id/username. Use this first to verify the token works. |
| list_my_coursesA | List courses the authenticated user is enrolled in. Returns id, shortname, fullname, category id, and visibility. |
| get_course_contentsA | Return sections, modules and file URLs for a course. File URLs returned in Args: course_id: numeric course id (see list_my_courses) |
| search_coursesA | Search the public course catalog by keyword. Args: query: search text page: 0-indexed page perpage: results per page (max 100) |
| list_assignmentsA | List assignments across given courses (or all enrolled if omitted). Args: course_ids: optional list of course ids; omit to use all enrolled |
| list_quizzesA | List quizzes/QCMs in given courses, or all visible quizzes if omitted. Args: course_ids: optional list of course ids |
| get_quiz_qcm_contentA | Return rendered QCM/quiz questions from the current attempt. The tool reuses the latest unfinished attempt. If no unfinished attempt
exists, it returns Args: quiz_id: quiz instance id (see list_quizzes) start_if_needed: create a new attempt only when no unfinished attempt exists preflight_data: optional Moodle preflight data, e.g. quiz password entries |
| upcoming_eventsB | Return upcoming calendar events (deadlines, sessions) for the user. Args: limit: max number of events to return |
| get_user_gradesC | Return the authenticated user's grades for a course. Args: course_id: numeric course id |
| download_fileA | Download a Moodle file (from get_course_contents) to a local path. The Moodle token is appended automatically. The target directory is created if missing. Args:
file_url: pluginfile.php URL from a module's |
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 10 tools
Every tool targets a distinct resource or action: file download, course contents, quiz content, grades, assignments, courses, quizzes, search, site info, and events. No two tools have overlapping purposes, and descriptions clearly differentiate them.
Most tools follow a consistent verb_noun pattern (e.g., download_file, get_course_contents, list_assignments). However, site_info and upcoming_events deviate from this pattern, breaking the otherwise consistent naming scheme.
With 10 tools covering core Moodle operations (listing courses, assignments, quizzes, retrieving content, grades, events, and file downloads), the count is well-scoped and neither too sparse nor overwhelming for the server's purpose.
The tool set covers read and listing operations well but lacks write actions such as submitting assignments, creating quizzes, enrolling in courses, or updating user data. This leaves notable gaps for interactive workflows, limiting completeness.