Open ONE announcement and read its thread — the original post plus any replies — given a discussion_id from list_announcements.

Posts are oldest-first; limit/offset paginate long threads.

Returns {discussion_id, total, posts:[{post_id, parent_id, subject, author, posted, message}]}. posted is Taipei time 'YYYY-MM-DD HH:MM'.

Credentials come from the MCP settings headers, not from you.

Get everything the teacher posted in one course (by Moodle course id, from list_courses), grouped by section — NCCU names sections by week, so this is the week-by-week list of materials, links, forums and assignments.

The summary is the teacher's text for that section/week (readings, plan, notes) — many NCCU weeks have only a summary and no attached items. By default a section is shown if it has items OR a summary; only truly blank sections are dropped. Set include_empty true for the full week skeleton including blank weeks.

Each section: {section_id, section, summary, modules:[{id, instance, name, type, url}]}. type is the Moodle module (assign, resource, url, forum, quiz, page, folder, label, …); id is the course-module id (cmid) and instance the activity id — use them to open an item with other tools (e.g. an assign instance is the course_id-independent assignment id, a forum instance feeds get_announcement's forum).

Credentials come from the MCP settings headers, not from you.

Get the user's role in one course (by Moodle course id, from list_courses): 'student', 'teacher' (often the TA/助教), 'editingteacher' (instructor), 'teachingassistant', 'manager', etc.

Returns {course_id, role, roles}: role is the primary role shortname, roles all of them (a user can hold more than one).

Credentials come from the MCP settings headers, not from you.

Get the student's own grade items for one course (by Moodle course id, from list_courses).

Each item: {item, grade, percentage, range, feedback, type}. A '-' grade means not yet graded.

Credentials come from the MCP settings headers, not from you.

Open ONE item a teacher posted and return its content, given its cmid (course-module id — the id in a /mod//view.php?id= link, or from get_course_contents). course_id is OPTIONAL — omit it and it's resolved from the cmid, so a bare cmid/link is enough. It detects the item type and returns:

• resource/folder -> files:[{filename, mimetype, size, url}] (open the url/view_url in a browser to download; no direct download here yet)

• url -> external_url

• page -> html (plain text)

• label -> text

• forum -> forum_id + intro + discussions[] (read one with get_announcement)

• assign -> description (instructions), attachments, due/opens/cutoff, grade_max, status, submission{submitted_at,files,text}, feedback{grade,grade_display,graded_at,comment,files}

• quiz -> metadata + attempts · otherwise -> description

Always includes {course_id, cmid, instance, type, name, view_url}.

Credentials come from the MCP settings headers, not from you.

Get the student's Moodle notifications (the notification bell): assignment due reminders, grading, forum posts, etc.

Each notification: {subject, message, posted, read, url}, newest first. limit caps the count. The result also reports how many are unread.

Credentials come from the MCP settings headers, not from you.

List announcement TILES (headers only, no message body) from a course's "Announcements" forum — like scanning the forum page. To read one, take its discussion_id and call get_announcement.

If course_id is given, lists that course's announcements; otherwise aggregates across the current (latest) semester's courses. limit/offset paginate the newest-first list.

Each tile: {discussion_id, course_id, course, subject, author, posted, replies, pinned, url}. posted is Taipei time 'YYYY-MM-DD HH:MM'.

Credentials come from the MCP settings headers, not from you.

List assignments (with due dates and submission status) for the student's courses.

Scope, in priority order:

• course_ids: if given, list assignments for exactly those Moodle course ids (from list_courses); sem is ignored.

• sem: otherwise filter all enrolled courses by NCCU term code. Default (neither given) = latest semester; "1142" = that term; "all" = every course.

Filter by date (ISO dates in Taipei time, e.g. "2026-09-08"): due_from/due_to bound the DUE date, opens_from/opens_to bound the OPEN (submissions-from) date. Give any subset; compute ranges from today for 'due this week', 'opened last week', etc. This is the best way to answer 'what's due/opened in some period', since it also carries submission status.

By default only courses where you are a STUDENT are included (your own homework); set include_all_role true to also include courses where you are a teacher/TA.

Each assignment: {id, course_id, course, role, name, due, opens, cutoff, status, url}, where role is the user's role in that course (student/teacher/…) and status is 'graded' / 'submitted' / 'not submitted'. Times are Taipei time 'YYYY-MM-DD HH:MM'; null means unset. Sorted by due date.

Credentials come from the MCP settings headers, not from you.

List the student's enrolled Moodle courses (with the user's role in each), filtered by semester.

By default (no sem), returns ONLY the latest semester's courses (the current term). Pass sem as an NCCU term code (e.g. "1142") to get that semester; pass "all" to return every enrolled course.

Each course is returned as an object with:

• id (int) Moodle course id, usable in other course tools

• name (str) full course title

• url (str) direct link to the course

• semester (str) NCCU term code the course belongs to (e.g. "1151")

• current (bool) true if it is in the current (latest) semester

• role (str) the user's role: 'student', 'teacher', 'editingteacher', 'teachingassistant', … (null if unknown)

Credentials come from the MCP settings headers, not from you.

Search the user's enrolled courses by keyword — the Moodle app's "filter my courses" box. query is matched as a case-insensitive substring of each course name, which contains the NCCU term code, the Chinese title and the English title — so a course code, a Chinese word or an English word all work (e.g. "物件導向", "Object-oriented", "703009").

Searches ALL enrolled courses across every term by default, so a keyword finds the course whatever semester it is in. Pass sem as a term code (e.g. "1142") to scope the search to one semester, or "latest" for the current term only.

Returns the same fields as list_courses: {id, name, url, semester, current, role}, newest term first. An empty query returns everything in scope (same as list_courses).

Credentials come from the MCP settings headers, not from you.

List the student's upcoming action events (assignment due dates, quiz closings, etc.) across courses within the next days (default 14). This is the best 'what's due soon' overview.

By default only events from courses where you are a STUDENT are included; set include_all_role true to also include courses where you are a teacher/TA. (Personal/site events are always kept.)

Each event: {name, course_id, course, role, due, overdue, module, url}. due is Taipei time 'YYYY-MM-DD HH:MM'. Sorted soonest first.

Credentials come from the MCP settings headers, not from you.