UofT Timetable Builder MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| UV_HTTP_TIMEOUT | No | Optional HTTP timeout in seconds for uv when downloading the package (e.g., "300"). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| save_timetableA | Store a serialized Timetable Builder state and return a public share URL. timetable must be the TTB state object with sessions, timetables, and plans. The wrapper posts the official ttb.utoronto.ca URL for that state and returns the upstream share id plus a https://ttb.utoronto.ca/#!/?t= link. This creates an anonymous share record only; it does not enroll students. |
| uoft_loginA | Start official UofT browser login, returning immediately while you complete Duo. service is degree_explorer, acorn, or both. Saved sessions are reused when valid. UofT requires a separate sign-in per service, so both means two logins in one window. Newly verified browser sessions wait five seconds, recheck access, and save the latest session before continuing or closing. Status stays in_progress during the wait. remember=False starts a fresh memory-only session without deleting saved sessions. Never supply passwords or MFA codes through tools. Check uoft_auth_status for progress. |
| uoft_auth_statusA | Get connection and login progress without exposing credentials or student records. refresh=True checks both services using saved cookies; it never opens a login window. A saved cookie is not proof of a valid session. last_verified is historical, not expiry. Each service reports a plain-language message, a kind, and a next_action. |
| uoft_forget_sessionA | Cancel login and delete this MCP's local sessions and encryption key for both apps. This closes managed authentication resources. It is not university-wide logout. |
| find_coursesA | Search courses by keyword and return short summaries, one per course offering. query matches course codes, titles, and descriptions (for example "machine learning", "MAT135", "CSC3"); each result's matched_in says which. term is a name like "Fall 2026" or "Winter 2027", or F, S, Y; omit it to search every current session. campus is St. George, Mississauga, or Scarborough; division is a code such as ARTSC, APSC, or FIS. Results are alphabetical by code. total counts offerings (a course taught in two terms counts twice); page starts at 1. Use course_info with a code for prerequisites, sections, and meeting times. |
| course_infoA | Get readable course cards: description, prerequisites, sections, and meetings. course_codes are full codes such as CSC148H1 (1 to 8). section_code optionally keeps only F (Fall), S (Winter), or Y (full year) offerings. Returns one card per offering with credits, breadth, plain-text requirements, and sections grouped by type with instructors, meeting times, enrolment, and waitlist. Sections flagged full or cancelled say so; lists are capped per type. The id is the Timetable Builder course id used by generate_timetable. Unknown codes appear under errors. |
| plan_timetableA | Plan a conflict-free timetable from course codes in one call and share it. course_codes are full codes such as CSC148H1; add a term suffix (CSC148H1-F) when a course runs in more than one term, or set term to F, S or Y for all of them. The tool finds each course's offering and section types, asks UofT's solver for lectures, tutorials and practicals, and returns the chosen meeting times with a weekly overview. preference is early, balanced or late. blocked_times use weekday names and 24-hour HH:MM times and are preferences the solver may not be able to honour; any broken ones are reported. With share=True (default) it creates a public anonymous ttb.utoronto.ca link (share_url). It does not enrol anyone. |
| uoft_discoverB | Find read operations locally; request schemas before calling unfamiliar operations. |
| uoft_readD | Batch discovered reads with optional selection. Snapshot handles last five minutes. |
| uoft_resultB | Select or page a snapshot without network access. Refetch when the handle expires. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Most tools target distinct actions, but plan_timetable and save_timetable both create public share links, and the generic uoft_read/uoft_result discovery tools overlap conceptually with find_courses and course_info. An agent could reasonably hesitate between the specific domain reads and the generic batched-read interface.
All names use snake_case, but the set mixes a uoft_-prefixed auth/meta namespace (uoft_login, uoft_auth_status, uoft_read) with unprefixed domain tools (find_courses, plan_timetable). Verb/noun patterns are also mixed, with course_info being a noun while most others are verb_noun.
Ten tools is a reasonable size for a timetable-builder server, covering authentication, discovery, planning, and sharing. The three generic discovery/read/result tools add some surface area that may be infrastructure-heavy relative to the core workflow.
The core lifecycle is well covered: login/status/session cleanup, course search, detailed course info, timetable planning, and sharing. Minor gaps remain around managing or retrieving previously saved timetable states and around degree-explorer capabilities hinted at in the login tool.