cmu-soc
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Tools for querying Carnegie Mellon's public Schedule of Classes (SOC), refreshed nightly. Typical flow: list_semesters -> list_departments -> search_courses (a department's courses) -> get_course_details (sections, recitations, minis, meeting days/times, delivery mode). get_course_info adds the SOC's prerequisite/corequisite expressions, notes, reservations and description; get_final_exams checks the registrar's final-exam schedule (only the current semester is ever published, around week 6); get_course_description reads the current undergraduate catalog; estimate_walk_time and list_buildings estimate walking time between buildings from rooms like 'GHC 4401'. CMU does NOT publish seats, waitlists, rooms or instructors publicly: never invent them; students see them in SIO.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_semestersA | Semesters currently published in the CMU Schedule of Classes, newest first, with codes (S = Spring, F = Fall, M = Summer; e.g. S27 = Spring 2027). |
| list_departmentsA | Every department in the Schedule of Classes with its code (CS, MSC, ECE, ...) and the two-digit course-number prefix it owns (CS = 15, MSC = 21). |
| search_coursesA | Every course a department offers in a semester: course number, title and units. Seat availability is not public at CMU, so there is no open/waitlist filter. For sections and times of one course use get_course_details. |
| get_course_detailsA | Every section of one course in a semester: lectures with their nested recitations/labs, mini (1-6; minis 1/3/5 are the first half of the semester, 2/4/6 the second), and each meeting's days, begin/end time, campus and delivery mode. Extra meetings (e.g. an evening exam slot) appear as additional meetings of the same section. Seats, waitlists, rooms and instructors are not published publicly. |
| get_course_infoA | The Schedule of Classes detail page for one course in a semester: description, prerequisite and corequisite expressions as the SOC states them (e.g. '15112 or 02120') plus the course numbers they mention, cross-listed courses, whether special permission is required, notes, per-section reservations (seats held for certain students), and related URLs. |
| get_final_examsA | Final exams from the University Registrar's published schedule for several courses at once (e.g. ["15-122", "21-127 A", "15-213 Lec 1"]): date, day, time, exam room, delivery mode, status and instructors. A recitation input also returns its lecture's exam. The registrar only publishes the current semester, around week 6; for any other semester the result says published:false. A course with no row is 'none listed', not proof of no final. |
| get_course_descriptionA | The current CMU Undergraduate Catalog entry for a course: title, semesters usually offered, units, description, prerequisites (with minimum grades, e.g. '15-112 Min. grade C'), corequisites and course website. Term-independent. Only the current catalog year is available, and graduate courses are often absent; get_course_info covers any offered course. |
| estimate_walk_timeA | Offline estimate of the walk between two CMU Pittsburgh buildings. Accepts room strings ("GHC 4401", "DH A302", "Wean Hall 7500") or bare building names/codes. Rooms are not in the public schedule, so they come from the student (SIO). Straight-line distance between building centroids x 1.4 for real paths, at 80 m/min: for spotting tight passing periods, not navigation. |
| list_buildingsA | Every CMU building estimate_walk_time knows, with the Schedule of Classes building code, alternate names and approximate coordinates (© OpenStreetMap contributors, ODbL). |
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 9 tools
Most tools have crisp, distinct scopes (semesters, departments, buildings, exams, walk time), and descriptions explicitly redirect between related tools (search_courses → get_course_details). The one soft spot is the trio get_course_details / get_course_info / get_course_description, where 'info' vs 'description' vs 'details' cover overlapping metadata (description, prereqs, coreqs) and rely on subtle distinctions like catalog-year vs offered-course coverage to be told apart.
Every name follows a clean verb_noun snake_case pattern: list_buildings, list_semesters, list_departments, search_courses, get_course_details, get_final_exams, estimate_walk_time. Verbs are used consistently by intent (list = reference data, get = single-entity detail, search = query), with no camelCase or style drift.
Nine tools sit comfortably in the well-scoped 3-15 range, and each maps to a concrete step in the workflow: resolve semester/department → search courses → drill into sections/info/catalog → check finals. The walk-time pair (estimate_walk_time + list_buildings) is a justified adjunct that its companion tool supports directly.
The surface covers the full course-research lifecycle: semesters, departments, course search, section times, catalog prereqs, and final exams, with explicit notes that seats and rooms are not public and therefore not gaps. The main missing operation is a cross-department or title-based course search — search_courses is department-scoped — plus no lookup for cross-listed course equivalence beyond what get_course_info returns.