PLATO MCP

io.github.jin-1119Published by GitHub account jin-1119v0.1.0Updated Oct 29, 2026

PLATO (Pusan National University LMS) MCP server via Moodle Web Service API + ubboard scraping

VerifiedStreamable HTTPWeb executableProductivity & Workflow Files & Storage Communication & Collaboration

Server details

Identifier: io.github.jin-1119/plato-mcp
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Oct 29, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account jin-1119 for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.jin-1119%2Fplato-mcp.svg)](https://sourceweft.com/mcp/io.github.jin-1119%2Fplato-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Unofficial MCP server for Pusan National University's PLATO (Moodle) LMS, letting an assistant read courses, assignments, grades, notices and Q&A, and submit…

What you can do: List enrolled courses, course contents, weekly materials and downloadable course files
List assignments with due dates, read assignment details and submission status, submit or withdraw submissions
Read grades per course and per item, course and activity completion status, and upcoming action items
Read calendar events, unread notification counts, notices and Q&A posts, and post Q&A questions
Browse quizzes and attempts, start attempts and save or submit answers, and read standard Moodle forums
When to use it: Useful for PNU students who want an assistant to answer questions like what is due this week, what their grades are, or to fetch lecture materials and notices from PLATO without opening the site manually.
Requirements: Remote Streamable HTTP endpoint; no local install needed. Requires a PLATO (Moodle) account, supplied as the pnu_id and pnu_password headers or connector settings. Network access to the hosted server and to PLATO.

Before you install

Sends PLATO login credentials to a third-party hosted server; the README says they are not written to disk but are not independently audited. Content, including other students' names and Q&A posts, is passed to the AI provider. Write tools (submit assignment, withdraw submission, post Q&A, calendar, quiz attempts) are irreversible once confirmed. Remote file downloads return links containing a live PLATO token that can authenticate other API calls. Quiz tools are untested against real quizzes…

Installation

In SourceWeft

Open PLATO MCP in the dashboard and add it to a workspace.
Connect Custom headers credentials. They are stored privately and never shown on public pages.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.jin-1119%2Fplato-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "plato": {
      "type": "http",
      "url": "https://plato-mcp.onrender.com/mcp",
      "headers": {
        "pnu_id": "<VALUE>",
        "pnu_password": "<VALUE>"
      }
    }
  }
}

README

plato-mcp

🔗 설치 가이드 페이지 — 학번/비밀번호만 입력하면 Claude.ai, Claude Code, Codex CLI용 연결 명령어를 바로 만들어 드립니다.

[License: AGPL v3] [Python 3.11+] [Status: WIP] [Unofficial]

