PLATO (Pusan National University LMS) MCP server via Moodle Web Service API + ubboard scraping
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
PLATO (Moodle) login ID
PLATO (Moodle) login password
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Thread body content.
Thread subject/title.
Forum id, e.g. from list_forums.
If True (default), only preview the new discussion without posting it. Call again with dry_run=False (same parameters) to actually post.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
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.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | If True (default), only preview the new discussion without posting it. Call again with dry_run=False (same parameters) to actually post. |
| message* | string | Thread body content. |
| subject* | string | Thread subject/title. |
| forum_id* | integer | Forum id, e.g. from list_forums. |
{
"type": "object",
"title": "add_discussionArguments",
"required": [
"forum_id",
"subject",
"message"
],
"properties": {
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "If True (default), only preview the new discussion without posting it. Call again with dry_run=False (same parameters) to actually post."
},
"message": {
"type": "string",
"title": "Message",
"description": "Thread body content."
},
"subject": {
"type": "string",
"title": "Subject",
"description": "Thread subject/title."
},
"forum_id": {
"type": "integer",
"title": "Forum Id",
"description": "Forum id, e.g. from list_forums."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | If True (default), only preview the reply without sending it. Call again with dry_run=False (same parameters) to actually post it. |
| message* | string | Reply content. |
| subject | any | Optional subject override for the reply. |
| discussion_id* | integer | Discussion id, e.g. from get_forum_discussions. |
{
"type": "object",
"title": "add_discussion_postArguments",
"required": [
"discussion_id",
"message"
],
"properties": {
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "If True (default), only preview the reply without sending it. Call again with dry_run=False (same parameters) to actually post it."
},
"message": {
"type": "string",
"title": "Message",
"description": "Reply content."
},
"subject": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Subject",
"default": null,
"description": "Optional subject override for the reply."
},
"discussion_id": {
"type": "integer",
"title": "Discussion Id",
"description": "Discussion id, e.g. from get_forum_discussions."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | If True (default), only preview the upload without doing it. Call again with dry_run=False (same parameters) to actually upload it. |
| file_path* | string | Local file path to upload. |
{
"type": "object",
"title": "add_private_fileArguments",
"required": [
"file_path"
],
"properties": {
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "If True (default), only preview the upload without doing it. Call again with dry_run=False (same parameters) to actually upload it."
},
"file_path": {
"type": "string",
"title": "File Path",
"description": "Local file path to upload."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| name* | string | Event title. |
| dry_run | boolean | If True (default), only preview the event without creating it. Call again with dry_run=False (same parameters) to actually create it. |
| timestart* | integer | Unix timestamp for the event's start. |
| description | string | Optional event description. |
| duration_seconds | integer | Event duration in seconds, 0 for a point-in-time event. |
{
"type": "object",
"title": "create_calendar_eventArguments",
"required": [
"name",
"timestart"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"description": "Event title."
},
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "If True (default), only preview the event without creating it. Call again with dry_run=False (same parameters) to actually create it."
},
"timestart": {
"type": "integer",
"title": "Timestart",
"description": "Unix timestamp for the event's start."
},
"description": {
"type": "string",
"title": "Description",
"default": "",
"description": "Optional event description."
},
"duration_seconds": {
"type": "integer",
"title": "Duration Seconds",
"default": 0,
"description": "Event duration in seconds, 0 for a point-in-time event."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | If True (default), only preview the deletion without doing it. Call again with dry_run=False (same parameters) to actually delete it. |
| event_id* | integer | Calendar event id to delete. |
{
"type": "object",
"title": "delete_calendar_eventArguments",
"required": [
"event_id"
],
"properties": {
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "If True (default), only preview the deletion without doing it. Call again with dry_run=False (same parameters) to actually delete it."
},
"event_id": {
"type": "integer",
"title": "Event Id",
"description": "Calendar event id to delete."
}
}
}Download a course file (the `fileurl` from get_course_contents). Running locally (stdio, e.g. Claude Code/Desktop): saves the file to `save_path` on this machine and returns the saved path -- `save_path` is required in this case. 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 `save_path` -- it will be rejected. Instead the file is fetched here and returned inline as base64 content for you to decode and present, unless it's too large, in which case a direct authenticated download URL is returned instead (that URL embeds a live PLATO access token: do not share it or a chat transcript containing it). Only common course-material extensions are allowed (pdf, office docs, images, zip, txt); local downloads over the configured size limit are rejected.
| Argument | Type | Description |
|---|---|---|
| file_url* | string | The `fileurl` value from get_course_contents. |
| save_path | any | Local filesystem path to save to. Required when running locally (stdio); must be omitted when running remotely over HTTP. |
{
"type": "object",
"title": "download_course_fileArguments",
"required": [
"file_url"
],
"properties": {
"file_url": {
"type": "string",
"title": "File Url",
"description": "The `fileurl` value from get_course_contents."
},
"save_path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Save Path",
"default": null,
"description": "Local filesystem path to save to. Required when running locally (stdio); must be omitted when running remotely over HTTP."
}
}
}Get this account's completion status for every activity/module in a course -- richer than get_course_contents's per-module `completed` flag (includes tracking rules, e.g. 'must view' vs 'must spend N minutes'). For `vod` (video lecture) modules specifically, prefer get_course_contents, whose per-module `vod_progress` field also includes watch-percentage and deadline info this function doesn't return.
| Argument | Type | Description |
|---|---|---|
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
{
"type": "object",
"title": "get_activity_completion_statusArguments",
"required": [
"course_id"
],
"properties": {
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
}
}
}Get one assignment's details and this account's submission status.
| Argument | Type | Description |
|---|---|---|
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
| assignment_id* | integer | Assignment id, e.g. from list_assignments. |
{
"type": "object",
"title": "get_assignment_detailArguments",
"required": [
"course_id",
"assignment_id"
],
"properties": {
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
},
"assignment_id": {
"type": "integer",
"title": "Assignment Id",
"description": "Assignment id, e.g. from list_assignments."
}
}
}Check this account's calendar-management permissions -- a student account can typically manage its own personal entries only, not course/group entries.
No arguments.
{
"type": "object",
"title": "get_calendar_access_infoArguments",
"properties": {}
}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 `completed` flag.
| Argument | Type | Description |
|---|---|---|
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
{
"type": "object",
"title": "get_course_completion_statusArguments",
"required": [
"course_id"
],
"properties": {
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
}
}
}Get a course's weekly sections, modules, and file links.
| Argument | Type | Description |
|---|---|---|
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
{
"type": "object",
"title": "get_course_contentsArguments",
"required": [
"course_id"
],
"properties": {
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
}
}
}Resolve a single course module by its id directly, without fetching and filtering the whole course's contents.
| Argument | Type | Description |
|---|---|---|
| cmid* | integer | Course module id (cmid). |
{
"type": "object",
"title": "get_course_moduleArguments",
"required": [
"cmid"
],
"properties": {
"cmid": {
"type": "integer",
"title": "Cmid",
"description": "Course module id (cmid)."
}
}
}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 `assign` module does; this platform's own custom lecture-file/board/video modules do not, so this won't catch a new ubfile lecture or ubboard post -- use get_course_contents/list_notices to check those instead.
| Argument | Type | Description |
|---|---|---|
| since* | integer | Unix timestamp -- report changes after this point in time. |
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
{
"type": "object",
"title": "get_course_updates_sinceArguments",
"required": [
"course_id",
"since"
],
"properties": {
"since": {
"type": "integer",
"title": "Since",
"description": "Unix timestamp -- report changes after this point in time."
},
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| classification | string | 'inprogress' (currently running, the default), 'future' (not started yet), or 'past' (ended). |
{
"type": "object",
"title": "get_courses_by_timelineArguments",
"properties": {
"classification": {
"enum": [
"inprogress",
"future",
"past"
],
"type": "string",
"title": "Classification",
"default": "inprogress",
"description": "'inprogress' (currently running, the default), 'future' (not started yet), or 'past' (ended)."
}
}
}Get all posts in one forum discussion thread.
| Argument | Type | Description |
|---|---|---|
| discussion_id* | integer | Discussion id, e.g. from get_forum_discussions. |
{
"type": "object",
"title": "get_discussion_postsArguments",
"required": [
"discussion_id"
],
"properties": {
"discussion_id": {
"type": "integer",
"title": "Discussion Id",
"description": "Discussion id, e.g. from get_forum_discussions."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
{
"type": "object",
"title": "get_enrolled_usersArguments",
"required": [
"course_id"
],
"properties": {
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
}
}
}List discussion threads in one standard Moodle forum.
| Argument | Type | Description |
|---|---|---|
| forum_id* | integer | Forum id, e.g. from list_forums. |
{
"type": "object",
"title": "get_forum_discussionsArguments",
"required": [
"forum_id"
],
"properties": {
"forum_id": {
"type": "integer",
"title": "Forum Id",
"description": "Forum id, e.g. from list_forums."
}
}
}Get this account's grade items for a course, if visible.
| Argument | Type | Description |
|---|---|---|
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
{
"type": "object",
"title": "get_gradesArguments",
"required": [
"course_id"
],
"properties": {
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
{
"type": "object",
"title": "get_grades_access_infoArguments",
"required": [
"course_id"
],
"properties": {
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
}
}
}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.
No arguments.
{
"type": "object",
"title": "get_grades_overviewArguments",
"properties": {}
}Get the groups this account belongs to within a course, if any.
| Argument | Type | Description |
|---|---|---|
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
{
"type": "object",
"title": "get_my_course_groupsArguments",
"required": [
"course_id"
],
"properties": {
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
}
}
}Get the full text of one notice/announcement.
| Argument | Type | Description |
|---|---|---|
| post_id* | integer | Notice post id, e.g. from list_notices. |
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
{
"type": "object",
"title": "get_notice_detailArguments",
"required": [
"course_id",
"post_id"
],
"properties": {
"post_id": {
"type": "integer",
"title": "Post Id",
"description": "Notice post id, e.g. from list_notices."
},
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
}
}
}Get a summary (file/folder count, total size) of this account's Moodle private files area.
No arguments.
{
"type": "object",
"title": "get_private_files_infoArguments",
"properties": {}
}Get one Q&A question's text. Does not include replies -- see issue #23.
| Argument | Type | Description |
|---|---|---|
| post_id* | integer | Q&A post id, e.g. from list_qna. |
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
{
"type": "object",
"title": "get_qna_detailArguments",
"required": [
"course_id",
"post_id"
],
"properties": {
"post_id": {
"type": "integer",
"title": "Post Id",
"description": "Q&A post id, e.g. from list_qna."
},
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| quiz_id* | integer | Quiz id, e.g. from list_quizzes. |
{
"type": "object",
"title": "get_quiz_access_informationArguments",
"required": [
"quiz_id"
],
"properties": {
"quiz_id": {
"type": "integer",
"title": "Quiz Id",
"description": "Quiz id, e.g. from list_quizzes."
}
}
}Get the questions for one page of an in-progress quiz attempt. Each question's `html` is Moodle's own rendered question form -- parse it for the actual answer-field names before calling save_quiz_attempt_responses/process_quiz_attempt. UNVERIFIED against a real quiz.
| Argument | Type | Description |
|---|---|---|
| page | integer | Quiz page number, 0-indexed. |
| attempt_id* | integer | Attempt id, e.g. from start_quiz_attempt. |
{
"type": "object",
"title": "get_quiz_attempt_dataArguments",
"required": [
"attempt_id"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 0,
"description": "Quiz page number, 0-indexed."
},
"attempt_id": {
"type": "integer",
"title": "Attempt Id",
"description": "Attempt id, e.g. from start_quiz_attempt."
}
}
}Get the grade and per-question review for a finished quiz attempt. UNVERIFIED against a real quiz.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number, 0-indexed, or -1 for all pages. |
| attempt_id* | integer | Attempt id, e.g. from start_quiz_attempt. |
{
"type": "object",
"title": "get_quiz_attempt_reviewArguments",
"required": [
"attempt_id"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": -1,
"description": "Page number, 0-indexed, or -1 for all pages."
},
"attempt_id": {
"type": "integer",
"title": "Attempt Id",
"description": "Attempt id, e.g. from start_quiz_attempt."
}
}
}Get a summary of all questions in an attempt (answered/ unanswered), across all pages. UNVERIFIED against a real quiz.
| Argument | Type | Description |
|---|---|---|
| attempt_id* | integer | Attempt id, e.g. from start_quiz_attempt. |
{
"type": "object",
"title": "get_quiz_attempt_summaryArguments",
"required": [
"attempt_id"
],
"properties": {
"attempt_id": {
"type": "integer",
"title": "Attempt Id",
"description": "Attempt id, e.g. from start_quiz_attempt."
}
}
}Get this account's past attempts at one quiz.
| Argument | Type | Description |
|---|---|---|
| quiz_id* | integer | Quiz id, e.g. from list_quizzes. |
{
"type": "object",
"title": "get_quiz_attemptsArguments",
"required": [
"quiz_id"
],
"properties": {
"quiz_id": {
"type": "integer",
"title": "Quiz Id",
"description": "Quiz id, e.g. from list_quizzes."
}
}
}Get this account's best grade on one quiz, if any attempt has been graded.
| Argument | Type | Description |
|---|---|---|
| quiz_id* | integer | Quiz id, e.g. from list_quizzes. |
{
"type": "object",
"title": "get_quiz_best_gradeArguments",
"required": [
"quiz_id"
],
"properties": {
"quiz_id": {
"type": "integer",
"title": "Quiz Id",
"description": "Quiz id, e.g. from list_quizzes."
}
}
}Check which review details (marks, feedback, right answers) this account is allowed to see for a quiz's attempts.
| Argument | Type | Description |
|---|---|---|
| quiz_id* | integer | Quiz id, e.g. from list_quizzes. |
| attempt_id | any | Optional: a specific attempt id to check options for. |
{
"type": "object",
"title": "get_quiz_combined_review_optionsArguments",
"required": [
"quiz_id"
],
"properties": {
"quiz_id": {
"type": "integer",
"title": "Quiz Id",
"description": "Quiz id, e.g. from list_quizzes."
},
"attempt_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Attempt Id",
"default": null,
"description": "Optional: a specific attempt id to check options for."
}
}
}Get the grade-boundary feedback text configured for a quiz at a given grade (e.g. 'You passed!' / 'Please review chapter 3').
| Argument | Type | Description |
|---|---|---|
| grade* | number | A grade value to look up feedback text for. |
| quiz_id* | integer | Quiz id, e.g. from list_quizzes. |
{
"type": "object",
"title": "get_quiz_feedback_for_gradeArguments",
"required": [
"quiz_id",
"grade"
],
"properties": {
"grade": {
"type": "number",
"title": "Grade",
"description": "A grade value to look up feedback text for."
},
"quiz_id": {
"type": "integer",
"title": "Quiz Id",
"description": "Quiz id, e.g. from list_quizzes."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| quiz_id* | integer | Quiz id, e.g. from list_quizzes. |
{
"type": "object",
"title": "get_quiz_required_qtypesArguments",
"required": [
"quiz_id"
],
"properties": {
"quiz_id": {
"type": "integer",
"title": "Quiz Id",
"description": "Quiz id, e.g. from list_quizzes."
}
}
}Get this account's recently-accessed courses, most recent first.
No arguments.
{
"type": "object",
"title": "get_recent_coursesArguments",
"properties": {}
}Get this account's recently-accessed course modules (files, assignments, etc.) across all courses, most recent first.
No arguments.
{
"type": "object",
"title": "get_recent_itemsArguments",
"properties": {}
}Get this account's starred/favourited courses, if any.
No arguments.
{
"type": "object",
"title": "get_starred_coursesArguments",
"properties": {}
}Get this account's unread PLATO notifications.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of unread notifications to return. |
{
"type": "object",
"title": "get_unread_messagesArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"description": "Maximum number of unread notifications to return."
}
}
}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.
No arguments.
{
"type": "object",
"title": "get_unread_notification_countArguments",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of upcoming events to return. |
{
"type": "object",
"title": "get_upcoming_action_eventsArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"description": "Maximum number of upcoming events to return."
}
}
}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.
No arguments.
{
"type": "object",
"title": "get_user_preferencesArguments",
"properties": {}
}Get a user's profile, scoped to a shared course (not a global user search -- see docs/pii_review.md).
| Argument | Type | Description |
|---|---|---|
| userid | any | User id to look up. Omit to get this account's own profile. |
| course_id* | integer | PLATO/Moodle numeric course id both accounts share. |
{
"type": "object",
"title": "get_user_profileArguments",
"required": [
"course_id"
],
"properties": {
"userid": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Userid",
"default": null,
"description": "User id to look up. Omit to get this account's own profile."
},
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id both accounts share."
}
}
}List assignments across one or more courses, with due dates.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list assignments for. |
{
"type": "object",
"title": "list_assignmentsArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list assignments for."
}
}
}List upcoming calendar events within the next `days_ahead` days.
| Argument | Type | Description |
|---|---|---|
| days_ahead | integer | How many days ahead of now to include events for. |
{
"type": "object",
"title": "list_calendar_eventsArguments",
"properties": {
"days_ahead": {
"type": "integer",
"title": "Days Ahead",
"default": 14,
"description": "How many days ahead of now to include events for."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list chat rooms for. |
{
"type": "object",
"title": "list_chatsArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list chat rooms for."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list choice activities for. |
{
"type": "object",
"title": "list_choicesArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list choice activities for."
}
}
}List the courses the logged-in PLATO account is enrolled in.
No arguments.
{
"type": "object",
"title": "list_coursesArguments",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list database activities for. |
{
"type": "object",
"title": "list_database_activitiesArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list database activities for."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list feedback activities for. |
{
"type": "object",
"title": "list_feedbacksArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list feedback activities for."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list forums for. |
{
"type": "object",
"title": "list_forumsArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list forums for."
}
}
}List Glossary activities across one or more courses. Reading/ adding entries is not supported by this server -- this tool is read-only coverage only.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list glossaries for. |
{
"type": "object",
"title": "list_glossariesArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list glossaries for."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list H5P activities for. |
{
"type": "object",
"title": "list_h5p_activitiesArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list H5P activities for."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list lessons for. |
{
"type": "object",
"title": "list_lessonsArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list lessons for."
}
}
}List announcements posted to a course's Notices board.
| Argument | Type | Description |
|---|---|---|
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
{
"type": "object",
"title": "list_noticesArguments",
"required": [
"course_id"
],
"properties": {
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
}
}
}List questions posted to a course's Q&A board.
| Argument | Type | Description |
|---|---|---|
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
{
"type": "object",
"title": "list_qnaArguments",
"required": [
"course_id"
],
"properties": {
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
}
}
}List quizzes across one or more courses.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list quizzes for. |
{
"type": "object",
"title": "list_quizzesArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list quizzes for."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list SCORM packages for. |
{
"type": "object",
"title": "list_scormsArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list SCORM packages for."
}
}
}List Survey activities across one or more courses. Answering is not supported by this server -- this tool is read-only coverage only.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list survey activities for. |
{
"type": "object",
"title": "list_surveysArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list survey activities for."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list video conferences for. |
{
"type": "object",
"title": "list_video_conferencesArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list video conferences for."
}
}
}List Wiki activities across one or more courses. Reading/ editing pages is not supported by this server -- this tool is read-only coverage only.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list wikis for. |
{
"type": "object",
"title": "list_wikisArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list wikis for."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| course_ids* | array | One or more course ids to list workshops for. |
{
"type": "object",
"title": "list_workshopsArguments",
"required": [
"course_ids"
],
"properties": {
"course_ids": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Course Ids",
"description": "One or more course ids to list workshops for."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | If True (default), only preview without posting. Call again with dry_run=False (same parameters) to actually post it. |
| subject* | string | Subject/title of the Q&A question. |
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
| content_text* | string | Body text of the Q&A question. |
{
"type": "object",
"title": "post_qna_questionArguments",
"required": [
"course_id",
"subject",
"content_text"
],
"properties": {
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "If True (default), only preview without posting. Call again with dry_run=False (same parameters) to actually post it."
},
"subject": {
"type": "string",
"title": "Subject",
"description": "Subject/title of the Q&A question."
},
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
},
"content_text": {
"type": "string",
"title": "Content Text",
"description": "Body text of the Q&A question."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | If True (default), only preview without doing it. Call again with dry_run=False (same parameters) to actually submit it. |
| responses* | object | Moodle question-form field name -> answer value, parsed from get_quiz_attempt_data's returned HTML. |
| attempt_id* | integer | Attempt id, e.g. from start_quiz_attempt. |
| finish_attempt | boolean | If True, this is the FINAL submission -- the attempt is locked and graded. If False, this just records answers for the current page. |
{
"type": "object",
"title": "process_quiz_attemptArguments",
"required": [
"attempt_id",
"responses"
],
"properties": {
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "If True (default), only preview without doing it. Call again with dry_run=False (same parameters) to actually submit it."
},
"responses": {
"type": "object",
"title": "Responses",
"description": "Moodle question-form field name -> answer value, parsed from get_quiz_attempt_data's returned HTML.",
"additionalProperties": {
"type": "string"
}
},
"attempt_id": {
"type": "integer",
"title": "Attempt Id",
"description": "Attempt id, e.g. from start_quiz_attempt."
},
"finish_attempt": {
"type": "boolean",
"title": "Finish Attempt",
"default": false,
"description": "If True, this is the FINAL submission -- the attempt is locked and graded. If False, this just records answers for the current page."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | If True (default), only preview the removal without doing it. Call again with dry_run=False (same parameters) to actually remove it. |
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
| assignment_id* | integer | Assignment id, e.g. from list_assignments. |
{
"type": "object",
"title": "remove_submissionArguments",
"required": [
"course_id",
"assignment_id"
],
"properties": {
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "If True (default), only preview the removal without doing it. Call again with dry_run=False (same parameters) to actually remove it."
},
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
},
"assignment_id": {
"type": "integer",
"title": "Assignment Id",
"description": "Assignment id, e.g. from list_assignments."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| page | integer | Quiz page number these responses are for. |
| dry_run | boolean | If True (default), only preview saving without doing it. Call again with dry_run=False (same parameters) to actually save it. |
| responses* | object | Moodle question-form field name -> answer value, parsed from get_quiz_attempt_data's returned HTML. |
| attempt_id* | integer | Attempt id, e.g. from start_quiz_attempt. |
{
"type": "object",
"title": "save_quiz_attempt_responsesArguments",
"required": [
"attempt_id",
"responses"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 0,
"description": "Quiz page number these responses are for."
},
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "If True (default), only preview saving without doing it. Call again with dry_run=False (same parameters) to actually save it."
},
"responses": {
"type": "object",
"title": "Responses",
"description": "Moodle question-form field name -> answer value, parsed from get_quiz_attempt_data's returned HTML.",
"additionalProperties": {
"type": "string"
}
},
"attempt_id": {
"type": "integer",
"title": "Attempt Id",
"description": "Attempt id, e.g. from start_quiz_attempt."
}
}
}Search PLATO's entire course catalog by name -- not limited to this account's enrolled courses (use list_courses for that).
| Argument | Type | Description |
|---|---|---|
| search_text* | string | Text to search for in course names. |
{
"type": "object",
"title": "search_coursesArguments",
"required": [
"search_text"
],
"properties": {
"search_text": {
"type": "string",
"title": "Search Text",
"description": "Text to search for in course names."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | If True (default), only preview starting the attempt. Call again with dry_run=False (same parameters) to actually start it. |
| quiz_id* | integer | Quiz id, e.g. from list_quizzes. |
{
"type": "object",
"title": "start_quiz_attemptArguments",
"required": [
"quiz_id"
],
"properties": {
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "If True (default), only preview starting the attempt. Call again with dry_run=False (same parameters) to actually start it."
},
"quiz_id": {
"type": "integer",
"title": "Quiz Id",
"description": "Quiz id, e.g. from list_quizzes."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| text | string | Plain-text submission content. Omit (empty string) for a file-only submission. Rejected if this assignment doesn't accept online text -- check get_assignment_detail's onlinetext_submission.enabled first. |
| dry_run | boolean | If True (default), only preview the submission without sending it. Call again with dry_run=False (same parameters) to actually submit it. |
| course_id* | integer | PLATO/Moodle numeric course id, e.g. from list_courses. |
| file_paths | any | Local filesystem paths to upload as file attachments. Only works when this server is running locally (stdio) -- rejected with a clear error over a remote/streamable-http connection (use file_contents there instead). Rejected if this assignment doesn't accept file submissions, exceeds its max file count/size, or uses a disallowed extension -- check get_assignment_detail's file_submission (enabled/max_files/max_size_bytes/allowed_extensions) first. |
| assignment_id* | integer | Assignment id, e.g. from list_assignments. |
| file_contents | any | File attachments as {filename, content_base64} -- works over either transport, and is the only way to attach files when this server is running remotely (streamable-http), since it has no local filesystem to read a path from there. Each file is capped at 5MB decoded, in addition to this assignment's own max file count/size/extension rules (see get_assignment_detail's file_submission). |
{
"type": "object",
"$defs": {
"InlineFileUpload": {
"type": "object",
"title": "InlineFileUpload",
"required": [
"filename",
"content_base64"
],
"properties": {
"filename": {
"type": "string",
"title": "Filename"
},
"content_base64": {
"type": "string",
"title": "Content Base64"
}
},
"description": "One file's content, handed to the server directly over remote\n(streamable-http) transport -- there's no local filesystem for the\nserver to read from there, so the client must send the bytes itself\n(issue #153). The upload-direction counterpart to files.py's\nDownloadContentResult."
}
},
"title": "submit_assignmentArguments",
"required": [
"course_id",
"assignment_id"
],
"properties": {
"text": {
"type": "string",
"title": "Text",
"default": "",
"description": "Plain-text submission content. Omit (empty string) for a file-only submission. Rejected if this assignment doesn't accept online text -- check get_assignment_detail's onlinetext_submission.enabled first."
},
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "If True (default), only preview the submission without sending it. Call again with dry_run=False (same parameters) to actually submit it."
},
"course_id": {
"type": "integer",
"title": "Course Id",
"description": "PLATO/Moodle numeric course id, e.g. from list_courses."
},
"file_paths": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "File Paths",
"default": null,
"description": "Local filesystem paths to upload as file attachments. Only works when this server is running locally (stdio) -- rejected with a clear error over a remote/streamable-http connection (use file_contents there instead). Rejected if this assignment doesn't accept file submissions, exceeds its max file count/size, or uses a disallowed extension -- check get_assignment_detail's file_submission (enabled/max_files/max_size_bytes/allowed_extensions) first."
},
"assignment_id": {
"type": "integer",
"title": "Assignment Id",
"description": "Assignment id, e.g. from list_assignments."
},
"file_contents": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/InlineFileUpload"
}
},
{
"type": "null"
}
],
"title": "File Contents",
"default": null,
"description": "File attachments as {filename, content_base64} -- works over either transport, and is the only way to attach files when this server is running remotely (streamable-http), since it has no local filesystem to read a path from there. Each file is capped at 5MB decoded, in addition to this assignment's own max file count/size/extension rules (see get_assignment_detail's file_submission)."
}
}
}