Skip to content
Back to search

cmu-soc-mcp

MarketplaceWorks with Claude CodeGitHub

CMU Schedule of Classes MCP server and schedule-planning skill

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aaditsingh07--cmu-soc-mcp/badge.svg)](/listings/aaditsingh07--cmu-soc-mcp)

HTML

<a href="/listings/aaditsingh07--cmu-soc-mcp"><img src="/api/listings/aaditsingh07--cmu-soc-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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-mcp

No 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)

1. Download **`cmu-soc.mcpb`** from the [latest release](https://github.com/aaditsingh07/cmu-soc-mcp/releases/latest). 2. 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. 3. *(Optional, for the guided planner.)* Download **`cmu-schedule-planning.zip`** from the same release and upload it in Claude Desktop's Skills settings (**Settings → Capabilities → Skills**). 4. 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 build

The server uses stdio: run `node dist/bundle.cjs` (or `node dist/index.js` after a build). All tools are read-only.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "cmu-soc-mcp",
  3. "owner": {
  4. "name": "Aadit Singh",
  5. "url": "https://github.com/aaditsingh07"
  6. },
  7. "description": "CMU Schedule of Classes MCP server and schedule-planning skill",
  8. "plugins": [
  9. {
  10. "name": "cmu-soc",
  11. "source": "./",
  12. "description": "Carnegie Mellon Schedule of Classes tools plus a guided schedule-planning skill: semesters, departments, sections and minis, prerequisites, registrar final exams, catalog descriptions, and campus walking-time estimates."
  13. }
  14. ]
  15. }
