PLATO MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PNU_ID | Yes | Your PLATO student ID (학번). Provided as a connector config value, or as a header/query parameter (pnu_id). | |
| PNU_PASSWORD | Yes | Your PLATO password. Provided as a connector config value, or as a header/query parameter (pnu_password). |
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_coursesB | List the courses the logged-in PLATO account is enrolled in. |
| get_course_contentsA | Get a course's weekly sections, modules, and file links. |
| list_assignmentsA | List assignments across one or more courses, with due dates. |
| get_assignment_detailB | Get one assignment's details and this account's submission status. |
| submit_assignmentA | Submit text and/or file attachments for an assignment. IRREVERSIBLE once dry_run=False. Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False (same parameters) after they explicitly confirm. Provide text, file_paths/file_contents, or both -- whichever this assignment actually accepts (see get_assignment_detail). file_paths works only when this server is running locally (stdio, e.g. Claude Code/Desktop) -- rejected with a clear error over a remote (streamable-http, e.g. a Claude.ai Connector) connection, mirroring download_course_file's own stdio-vs-remote split. file_contents works over either transport and is the only option remotely, since this server's disk is not reachable by you there. |
| remove_submissionA | Withdraw/clear this account's own submission for an assignment. IRREVERSIBLE and DESTRUCTIVE once dry_run=False -- this discards already-submitted work (files/text), not a draft. KNOWN ISSUE: live testing found dry_run=False currently fails with an "invalid parameter" error from PLATO every time (the real required parameter shape wasn't determined -- see remove_submission_for's docstring). dry_run=True (preview) works and is safe to call. Do not rely on dry_run=False actually working until this is fixed. Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm. |
| get_gradesC | Get this account's grade items for a course, if visible. |
| get_grades_access_infoA | Check what grade-related permissions this account has in a course -- e.g. whether it can see its own grades vs. (as a teacher/TA) everyone's grades. Most student accounts will see canviewallgrades=False. |
| list_calendar_eventsB | List upcoming calendar events within the next |
| get_calendar_access_infoA | Check this account's calendar-management permissions -- a student account can typically manage its own personal entries only, not course/group entries. |
| create_calendar_eventA | Create a personal calendar entry. IRREVERSIBLE once dry_run=False. Only personal ("user") events are supported -- course/group events are not something a student account can create. Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm. |
| delete_calendar_eventA | Delete a personal calendar entry this account owns. IRREVERSIBLE once dry_run=False. Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm. |
| get_unread_messagesC | Get this account's unread PLATO notifications. |
| get_unread_notification_countA | Get a count of this account's unread notifications (a cheaper check than get_unread_messages when you don't need the content). Note: PLATO has person-to-person messaging disabled site-wide, so this counts notifications only, not conversation messages. |
| list_noticesA | List announcements posted to a course's Notices board. |
| get_notice_detailA | Get the full text of one notice/announcement. |
| list_qnaB | List questions posted to a course's Q&A board. |
| get_qna_detailB | Get one Q&A question's text. Does not include replies -- see issue #23. |
| post_qna_questionA | Post a new question to a course's Q&A board. IRREVERSIBLE and VISIBLE to the instructor once dry_run=False (posted as private/secret by default). Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm. |
| download_course_fileA | Download a course file (the Running locally (stdio, e.g. Claude Code/Desktop): saves the file to
Running as a remote/hosted server (streamable-http, e.g. reached via
a Claude.ai web/mobile Connector): this server's own disk is not
reachable by you, so do NOT pass Only common course-material extensions are allowed (pdf, office docs, images, zip, txt); local downloads over the configured size limit are rejected. |
| get_course_completion_statusA | Get this account's overall course-completion status, if the course
has course-level completion criteria configured. Most courses on
this platform don't (available=False, with a message explaining
why) -- try get_activity_completion_status for per-activity
progress instead, or get_course_contents's per-module |
| get_activity_completion_statusA | Get this account's completion status for every activity/module in
a course -- richer than get_course_contents's per-module |
| get_upcoming_action_eventsA | Get Moodle's own "what needs action soon" feed -- assignments due, video lectures with a watch deadline, etc. -- sorted by urgency, from now onward. Unlike combining list_assignments + get_calendar_events, this is Moodle's own cross-activity prioritized view and may surface activity types (e.g. vod watch deadlines) those tools don't. |
| get_courses_by_timelineA | List enrolled courses filtered by Moodle's own timeline classification (in-progress/future/past), based on course start/end dates. Unlike list_courses (which returns everything unfiltered), this answers "what am I actually taking right now" directly. |
| get_grades_overviewA | Get this account's overall grade for every enrolled course in one call. For the individual grade items within one course (e.g. each assignment's score), use get_grades instead -- this tool only returns one summary grade per course. |
| list_quizzesC | List quizzes across one or more courses. |
| get_quiz_attemptsC | Get this account's past attempts at one quiz. |
| get_quiz_best_gradeA | Get this account's best grade on one quiz, if any attempt has been graded. |
| get_quiz_access_informationA | Check whether this account can currently attempt a quiz, and why not if blocked (e.g. time window, password, previous attempts exhausted). UNVERIFIED against a real quiz -- call this before start_quiz_attempt and sanity-check the result. |
| get_quiz_required_qtypesA | List the question types used in a quiz (e.g. 'multichoice', 'truefalse', 'essay') -- useful to know what kind of answers to expect before starting an attempt. |
| get_quiz_feedback_for_gradeA | Get the grade-boundary feedback text configured for a quiz at a given grade (e.g. 'You passed!' / 'Please review chapter 3'). |
| get_quiz_combined_review_optionsA | Check which review details (marks, feedback, right answers) this account is allowed to see for a quiz's attempts. |
| start_quiz_attemptA | Start a new attempt at a quiz. IRREVERSIBLE once dry_run=False -- consumes one of the quiz's limited attempts. UNVERIFIED against a real quiz -- call get_quiz_access_information first and check canattempt/preventaccessreasons. Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm. |
| get_quiz_attempt_dataA | Get the questions for one page of an in-progress quiz attempt.
Each question's |
| get_quiz_attempt_summaryA | Get a summary of all questions in an attempt (answered/ unanswered), across all pages. UNVERIFIED against a real quiz. |
| get_quiz_attempt_reviewA | Get the grade and per-question review for a finished quiz attempt. UNVERIFIED against a real quiz. |
| save_quiz_attempt_responsesA | Save in-progress answers WITHOUT finishing the attempt -- can still be changed later. UNVERIFIED against a real quiz. Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm. |
| process_quiz_attemptA | Submit answers for a quiz attempt. IRREVERSIBLE once dry_run=False AND finish_attempt=True -- that is the final, graded submission and cannot be undone. UNVERIFIED against a real quiz. Call with dry_run=True (default) first, show the preview to the user -- especially before finish_attempt=True -- and only call again with dry_run=False after they explicitly confirm. |
| list_forumsA | List standard Moodle forums across one or more courses. NOT the same as PLATO's notice/Q&A board (use list_notices/list_qna for that) -- this covers the separate, less-commonly-used mod_forum module. |
| get_forum_discussionsB | List discussion threads in one standard Moodle forum. |
| get_discussion_postsB | Get all posts in one forum discussion thread. |
| add_discussionA | Start a new discussion thread in a forum. IRREVERSIBLE once dry_run=False. Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm. |
| add_discussion_postA | Reply to a forum discussion thread. IRREVERSIBLE once dry_run=False. Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm. |
| get_course_updates_sinceA | Get what changed in a course since a given time -- configuration,
completion, grades, submissions, etc. Only reports modules that
implement Moodle's change-tracking (confirmed: the standard |
| get_course_moduleA | Resolve a single course module by its id directly, without fetching and filtering the whole course's contents. |
| search_coursesA | Search PLATO's entire course catalog by name -- not limited to this account's enrolled courses (use list_courses for that). |
| get_recent_coursesA | Get this account's recently-accessed courses, most recent first. |
| get_recent_itemsA | Get this account's recently-accessed course modules (files, assignments, etc.) across all courses, most recent first. |
| get_starred_coursesB | Get this account's starred/favourited courses, if any. |
| list_video_conferencesA | List BigBlueButton video-conference activities across one or more courses. Joining a meeting is not supported by this server -- this tool is read-only coverage only. Zoom activities (mod_zoom) are not covered -- no real instance has existed to verify against. |
| list_lessonsA | List Lesson activities across one or more courses. Taking a lesson (answering pages) is not supported by this server -- this tool is read-only coverage only. |
| list_workshopsA | List Workshop (peer assessment) activities across one or more courses. Submitting or assessing work is not supported by this server -- this tool is read-only coverage only. |
| list_feedbacksA | List Feedback (survey) activities across one or more courses. Responding to a survey is not supported by this server -- this tool is read-only coverage only. |
| list_choicesA | List Choice (single-question poll) activities across one or more courses. Voting is not supported by this server -- this tool is read-only coverage only. |
| list_surveysA | List Survey activities across one or more courses. Answering is not supported by this server -- this tool is read-only coverage only. |
| list_scormsA | List SCORM packaged-content activities across one or more courses. Launching/tracking a SCORM attempt is not supported by this server -- this tool is read-only coverage only. |
| list_h5p_activitiesA | List H5P interactive-content activities across one or more courses. Attempt results are not supported by this server -- this tool is read-only coverage only. |
| list_glossariesA | List Glossary activities across one or more courses. Reading/ adding entries is not supported by this server -- this tool is read-only coverage only. |
| list_database_activitiesA | List Database ("mod_data") activities across one or more courses. Reading/adding entries is not supported by this server -- this tool is read-only coverage only. |
| list_wikisA | List Wiki activities across one or more courses. Reading/ editing pages is not supported by this server -- this tool is read-only coverage only. |
| list_chatsA | List Chat (real-time chat room) activities across one or more courses. Reading/sending chat messages is not supported by this server -- this tool is read-only coverage only. |
| get_user_profileA | Get a user's profile, scoped to a shared course (not a global user search -- see docs/pii_review.md). |
| get_private_files_infoA | Get a summary (file/folder count, total size) of this account's Moodle private files area. |
| get_user_preferencesA | Get this account's Moodle user preferences. Note: most of these are internal UI state (e.g. which dashboard sections are collapsed), not information meaningful on its own. |
| add_private_fileA | Upload a file to this account's Moodle private files area. IRREVERSIBLE once dry_run=False -- no delete tool exists for private files yet, so this permanently adds the file until the user removes it via PLATO's own UI. Only works when this server is running locally (stdio). Call with dry_run=True (default) first, show the preview to the user, and only call again with dry_run=False after they explicitly confirm. |
| get_my_course_groupsA | Get the groups this account belongs to within a course, if any. |
| get_enrolled_usersB | Get the list of users enrolled in a course (classmates and instructors), with their role. Same data visible in PLATO's own participant list to any enrolled student. |
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 67 tools
Most tools have distinct resource/action targets, and descriptions explicitly clarify several near-neighbors such as list_forums vs. list_notices/list_qna and course completion vs. activity completion. However, there is meaningful overlap among course-listing tools, grade-summary vs. grade-item tools, unread count vs. unread messages, and quiz save vs. process/submit operations, so selection remains error-prone with 67 tools.
Names are consistently snake_case and generally verb-led, which makes the surface predictable. The main inconsistency is the mix of verb families for similar operations, such as list_ vs. get_ for reads and create/add/post/submit/save/process/remove/delete for mutations.
Sixty-seven tools far exceeds the practical 3-15 range and is an extreme count for an agent-facing server. The surface is heavily fragmented into one-off list tools for many activity types, which makes the set harder to navigate even though the LMS domain is broad.
Core student workflows are covered: courses, contents, assignments, grades, quizzes, forums, calendar, notices, Q&A, and files all have read or write operations. But notable gaps remain, including no Q&A reply tool, no calendar update, no private-file delete, many read-only activity modules, and a known-broken remove_submission dry_run=False path.