cmu-soc
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@cmu-soc Show me CMU's CS courses for Fall 2026 and their prerequisites"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
UNOFFICIAL CMU Schedule of Classes — MCP Server & Claude Plugin
An MCP (Model Context Protocol) server that lets Claude, or any MCP-capable agent, query Carnegie Mellon's public Schedule of Classes. No login or API key is required. It reads the same pages the SOC website serves, plus the registrar's final-exam schedule and the current undergraduate catalog.
The repo is also a Claude Code plugin (cmu-soc). It bundles the server with a
schedule-planning skill: a guided workflow that confirms the semester, collects the
student's goals and remaining requirements, verifies prerequisites, checks minis,
recitations and final exams, and renders a mock schedule from a fixed template.
A CMU counterpart of ucla-soc-mcp.
Tools
Tool | What it does |
| Semesters published in the SOC ( |
| Every department's code ( |
| Every course a department offers in a semester: number, title, units. Optional |
| Sections of one course: lectures with nested recitations/labs, mini (1–6), and each meeting's days, times, campus and delivery mode. Extra meetings (e.g. evening exam slots) are included |
| The SOC course page: prerequisite/corequisite expressions ( |
| Registrar final exams for several courses at once: date, time, exam room, status, instructors. A recitation input returns its lecture's exam. Says |
| Current Undergraduate Catalog entry: semesters offered, units, description, prerequisites with minimum grades, corequisites, course website |
| Offline walking-time estimate between two buildings, from room strings like |
| The 37 buildings |
Inputs are forgiving:
Semesters accept
S27orSpring 2027.Course numbers accept
15-122,15122, orcs 15-122.Departments accept
CS,Computer Science, or15.
Unknown inputs return errors that list the valid options.
What CMU does not publish
CMU's public schedule has no seat counts, waitlists, rooms or instructors. Students see
those in SIO, which needs a login. The tools never invent them: each section-level result
carries a not_public note. Unlike the UCLA server, there is therefore no open-seat filter,
and walking estimates need rooms the student supplies. Instructors appear only in the final-exam
schedule, as names; Andrew IDs are removed.
Final exams cover the current semester only. The registrar posts them around week 6
(early October in fall, late February in spring), so for the semester being planned they
usually aren't out yet. get_final_exams says that explicitly rather than reporting "no
conflict".
Degree audits
CMU audits live in Stellic, which needs a login and has no documented export format. A Stellic parser (the equivalent of the UCLA plugin's DARS script) is not included yet. For now, the skill asks the student to paste their unmet requirements.
Related MCP server: comsats-timetable-mcp
Setup
Claude Code (plugin — recommended)
The repo is its own plugin marketplace. In Claude Code:
/plugin marketplace add aaditsingh07/cmu-soc-mcp
/plugin install cmu-soc@cmu-soc-mcpNo build step is needed: the plugin ships a self-contained server bundle (dist/bundle.cjs)
that runs on Node 18 or newer. Start planning with /cmu-soc:schedule-planning, or just ask
about CMU classes and Claude will pick the skill up on its own.
Claude Desktop (one-click extension — recommended for Desktop)
Download
cmu-soc.mcpbfrom the latest release.Double-click it, or drag it into Claude Desktop's Settings → Extensions, and click Install. Claude Desktop runs it with its own built-in Node.js, so there's nothing else to install.
(Optional, for the guided planner.) Download
cmu-schedule-planning.zipfrom the same release and upload it in Claude Desktop's Skills settings (Settings → Capabilities → Skills).Ask something like "Plan my Spring 2027 schedule at CMU".
To rebuild both files from source, run npm install && npm run pack:desktop. They are
written to dist/.
Claude Desktop (manual config)
If you'd rather not use the extension, add this to claude_desktop_config.json
(Settings → Developer → Edit Config), using the absolute path to dist/bundle.cjs in your
clone:
{
"mcpServers": {
"cmu-soc": {
"command": "node",
"args": ["/absolute/path/to/cmu-soc-mcp/dist/bundle.cjs"]
}
}
}Claude Desktop doesn't inherit your shell's PATH. If node isn't found, use its absolute
path for command (find it with which node). Restart Claude Desktop fully afterwards.
Manual build / any other MCP host
git clone https://github.com/aaditsingh07/cmu-soc-mcp.git
cd cmu-soc-mcp
npm install
npm run buildThe server uses stdio: run node dist/bundle.cjs (or node dist/index.js after a build). All
tools are read-only.
Testing
npm run test:unit # parsers against hand-written fixtures (offline)
npm test # build + unit tests + live smoke test against CMU's sitesAccess policy
Checked on 2026-11-18.
Host | robots.txt | How this server uses it |
| none (404), so no restrictions | Course search and course detail pages. The site describes itself as being for "the general public" |
| disallows | Department course pages only, current catalog only. Disallowed paths are never requested |
| disallows | The registrar's final-exam PDFs under |
CMU's website terms allow "personal viewing and non-commercial use" and prohibit redistributing site content. This project is built for that:
each user runs it locally;
it fetches public pages only when asked;
it keeps responses in memory only (semesters 1 h, department searches 1 h, course pages 6 h, final-exam PDFs 6 h, catalog pages 24 h);
it sends a generic
cmu-soc-mcp/1.0User-Agent;it never has more than two requests in flight per host.
The repo contains no CMU pages, PDFs or catalog text; test fixtures are hand-written. Don't host it as a public service or use it commercially.
How it works
Semesters and departments: the
SEMESTERandDEPTselects onGET /open/SOC/SOCServlet/search. Department labels carry their course prefix ("Computer Science (15XXX)").Courses and sections:
POST /open/SOC/SOCServlet/searchwith one department returns one table of every course. Continuation rows omit their opening<tr>. A blank section cell is an extra meeting of the section above. Lettered sections afterLec Nbelong to that lecture. A mini's number is its section's last digit.Course detail:
GET /open/SOC/SOCServlet/courseDetails?COURSE=15122&SEMESTER=F26. Columns are read by header, because summer adds a "Session" column. The server checks the department search first, because requesting a course that isn't offered returns HTTP 500.Final exams:
https://www.cmu.edu/hub/docs/final-exams.pdfandfinal-exam-mini.pdf. Their text layer is read with unpdf (pdf.js). The URLs are reused each semester, so each PDF's title line decides which semester it covers.Catalog: CourseLeaf department pages (
<dl class="courseblock">).src/catalog-pages.tsmaps course prefixes to pages; regenerate it each catalog year withnode scripts/build-catalog-pages.mjs.Buildings: codes come from the SOC building legend. Walking time is the haversine distance × 1.4, at 80 m/min.
Notes
Not affiliated with Carnegie Mellon University. Data comes from public CMU pages and may change. The SOC is refreshed nightly, and departments may alter schedules at any time.
get_course_detailsreturns at most 4 listings for a course number (topics courses can repeat a number).get_final_examstakes up to 12 courses per call.
License
Code: Unlicense — public domain.
Building coordinates in src/buildings.ts are derived from
OpenStreetMap data, © OpenStreetMap contributors,
available under the ODbL. One point (Gesling
Stadium) comes from Wikidata (CC0).
Available Tools
9 toolsestimate_walk_timeEstimate walking time between buildingsARead-only
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.
Inputs: to_location (required), from_location (required).
get_course_descriptionGet catalog course descriptionARead-only
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.
Inputs: course_number (required).
get_course_detailsGet course sections and meeting timesARead-only
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.
Inputs: semester (required), course_number (required), campus.
get_course_infoGet course prerequisites, notes and reservationsARead-only
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.
Inputs: semester (required), course_number (required).
get_final_examsGet final exam timesARead-only
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.
Inputs: courses (required), semester (required).
list_buildingsList known CMU buildingsARead-only
Every CMU building estimate_walk_time knows, with the Schedule of Classes building code, alternate names and approximate coordinates (© OpenStreetMap contributors, ODbL).
Inputs: search.
list_departmentsList CMU departmentsARead-only
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).
Inputs: no named parameters.
list_semestersList CMU semestersARead-only
Semesters currently published in the CMU Schedule of Classes, newest first, with codes (S = Spring, F = Fall, M = Summer; e.g. S27 = Spring 2027).
Inputs: no named parameters.
search_coursesSearch a department's coursesARead-only
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.
Inputs: semester (required), department (required), campus.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Automate 1,000+ services from any MCP-compatible AI agent: build Applets, run actions and queries.
Acuity Scheduling MCP server for ChatGPT, Claude and any AI agent: list appointments, check availability, book appointment, reschedule appointment, cancel appointment and block off time in your own Acuity Scheduling account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Acuity Scheduling yourself; Cotlet does not store your password and you need no Acuity Scheduling API key. About the official Acuity Scheduling API: Acuity Scheduling has a full REST API but no official MCP server (checked 17 Oct 2026). The API uses HTTP Basic auth with your user ID and API key, and Acuity says API access is available on the Premium plan (formerly Powerhouse), so Starter and Standard accounts have no key to give an agent. Setup and FAQ: https://cotlet.dev/integrations/acuity-scheduling-api-mcp-server
Skedda MCP server for ChatGPT, Claude and any AI agent: list bookings, create booking, cancel booking, approve booking request and block out a space in your own Skedda account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Skedda yourself; Cotlet does not store your password and you need no Skedda API key. About the official Skedda API: Skedda has a read-only API in beta and no official MCP server (checked 31 Oct 2026). It lists spaces and booking occurrences and sends webhooks for booking events, on Skedda Premier and AllBooked Advanced. Setup and FAQ: https://cotlet.dev/integrations/skedda-api-mcp-server
Search and inspect source-pinned agent skills, plugins and tools through a free public MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables searching and retrieving course details, schedules, prerequisites, and instructor information from the CMU course catalog via the ScottyLabs API.92MIT
- FlicenseNot gradedqualityDmaintenanceEnables fetching and analyzing COMSATS University timetables via natural language, bridging Claude Desktop with the live university timetable system.-
- FlicenseAqualityDmaintenanceLocal-first Rutgers course planning assistant that answers 'what should I take and when?' using a CP-SAT solver, real transcript data, and live SOC data, connected to Claude via MCP.13-
- FlicenseNot gradedqualityDmaintenanceRemote MCP connector providing live, structured access to CMU Courses public data including courses, prerequisites, schedules, instructors, gen-eds, and final-exam times to help students plan schedules.-