README.md · README · 185 lines
  1. # UNOFFICIAL CMU Schedule of Classes — MCP Server & Claude Plugin
  2. An MCP (Model Context Protocol) server that lets Claude, or any MCP-capable agent, query
  3. Carnegie Mellon's public
  4. [Schedule of Classes](https://enr-apps.as.cmu.edu/open/SOC/SOCServlet). No login or API key is
  5. required. It reads the same pages the SOC website serves, plus the registrar's final-exam
  6. schedule and the current undergraduate catalog.
  7. The repo is also a **Claude Code plugin** (`cmu-soc`). It bundles the server with a
  8. `schedule-planning` skill: a guided workflow that confirms the semester, collects the
  9. student's goals and remaining requirements, verifies prerequisites, checks minis,
  10. recitations and final exams, and renders a mock schedule from a fixed template.
  11. A CMU counterpart of [ucla-soc-mcp](https://github.com/aaditsingh07/ucla-soc-mcp).
  12. ## Tools
  13. | Tool | What it does |
  14. | --- | --- |
  15. | `list_semesters` | Semesters published in the SOC (`S27` = Spring 2027, `F26` = Fall 2026, `M26` = Summer 2026), newest first |
  16. | `list_departments` | Every department's code (`CS`, `MSC`, `ECE`, …) and the course-number prefix it owns (`CS` = 15) |
  17. | `search_courses` | Every course a department offers in a semester: number, title, units. Optional `campus` filter |
  18. | `get_course_details` | 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 |
  19. | `get_course_info` | The SOC course page: prerequisite/corequisite expressions (`15112 or 02120`) and the courses they name, cross-listings, special permission, notes, per-section reservations, description, related URLs |
  20. | `get_final_exams` | Registrar final exams for several courses at once: date, time, exam room, status, instructors. A recitation input returns its lecture's exam. Says `published: false` for semesters the registrar hasn't posted |
  21. | `get_course_description` | Current Undergraduate Catalog entry: semesters offered, units, description, prerequisites with minimum grades, corequisites, course website |
  22. | `estimate_walk_time` | Offline walking-time estimate between two buildings, from room strings like `GHC 4401` or names like `Wean Hall` |
  23. | `list_buildings` | The 37 buildings `estimate_walk_time` knows, with SOC building codes and approximate coordinates |
  24. Inputs are forgiving:
  25. - Semesters accept `S27` or `Spring 2027`.
  26. - Course numbers accept `15-122`, `15122`, or `cs 15-122`.
  27. - Departments accept `CS`, `Computer Science`, or `15`.
  28. Unknown inputs return errors that list the valid options.
  29. ### What CMU does not publish
  30. CMU's public schedule has **no seat counts, waitlists, rooms or instructors**. Students see
  31. those in SIO, which needs a login. The tools never invent them: each section-level result
  32. carries a `not_public` note. Unlike the UCLA server, there is therefore no open-seat filter,
  33. and walking estimates need rooms the student supplies. Instructors appear only in the final-exam
  34. schedule, as names; Andrew IDs are removed.
  35. Final exams cover the **current semester only**. The registrar posts them around week 6
  36. (early October in fall, late February in spring), so for the semester being planned they
  37. usually aren't out yet. `get_final_exams` says that explicitly rather than reporting "no
  38. conflict".
  39. ### Degree audits
  40. CMU audits live in Stellic, which needs a login and has no documented export format. A
  41. Stellic parser (the equivalent of the UCLA plugin's DARS script) is not included yet. For
  42. now, the skill asks the student to paste their unmet requirements.
  43. ## Setup
  44. ### Claude Code (plugin — recommended)
  45. The repo is its own plugin marketplace. In Claude Code:
  46. ```
  47. /plugin marketplace add aaditsingh07/cmu-soc-mcp
  48. /plugin install cmu-soc@cmu-soc-mcp
  49. ```
  50. No build step is needed: the plugin ships a self-contained server bundle (`dist/bundle.cjs`)
  51. that runs on Node 18 or newer. Start planning with `/cmu-soc:schedule-planning`, or just ask
  52. about CMU classes and Claude will pick the skill up on its own.
  53. ### Claude Desktop (one-click extension — recommended for Desktop)
  54. 1. Download **`cmu-soc.mcpb`** from the
  55. [latest release](https://github.com/aaditsingh07/cmu-soc-mcp/releases/latest).
  56. 2. Double-click it, or drag it into Claude Desktop's **Settings → Extensions**, and click
  57. **Install**. Claude Desktop runs it with its own built-in Node.js, so there's nothing else
  58. to install.
  59. 3. *(Optional, for the guided planner.)* Download **`cmu-schedule-planning.zip`** from the
  60. same release and upload it in Claude Desktop's Skills settings (**Settings → Capabilities
  61. → Skills**).
  62. 4. Ask something like "Plan my Spring 2027 schedule at CMU".
  63. To rebuild both files from source, run `npm install && npm run pack:desktop`. They are
  64. written to `dist/`.
  65. ### Claude Desktop (manual config)
  66. If you'd rather not use the extension, add this to `claude_desktop_config.json`
  67. (Settings → Developer → Edit Config), using the absolute path to `dist/bundle.cjs` in your
  68. clone:
  69. ```json
  70. {
  71. "mcpServers": {
  72. "cmu-soc": {
  73. "command": "node",
  74. "args": ["/absolute/path/to/cmu-soc-mcp/dist/bundle.cjs"]
  75. }
  76. }
  77. }
  78. ```
  79. Claude Desktop doesn't inherit your shell's `PATH`. If `node` isn't found, use its absolute
  80. path for `command` (find it with `which node`). Restart Claude Desktop fully afterwards.
  81. ### Manual build / any other MCP host
  82. ```sh
  83. git clone https://github.com/aaditsingh07/cmu-soc-mcp.git
  84. cd cmu-soc-mcp
  85. npm install
  86. npm run build
  87. ```
  88. The server uses stdio: run `node dist/bundle.cjs` (or `node dist/index.js` after a build). All
  89. tools are read-only.
  90. ## Testing
  91. ```sh
  92. npm run test:unit # parsers against hand-written fixtures (offline)
  93. npm test # build + unit tests + live smoke test against CMU's sites
  94. ```
  95. ## Access policy
  96. Checked on 2026-11-18.
  97. | Host | robots.txt | How this server uses it |
  98. | --- | --- | --- |
  99. | `enr-apps.as.cmu.edu` (SOC) | none (404), so no restrictions | Course search and course detail pages. The site describes itself as being for "the general public" |
  100. | `coursecatalog.web.cmu.edu` | disallows `/course-search/`, `/search/`, `/ribbit/`, `/pdf/`, `/previous/`, … | Department course pages only, current catalog only. Disallowed paths are never requested |
  101. | `www.cmu.edu` | disallows `/cmufront/`, `/myandrew` | The registrar's final-exam PDFs under `/hub/docs/` |
  102. CMU's [website terms](https://www.cmu.edu/legal/) allow "personal viewing and non-commercial
  103. use" and prohibit redistributing site content. This project is built for that:
  104. - each user runs it locally;
  105. - it fetches public pages only when asked;
  106. - it keeps responses in memory only (semesters 1 h, department searches 1 h, course pages
  107. 6 h, final-exam PDFs 6 h, catalog pages 24 h);
  108. - it sends a generic `cmu-soc-mcp/1.0` User-Agent;
  109. - it never has more than two requests in flight per host.
  110. The repo contains no CMU pages, PDFs or catalog text; test fixtures are hand-written. Don't
  111. host it as a public service or use it commercially.
  112. ## How it works
  113. - **Semesters and departments**: the `SEMESTER` and `DEPT` selects on `GET /open/SOC/SOCServlet/search`.
  114. Department labels carry their course prefix ("Computer Science (15XXX)").
  115. - **Courses and sections**: `POST /open/SOC/SOCServlet/search` with one department returns
  116. one table of every course. Continuation rows omit their opening `<tr>`. A blank section
  117. cell is an extra meeting of the section above. Lettered sections after `Lec N` belong to
  118. that lecture. A mini's number is its section's last digit.
  119. - **Course detail**: `GET /open/SOC/SOCServlet/courseDetails?COURSE=15122&SEMESTER=F26`.
  120. Columns are read by header, because summer adds a "Session" column. The server checks the
  121. department search first, because requesting a course that isn't offered returns HTTP 500.
  122. - **Final exams**: `https://www.cmu.edu/hub/docs/final-exams.pdf` and `final-exam-mini.pdf`.
  123. Their text layer is read with [unpdf](https://github.com/unjs/unpdf) (pdf.js). The URLs are
  124. reused each semester, so each PDF's title line decides which semester it covers.
  125. - **Catalog**: CourseLeaf department pages (`<dl class="courseblock">`).
  126. `src/catalog-pages.ts` maps course prefixes to pages; regenerate it each catalog year with
  127. `node scripts/build-catalog-pages.mjs`.
  128. - **Buildings**: codes come from the SOC
  129. [building legend](https://www.cmu.edu/hub/legend.html). Walking time is the haversine
  130. distance × 1.4, at 80 m/min.
  131. ## Notes
  132. - Not affiliated with Carnegie Mellon University. Data comes from public CMU pages and may
  133. change. The SOC is refreshed nightly, and departments may alter schedules at any time.
  134. - `get_course_details` returns at most 4 listings for a course number (topics courses can
  135. repeat a number).
  136. - `get_final_exams` takes up to 12 courses per call.
  137. ## License
  138. Code: [Unlicense](LICENSE) — public domain.
  139. Building coordinates in `src/buildings.ts` are derived from
  140. [OpenStreetMap](https://www.openstreetmap.org/copyright) data, © OpenStreetMap contributors,
  141. available under the [ODbL](https://opendatacommons.org/licenses/odbl/). One point (Gesling
  142. Stadium) comes from Wikidata (CC0).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.