enauczanie-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MOODLE_URL | Yes | The URL of the eNauczanie (Moodle) instance, e.g. https://enauczanie.pg.edu.pl/2026. Set in the environment before running get_token.py; otherwise written to .env by get_token.py. | |
| MOODLE_TOKEN | Yes | The Moodle web service token for the student's own account, obtained via the mobile-app launch flow (get_token.py) and stored in .env. | |
| ENAUCZANIE_DOWNLOAD_DIR | No | Overrides the location where downloaded files are saved (default: downloads/ inside the checkout). |
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
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_coursesC | List the user's enrolled courses on eNauczanie. Returns id, shortname, fullname and end_date. |
| get_course_contentsA | Return the sections, modules and files of one course as a compact tree with module dates, completion and availability. Descriptions are cut at 200 chars; get_module_text gives the full text. Use fileurl with download_file. |
| download_fileA | Download a course file (fileurl from get_course_contents) into the local downloads directory and return its path. |
| get_h5p_contentA | Return the text of an H5P exercise (module of type h5pactivity, id from get_course_contents): questions, answers, flashcards. |
| list_assignmentsA | List the assignments of one course (id from list_courses) with instructions, deadlines and attachments. The assignment_id values feed get_assignment_status. |
| get_assignment_statusA | Return the user's submission state, submitted files, grade and teacher feedback for one assignment (assignment_id from list_assignments, not the module id). |
| list_deadlinesA | List assignment due dates and quiz closing times across all courses, from days_back days ago to days_ahead days ahead, soonest first. |
| get_gradesA | Return the user's grades: without course_id the final grade of every course, with a course_id (from list_courses) every grade item of that course with weight, range, feedback and grading time. |
| get_module_textA | Return the full text of one module (module_id from get_course_contents): the whole description, the body of a page or the instructions of an assignment, with link targets and the module's files. |
| get_forum_discussionsA | List the latest discussions of a course's forums (type news = teacher announcements), newest first, each with its first post. forum_module_id (from get_course_contents) narrows to one forum; get_discussion_posts gives replies. |
| get_discussion_postsA | Return all posts of one forum discussion (discussion_id from get_forum_discussions), oldest first, full text. |
| get_quiz_reviewA | Review a finished quiz attempt (module_id from get_course_contents): every question with the chosen answer marked [x], its mark and the correct answer, when the teacher allows review. Default is the latest attempt. |
| get_notificationsB | Return the user's latest Moodle notifications (new forum posts, submission confirmations, grades) with the unread count, newest first. |
| get_recent_changesA | List what changed in the user's current courses in the last days (new announcements and posts, new or changed files, assignment submissions and grades), per module, newest first. |
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 14 tools
Most tools have clearly distinct purposes, especially around courses, modules, files, forums, assignments, and quizzes. A few boundaries are somewhat close, such as get_course_contents vs get_module_text and list_assignments vs list_deadlines, but the descriptions make the intended use fairly clear.
All tool names use a consistent snake_case verb_noun pattern: get_, list_, or download_. The convention is predictable throughout the set.
With 14 tools, the server is well-scoped for a Moodle/eNauczanie student-facing read surface. Each tool appears to earn its place by covering a distinct resource or workflow.
The surface covers the main read-only student workflows: courses, contents, files, assignments, deadlines, grades, forums, quizzes, notifications, and recent changes. Minor gaps remain, such as broader search or calendar-style access, but the core lifecycle is well represented.