부산대학교(PNU)의 무들(Moodle) 기반 LMS인 PLATO(https://plato.pusan.ac.kr/)를 위한 비공식 MCP(Model Context Protocol) 서버입니다. Claude 같은 AI 어시스턴트가 여러분을 대신해 PLATO에 로그인하지 않고도, 여러분이 이미 접근 권한을 가진 강좌 자료·공지·과제·성적·Q&A를 조회·작성·다운로드할 수 있게 해 줍니다.

아직 개발 중입니다. 전체 구현 계획은 PLAN.md를, 현재 진행 상황은 GitHub Issues / Project 보드를 참고하세요.

이 서버는 새로운 권한을 부여하지 않습니다. 여러분의 PLATO 학번·비밀번호로 인증하며, 브라우저로 직접 열람할 때 볼 수 있는 것만 볼 수 있습니다 — 다만 그 내용이 AI와의 대화로 흘러 들어간다는 차이가 있습니다. 시작하기 전에 아래 면책조항과 개인정보 안내를 반드시 읽어 주세요.

시작하기

이 프로젝트는 두 부류의 독자를 대상으로 합니다 — 그냥 써보고 싶은 일반 사용자와 코드를 고치거나 기여하고 싶은 개발자. 아래에서 본인에게 맞는 쪽을 고르세요.

일반 사용자 — 그냥 써보고 싶다면

코드를 내려받거나 서버를 직접 실행할 필요가 없습니다. 이 서버는 공식 MCP Registry에 io.github.jin-1119/plato-mcp로 등록되어 있고, 실제 주소는 https://plato-mcp.onrender.com/mcp(Streamable HTTP)입니다.

Smithery 마켓플레이스는 더 이상 쓰지 않습니다 — Smithery가 신규 외부 서버 등록을 막고 2026-10-31에 전체 서비스를 종료하면서, 공식 레지스트리로 옮겼습니다. 자세한 배경은 docs/smithery_deployment_model.md를 참고하세요.

사용 중인 MCP 클라이언트에서 아래 주소를 원격(remote) MCP 서버로 추가합니다:
- Claude.ai / Claude Desktop: 설정 → Connectors → Add custom connector → URL에 https://plato-mcp.onrender.com/mcp 입력.
- Claude Code: claude mcp add --transport http plato-mcp https://plato-mcp.onrender.com/mcp
- MCP Registry를 직접 검색할 수 있는 클라이언트라면 io.github.jin-1119/plato-mcp로 찾아도 됩니다.
연결 시 PLATO 학번과 비밀번호를 (클라이언트가 지원하는 경우) 커넥터 설정 값으로, 아니면 헤더/쿼리 파라미터(pnu_id, pnu_password)로 입력합니다. 이 값은 서버 디스크에 저장되지 않으며, 요청을 처리하는 동안만 메모리에 존재합니다 — 자세한 내용은 SECURITY.md를 확인하세요.
연결되면 AI 어시스턴트에게 자연어로 요청하면 됩니다. 예:
- "이번 주에 제출해야 할 과제가 뭐가 있어?"
- "이번 학기 성적 알려줘"
- "OO 과목 3주차 강의자료 다운로드해줘"
- "OO 과목 공지사항 최근 것부터 보여줘"

시작하기 전에 반드시 아래 면책조항과 개인정보 안내를 읽어 주세요. 특히 과제 제출·Q&A 등록처럼 되돌릴 수 없는 동작(✏️ 표시)은 실행 전 미리보기 확인을 거치도록 되어 있습니다.

직접 배포해 보고 싶다면 docs/smithery_publish_guide.md의 비전공자용 단계별 가이드를 참고하세요.

개발자 — 코드를 고치거나 기여하고 싶다면

버그 수정, 새 도구 추가, 문서 개선 등 기여를 환영합니다. 이슈/브랜치/PR을 이 저장소가 실제로 어떻게 운영하는지는 CONTRIBUTING.md에 정리되어 있습니다 — PR을 보내기 전에 먼저 읽어 주세요. 로컬 개발 환경 설정은 바로 아래 개발 환경 설정 섹션을 참고하세요.

제공하는 도구 (MCP Tools)

공식 Moodle webservice API로 동작하는 도구와, ubboard(공지/Q&A) HTML을 본인 세션으로 스크레이핑하는 도구로 나뉩니다. 쓰기 도구(✏️)는 실행 전 확인 절차를 거칩니다 (자세한 내용은 docs/write_confirmation_pattern.md). PLATO가 실제로 제공하는 439개 Moodle API 함수 전체를 이 MCP가 어떻게 다뤘는지(구현/중복/ 비활성화/권한없음/미구현 사유)는 docs/moodle_api_coverage.md 참고.

강좌 / 과제 / 성적 / 일정 / 쪽지 — 공식 API

list_courses — 수강 중인 강좌 목록
get_course_contents — 강좌 콘텐츠(주차별 자료 등)
get_course_updates_since — 강좌 변경사항 감지 (표준 Moodle 모듈만 — ubfile/ubboard/vod는 변경감지 콜백 미구현, 포함 안 됨)
get_course_module — cmid로 모듈 직접 조회
search_courses — PLATO 전체 강좌 카탈로그 검색 (수강 중인 강좌만이 아님)
get_recent_courses — 최근 접속한 강좌 목록
get_recent_items — 최근 열어본 강의자료/활동 목록 (강좌 단위가 아닌 모듈 단위)
get_starred_courses — 즐겨찾기한 강좌 목록
list_video_conferences — 화상강의(BigBlueButton) 조회 (참여 기능은 미지원, 실사용 사례 없는 forward-looking 기능)
list_lessons — Lesson 활동 조회 (응시 기능은 미지원, 실사용 사례 없음)
list_workshops — Workshop(상호평가) 활동 조회 (제출/평가 기능은 미지원, 실사용 사례 없음)
list_feedbacks — Feedback(설문) 활동 조회 (응답 기능은 미지원, 실사용 사례 없음)
list_choices / list_surveys — Choice(투표)/Survey 활동 조회 (응답 기능은 미지원, 실사용 사례 없음)
list_scorms / list_h5p_activities — SCORM/H5P 패키지 콘텐츠 조회 (실행/추적 기능은 미지원, 실사용 사례 없음)
list_glossaries — Glossary(용어집) 조회 (항목 읽기/쓰기는 미지원, 실사용 사례 없음)
list_database_activities — Database 활동 조회 (항목 읽기/쓰기는 미지원, 실사용 사례 없음)
list_wikis / list_chats — Wiki/실시간 채팅 활동 조회 (읽기/쓰기는 미지원, 실사용 사례 없음)
get_user_profile — 사용자 프로필 조회 (같은 강좌 수강생만, 전체 검색 아님)
get_private_files_info / add_private_file ✏️ — 개인파일 영역 조회/업로드 (⚠️ 삭제 도구 없음, 실제 삭제는 PLATO 웹에서)
get_user_preferences — 사용자 환경설정 조회 (대부분 내부 UI 상태값)
get_my_course_groups — 강좌 내 소속 그룹 조회
get_enrolled_users — 강좌 수강생 명단 조회 (PLATO 참가자 목록과 동일 정보)
list_assignments — 과제 목록
get_assignment_detail — 과제 상세
submit_assignment ✏️ — 과제 제출
remove_submission ✏️ — 과제 제출 철회 (⚠️ 실제 실행 경로는 아직 PLATO에서 invalidparameter 오류 발생, 미리보기만 동작 확인됨)
get_grades — 성적 조회
get_grades_access_info — 이 계정의 성적 조회 권한 확인 (전체 열람 권한 등)
list_calendar_events — 캘린더 일정
get_calendar_access_info — 캘린더 관리 권한 확인
create_calendar_event / delete_calendar_event ✏️ — 개인 캘린더 일정 생성/삭제 (본인 소유 개인 일정만 가능, 강좌/그룹 일정은 불가)
get_unread_messages / get_unread_notification_count — 안 읽은 쪽지 (⚠️ PLATO는 1:1 메시징/대화 기능이 사이트 전체에서 비활성화되어 있음 — 알림만 동작)
get_course_completion_status — 강좌 단위 이수 현황 (이수 기준이 설정된 강좌만)
get_activity_completion_status — 강좌 내 활동/자료별 이수 현황 (동영상 강의 시청률 포함)
get_upcoming_action_events — 마감 임박한 할 일(과제/시청 기한 등) 통합 조회
get_courses_by_timeline — 진행 중/예정/종료 강좌 필터링
get_grades_overview — 전체 강좌 종합 성적 한 번에 조회
list_quizzes / get_quiz_attempts / get_quiz_best_grade — 퀴즈 조회
get_quiz_access_information / get_quiz_required_qtypes / get_quiz_feedback_for_grade / get_quiz_combined_review_options — 퀴즈 응시 전 확인용 조회 (⚠️ 응답 형태 미검증 — 실제 퀴즈가 있는 강좌가 없어서 파라미터만 라이브로 확인됨)
start_quiz_attempt / get_quiz_attempt_data / save_quiz_attempt_responses / process_quiz_attempt / get_quiz_attempt_summary / get_quiz_attempt_review ✏️ — 퀴즈 응시 흐름 (⚠️ 전체 미검증, 실제 퀴즈로 끝까지 테스트된 적 없음 — 사용 전 반드시 재검증 권장)
list_forums / get_forum_discussions / get_discussion_posts — 표준 Moodle 포럼 조회 (PLATO 자체 공지/Q&A인 ubboard와는 다른 모듈)
add_discussion / add_discussion_post ✏️ — 포럼 글쓰기/답글

공지사항 / Q&A(ubboard) — 로그인 세션 스크레이핑

list_notices — 공지사항 목록
get_notice_detail — 공지사항 상세
list_qna — Q&A 게시글 목록
get_qna_detail — Q&A 게시글 상세
post_qna_question ✏️ — Q&A 질문 등록

파일

download_course_file — 강좌 첨부파일 다운로드 (원격 실행 시 링크 반환, 위 개인정보 안내 참고)

아키텍처

src/plato_mcp/├── server.py            # FastMCP 앱, tool 등록 진입점├── config.py            # Smithery config 스키마 (pnu_id, pnu_password, ...)├── auth.py              # 세션별 wstoken + requests.Session 쿠키 in-memory 캐시├── moodle_client.py     # webservice/rest/server.php 범용 REST 호출 래퍼├── ubboard/│   ├── scraper.py       # list_notices/get_notice_detail/list_qna/get_qna_detail│   ├── writer.py        # post_qna_question (sesskey 처리)│   └── parser.py        # BeautifulSoup 파싱├── files.py             # download_course_file├── tools/                # MCP tool 등록 (courses/assignments/grades/calendar/messages/notices_qna/downloads)├── models.py              # pydantic 응답 스키마├── errors.py               # 타입 예외 (AuthError, MoodleAPIError, ScrapeError, RateLimitError)└── security.py              # 로그/자격증명 마스킹, rate limiting

src/plato_mcp/├── server.py            # FastMCP 앱, tool 등록 진입점├── config.py            # Smithery config 스키마 (pnu_id, pnu_password, ...)├── auth.py              # 세션별 wstoken + requests.Session 쿠키 in-memory 캐시├── moodle_client.py     # webservice/rest/server.php 범용 REST 호출 래퍼├── ubboard/│   ├── scraper.py       # list_notices/get_notice_detail/list_qna/get_qna_detail│   ├── writer.py        # post_qna_question (sesskey 처리)│   └── parser.py        # BeautifulSoup 파싱├── files.py             # download_course_file├── tools/                # MCP tool 등록 (courses/assignments/grades/calendar/messages/notices_qna/downloads)├── models.py              # pydantic 응답 스키마├── errors.py               # 타입 예외 (AuthError, MoodleAPIError, ScrapeError, RateLimitError)└── security.py              # 로그/자격증명 마스킹, rate limiting

인증 흐름: 세션 시작 시 login/token.php로 wstoken을 발급받아 메모리에 캐시합니다. ubboard(공지/Q&A) 접근 시에만 추가로 쿠키 로그인을 수행해 sesskey를 스크레이핑합니다. 어떤 경우도 디스크에 저장하지 않습니다. 배경이 된 사전 조사는 PLATO_MCP_사전조사.md, 전체 로드맵은 PLAN.md를 참고하세요.

개발 환경 설정 (기여자용)

아래는 이 프로젝트의 코드를 수정/기여하려는 개발자용 명령어입니다. PLATO를 그냥 써보고 싶은 일반 사용자는 몰라도 되는 내용이며, 실행해도 PLATO 계정에 연결되지 않습니다 — 코드와 테스트 도구(pytest, ruff 등)를 내 컴퓨터에 설치할 뿐입니다.

사전 요건

Python 3.11+
로컬 개발/테스트에는 실제 PLATO 계정이 필요 없습니다 (테스트는 mock 기반)

면책조항

부산대학교(PNU) 또는 PLATO/무들 플랫폼과 아무런 제휴 관계가 없으며, 이들의 승인을 받지 않았습니다. 이 프로젝트는 여러분이 이미 브라우저로 하고 있는 것과 동일한 PLATO 계정 접근을 자동화하는 독립적인 커뮤니티 프로젝트입니다 — 새로운 권한을 부여하지 않으며 PNU를 대신해 어떠한 행위도 하지 않습니다.
모든 사용은 본인 책임이며, PNU의 이용약관을 준수해야 합니다. 특히 공지사항/Q&A 게시판(ubboard)은 공식 API가 없어 로그인된 본인 세션으로 렌더링된 HTML을 직접 스크레이핑하는데, 이 사이트의 robots.txt는 Disallow: /를 명시하고 있습니다. 이 지침은 익명 크롤러를 겨냥한 것이며 인증된 사용자 본인의 열람 행위를 겨냥한 것은 아니지만, 그래도 스크레이핑인 것은 사실입니다. 이 서버를 계정에 연결하기 전에 본인 계정에 대한 PNU의 acceptable-use 정책에 부합하는지 확인할 책임은 사용자에게 있습니다. 권장 사용 방식은 개인적·저빈도 사용이며, 사이트 전체를 대상으로 한 자동 대량 스크레이핑은 권장하지 않습니다.
PLATO 로그인 정보는 이 서버에 의해 디스크에 영구 저장되지 않습니다. 무엇이, 얼마나 오래 저장/보관되는지 정확한 내용은 SECURITY.md를 참고하세요.
이 프로젝트는 제3자에 의한 독립적인 보안 감사를 받지 않았습니다. 개발 과정에서 자체적으로 여러 자격증명 처리·오남용 방지 이슈를 발견하고 수정했습니다 (docs/security_audit.md, docs/abuse_prevention_review.md 참고) — 하지만 스스로 찾아 고친 것은 외부 감사와 같은 수준의 보증이 아닙니다.

개인정보 안내

이 서버는 강좌 콘텐츠를 그대로 전달합니다 — Q&A 게시판의 경우 다른 학생들의 이름과 게시글도 포함됩니다. 이는 본인 계정이 PLATO를 통해 이미 정당하게 접근할 수 있는 내용이며, 이 도구가 새로운 접근 권한을 부여하는 것은 아닙니다. 브라우저로 PLATO를 직접 열람할 때와 다른 점은, 이 내용이 AI 어시스턴트와 나누는 대화의 일부가 된다는 것입니다. 즉 도구 출력으로서 해당 AI/LLM 제공업체(예: Anthropic)에 전송됩니다. 강좌 Q&A 게시판을 대상으로 폭넓은 질문을 하기 전에 이 점을 유념하세요.

전체 검토 내용과 알려진 미해결 사항(PLATO가 Q&A 게시글의 "비공개/강사 전용" 플래그를 서버 측에서 실제로 강제하는지 — 즉 이 도구가 그런 게시글을 애초에 볼 수 없는지 — 여부는 아직 실증적으로 검증되지 않았습니다)은 docs/pii_review.md에서 확인할 수 있습니다.

원격으로 실행할 경우 (로컬 Claude Code/Desktop이 아니라 Claude.ai 커넥터 등을 통해 실행하는 경우), 인라인 전송 크기 제한을 초과하는 큰 파일에 대해 download_course_file은 파일 자체가 아니라 다운로드 링크를 반환하며, 이 링크에는 살아있는 PLATO 액세스 토큰이 포함되어 있습니다. 이 토큰은 해당 파일 하나에만 한정되지 않습니다 — 실제로 확인해 본 결과 본인 계정에 대한 임의의 PLATO API 호출을 인증하는 데 사용할 수 있었습니다. 이 링크나 이 링크가 포함된 대화 기록을 공유하는 것은 파일 하나를 공유하는 것이 아니라 계정에 대한 활성 자격증명을 공유하는 것과 같습니다. 자세한 내용은 SECURITY.md와 docs/smithery_deployment_model.md를 참고하세요.

Lint: ruff check .
이슈/보드 운영 방식은 PLAN.md를 참고하세요.
기여 방법은 CONTRIBUTING.md를 참고하세요.

라이선스

AGPL-3.0입니다. 이 서버(또는 수정본)를 네트워크 서비스로 돌려 다른 사람에게 제공하는 경우, AGPL에 따라 해당 소스코드도 함께 공개해야 합니다.

Source: README.md at commit 5aa904e

Tools

list_courses

List the courses the logged-in PLATO account is enrolled in.

Takes no parameters.

get_course_contents

Get a course's weekly sections, modules, and file links.

Parameterscourse_idrequired

list_assignments

List assignments across one or more courses, with due dates.

Parameterscourse_idsrequired

get_assignment_detail

Get one assignment's details and this account's submission status.

Parameterscourse_idrequiredassignment_idrequired

submit_assignment

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.

Parameterstextdry_runcourse_idrequiredfile_pathsassignment_idrequiredfile_contents

remove_submission

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.

Parametersdry_runcourse_idrequiredassignment_idrequired

get_grades

Get this account's grade items for a course, if visible.

Parameterscourse_idrequired

get_grades_access_info

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.

Parameterscourse_idrequired

list_calendar_events

List upcoming calendar events within the next `days_ahead` days.

Parametersdays_ahead

get_calendar_access_info

Check this account's calendar-management permissions -- a student account can typically manage its own personal entries only, not course/group entries.

Takes no parameters.

create_calendar_event

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.

Parametersnamerequireddry_runtimestartrequireddescriptionduration_seconds

delete_calendar_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.

Parametersdry_runevent_idrequired

get_unread_messages

Get this account's unread PLATO notifications.

Parameterslimit

get_unread_notification_count

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.

Takes no parameters.

list_notices

List announcements posted to a course's Notices board.

Parameterscourse_idrequired

get_notice_detail

Get the full text of one notice/announcement.

Parameterspost_idrequiredcourse_idrequired

list_qna

List questions posted to a course's Q&A board.

Parameterscourse_idrequired

get_qna_detail

Get one Q&A question's text. Does not include replies -- see issue #23.

Parameterspost_idrequiredcourse_idrequired

post_qna_question

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.

Parametersdry_runsubjectrequiredcourse_idrequiredcontent_textrequired

download_course_file

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.

Parametersfile_urlrequiredsave_path

get_course_completion_status

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.

Parameterscourse_idrequired

get_activity_completion_status

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.

Parameterscourse_idrequired

get_upcoming_action_events

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.

Parameterslimit

get_courses_by_timeline

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.

Parametersclassification

get_grades_overview

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.

Takes no parameters.

list_quizzes

List quizzes across one or more courses.

Parameterscourse_idsrequired

get_quiz_attempts

Get this account's past attempts at one quiz.

Parametersquiz_idrequired

get_quiz_best_grade

Get this account's best grade on one quiz, if any attempt has been graded.

Parametersquiz_idrequired

get_quiz_access_information

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.

Parametersquiz_idrequired

get_quiz_required_qtypes

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.

Parametersquiz_idrequired

get_quiz_feedback_for_grade

Get the grade-boundary feedback text configured for a quiz at a given grade (e.g. 'You passed!' / 'Please review chapter 3').

Parametersgraderequiredquiz_idrequired

get_quiz_combined_review_options

Check which review details (marks, feedback, right answers) this account is allowed to see for a quiz's attempts.

Parametersquiz_idrequiredattempt_id

start_quiz_attempt

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.

Parametersdry_runquiz_idrequired

get_quiz_attempt_data

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.

Parameterspageattempt_idrequired

get_quiz_attempt_summary

Get a summary of all questions in an attempt (answered/ unanswered), across all pages. UNVERIFIED against a real quiz.

Parametersattempt_idrequired

get_quiz_attempt_review

Get the grade and per-question review for a finished quiz attempt. UNVERIFIED against a real quiz.

Parameterspageattempt_idrequired

save_quiz_attempt_responses

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.

Parameterspagedry_runresponsesrequiredattempt_idrequired

process_quiz_attempt

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.

Parametersdry_runresponsesrequiredattempt_idrequiredfinish_attempt

list_forums

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.

Parameterscourse_idsrequired

get_forum_discussions

List discussion threads in one standard Moodle forum.

Parametersforum_idrequired

get_discussion_posts

Get all posts in one forum discussion thread.

Parametersdiscussion_idrequired

add_discussion

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.

Parametersdry_runmessagerequiredsubjectrequiredforum_idrequired

add_discussion_post

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.

Parametersdry_runmessagerequiredsubjectdiscussion_idrequired

get_course_updates_since

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.

Parameterssincerequiredcourse_idrequired

get_course_module

Resolve a single course module by its id directly, without fetching and filtering the whole course's contents.

Parameterscmidrequired

search_courses

Search PLATO's entire course catalog by name -- not limited to this account's enrolled courses (use list_courses for that).

Parameterssearch_textrequired

get_recent_courses

Get this account's recently-accessed courses, most recent first.

Takes no parameters.

get_recent_items

Get this account's recently-accessed course modules (files, assignments, etc.) across all courses, most recent first.

Takes no parameters.

get_starred_courses

Get this account's starred/favourited courses, if any.

Takes no parameters.

list_lessons

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.

Parameterscourse_idsrequired

list_workshops

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.

Parameterscourse_idsrequired

list_feedbacks

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.

Parameterscourse_idsrequired

list_choices

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.

Parameterscourse_idsrequired

list_surveys

List Survey activities across one or more courses. Answering is not supported by this server -- this tool is read-only coverage only.

Parameterscourse_idsrequired

list_scorms

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.

Parameterscourse_idsrequired

list_h5p_activities

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.

Parameterscourse_idsrequired

list_glossaries

List Glossary activities across one or more courses. Reading/ adding entries is not supported by this server -- this tool is read-only coverage only.

Parameterscourse_idsrequired

list_database_activities

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.

Parameterscourse_idsrequired

list_wikis

List Wiki activities across one or more courses. Reading/ editing pages is not supported by this server -- this tool is read-only coverage only.

Parameterscourse_idsrequired

list_chats

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.

Parameterscourse_idsrequired

get_user_profile

Get a user's profile, scoped to a shared course (not a global user search -- see docs/pii_review.md).

Parametersuseridcourse_idrequired

get_private_files_info

Get a summary (file/folder count, total size) of this account's Moodle private files area.

Takes no parameters.

get_user_preferences

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.

Takes no parameters.

add_private_file

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.

Parametersdry_runfile_pathrequired

get_my_course_groups

Get the groups this account belongs to within a course, if any.

Parameterscourse_idrequired

get_enrolled_users

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.

Parameterscourse_idrequired

Version history

v0.1.0LatestOct 29, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

PLATO MCP

Overview

Installation

In SourceWeft

Use with an agent

Other MCP clients

README

plato-mcp

시작하기

일반 사용자 — 그냥 써보고 싶다면

개발자 — 코드를 고치거나 기여하고 싶다면

제공하는 도구 (MCP Tools)

아키텍처

개발 환경 설정 (기여자용)

면책조항

개인정보 안내

라이선스

Tools

list_courses

get_course_contents

list_assignments

get_assignment_detail

submit_assignment

remove_submission

get_grades

get_grades_access_info

list_calendar_events

get_calendar_access_info

create_calendar_event

delete_calendar_event

get_unread_messages

get_unread_notification_count

list_notices

get_notice_detail

list_qna

get_qna_detail

post_qna_question

download_course_file

get_course_completion_status

get_activity_completion_status

get_upcoming_action_events

get_courses_by_timeline

get_grades_overview

list_quizzes

get_quiz_attempts

get_quiz_best_grade

get_quiz_access_information

get_quiz_required_qtypes

get_quiz_feedback_for_grade

get_quiz_combined_review_options

start_quiz_attempt

get_quiz_attempt_data

get_quiz_attempt_summary

get_quiz_attempt_review

save_quiz_attempt_responses

process_quiz_attempt

list_forums

get_forum_discussions

get_discussion_posts

add_discussion

add_discussion_post

get_course_updates_since

get_course_module

search_courses

get_recent_courses

get_recent_items

get_starred_courses

list_video_conferences

list_lessons

list_workshops

list_feedbacks

list_choices

list_surveys

list_scorms

list_h5p_activities

list_glossaries

list_database_activities

list_wikis

list_chats

get_user_profile