Tools

Tools

Every tool exposed by the server, over MCP and over the REST gateway (POST /tools/{tool-name}). The live catalog with full input schemas is always available from GET /tools on a running server, or from the tools tool itself.

All term_id parameters are optional and default to the current academic term.

Tool Discovery (for the cli)

Tool	Params	What it does
tools	names (optional, comma-separated)	Discover available tools. Without names, returns all tools. With names, returns only matching tools by name. Includes each tool's description and input schema.

Dashboard

Tool	Params	What it does
get-overview	—	Start here. Dashboard of what's actionable right now: today's schedule, per-course new items (docs, announcements, assignments, grades) with delta tracking, new MIO messages, upcoming evals, notifications, and featured college news.
get-terms	—	List available terms with the current default.

Courses & Grades

Tool	Params	What it does
get-courses-summary	—	All courses with counts and totals. Returns course_id values. Delta tracked.
get-course-info	course_id	One course — teacher names, course code, group. No grades (use get-course-evals).
get-grades-summary	—	Marks, class averages, remaining weight across all courses. Delta tracked.
get-course-evals	course_id	Full eval breakdown — marks, weights, class stats, bonus/penalty adjustments, teacher comments. Ungraded evals appear as "not graded yet". Incomplete: evals the teacher hasn't entered in Léa won't appear; reconcile with the syllabus.
get-course-announcements	course_id	Teacher announcements for a course.
get-absences	—	Absence records for all courses. Delta tracked.
get-teachers	—	All teachers with contact info. Prefer get-course-people for per-course.

Documents

Tool	Params	What it does
get-course-documents	course_id	List documents. Returns document_id values.
get-document-link	course_id, document_id	Downloads a document locally and returns the file path. Marks it as read on Omnivox.

Assignments

Tool	Params	What it does
get-assignments-summary	—	Per-course assignment overview. Delta tracked.
get-course-assignments	course_id	List assignments. Returns assignment_id values. Incomplete: many teachers never post assignments here — always cross-check the syllabus via get-course-documents.
get-assignment-detail	course_id, assignment_id	Full details — instructions, submissions, corrections. Returns file_id values.
get-assignment-file-link	course_id, assignment_id, file_id, role	Download an assignment file. role: teacher_document, submission, or correction.
get-assignment-submit-link	course_id, assignment_id	Short link (15 min) that opens the Omnivox hand-in page, already logged in. The user uploads the file themselves — the tool never submits anything. Fails if online submission is closed for that assignment.

Schedule & Calendar

Tool	Params	What it does
get-calendar	page, range	Real day-by-day schedule with holidays, day swaps, cancelled classes, and deadlines. range: today, week, month, or all (default). Paginated via page (0-indexed). Incomplete for deadlines: exam and assignment dates only show up if the teacher entered them — read the syllabus for the full picture.
get-schedule	—	Static weekly timetable. Does not reflect holidays or day swaps.
get-cancelled-classes	—	Upcoming cancelled class sessions with teacher notes.

Messaging (MIO)

Tool	Params	What it does
get-mio-folders	—	Folders with unread counts. Delta tracked.
get-mio-messages	folder_id, last_id, count	Messages from a folder (defaults to inbox). Returns 21 at a time (max 100 via count). Paginate with last_id.
read-mio-message	message_id, folder_id, mark_read	Full message content. mark_read sends a read receipt (default false). folder_id defaults to inbox.
search-mio-messages	query, folder_id	Full-text search. Searches all folders by default, or a specific one via folder_id.
get-mio-attachment-link	message_id, attachment_id	Download a MIO attachment.
get-course-people	course_id	Students and teachers in a course. Returns recipient IDs.
search-people	query	Search anyone by name. Returns recipient IDs.
send-mio-message	recipient_id, subject, message, hide_recipients	Sends a real message. Confirm with user first. recipient_id supports arrays. hide_recipients (default false) hides recipients from each other (BCC).
flag-mio-message	message_id, important, mark_unread	Flag or mark as unread.
move-mio-message	message_id, folder_id	Move to another folder.
delete-mio-message	message_id	Move to trash (not permanent). Supports arrays.
restore-mio-message	message_id	Restore from trash. Supports arrays.
create-mio-folder	name	Create a new folder.

College

Tool	Params	What it does
get-college-news	—	College news and announcements.
get-college-list	—	Get the user's college name.