sio-mcp
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., "@sio-mcp What's my schedule for this semester?"
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.
foreword
this is a proof of concept by claude and not suitable for production
-noah
sio-mcp
Read-only MCP server over CMU Student Information Online (SIO), built as a thin wrapper around a reusable typed client library.
Related MCP server: MCP Student Assistant
Layout
src/sio_mcp/
utils/session.py auth: Playwright login (AndrewID + Duo), cookie persistence
terms.py term codes (F26 <-> fall-2026 <-> "Fall 2026")
models.py pydantic models; ISO dates, 24h times, decimal-string money
parsers/ HTML parsers for SIO's server-rendered pages
client.py SIOClient: typed async API with TTL caching
server.py the MCP server (8 read-only tools)
cli.py `sio-login`
tests/fixtures/ real SIO page snapshots the parser tests run againstSIOClient is the reuse surface: the MCP server, a CLI, a cron job, or a RAG
ingestion script all call the same functions.
Setup
uv sync
uv run sio-login # AndrewID + password (env: ANDREW_ID/ANDREW_PASSWORD or prompts), approve the Duo pushSessions expire on CMU's schedule; when a tool reports an authentication
error, re-run sio-login.
Register with Claude Code:
claude mcp add cmu-sio -- uv --directory /path/to/this/repo run sio-mcpTools
Tool | Returns |
| name, current term, class level, major, advisor, units |
| sections with days/times/rooms/instructors + add/drop deadlines |
| official |
| per-course grades + QPA for a semester |
| AP/transfer credit and exam scores |
| enrollment record for a semester |
| student account ledger + balance |
| housing assignment, Plaid Cash |
Conventions: times are America/New_York HH:MM; dates ISO YYYY-MM-DD;
money is a decimal string in USD (charges positive, payments/credits
negative); course codes are normalized to 15-122 form; term params accept
F26, fall-2026, or Fall 2026.
Testing
uv run pytestParser tests run offline against tests/fixtures/. SIO redeploys weekly — if
a parser starts raising UpstreamChangedError, re-capture the page into the
fixtures and adjust.
Non-goals (for now)
Writes. Registration/drop actions live in SIO's legacy GWT app behind opaque GWT-RPC, and SIO explicitly warns that automated registration requests get access revoked. This server is deliberately read-only.
The legacy
/sio/#...app generally (invoices, pay-now, planning). The data worth reading is duplicated on the server-rendered pages this uses.
Available Tools
8 toolsget_account_activityARead-only
The student account ledger, grouped by fiscal year: tuition, fees, housing, grants, loans, and payments, with the running balance.
Call this when the user asks about their bill, balance, charges, payments, or financial aid disbursements. Amounts are USD decimal strings; charges are positive, payments and aid are negative.
Inputs: force_refresh. Returns: periods, currency
get_advanced_placementARead-only
AP and transfer credit: courses credited (with units) and the AP exam scores behind them.
Call this when the user asks about AP credit, transfer credit, or exam scores. These units are not graded and do not factor into QPA.
Inputs: no named parameters. Returns: credits, exam_scores, total_units
get_campus_lifeARead-only
Housing assignment, and Plaid Cash balance.
Call this when the user asks where they live on campus or about their Plaid Cash.
Inputs: no named parameters. Returns: notes, housing, housing_semester, plaid_cash_balance
get_enrollment_statusARead-only
Enrollment record for a semester: enrolled/registered status, units carried vs maximum, class level, degree/college/major, and advisor.
Call this for questions about enrollment verification, unit load, or program/major details beyond what get_student_context gives.
Inputs: term. Returns: term, major, degree, college, +9 more
get_gradesARead-only
Grades for one semester: per-course grade option, units, mid-semester and final grades, plus the semester and cumulative QPA summary.
Call this when the user asks about grades, QPA/GPA, or units for a
semester. Grades show "NA" until posted. Omit term for the current
semester; available_terms in the response lists what else can be
queried.
Inputs: term, force_refresh. Returns: qpa, term, courses, available_terms
get_scheduleARead-only
The student's course schedule: sections with meeting days, start/end times, building/room, instructors (with emails), and add/drop/withdrawal deadlines per section.
Call this when the user asks about their classes, class times, locations,
instructors, or what their day/week looks like. term accepts an SIO code
("F26"), a slug ("fall-2026"), or a name ("Fall 2026"); omit it for the
current term. A section may have several meeting entries (lecture +
recitation); group by course_code + section when presenting.
Inputs: term, force_refresh. Returns: term, meetings, timezone, available_terms
get_schedule_icsARead-only
The official iCalendar (.ics) export of the schedule, with weekly RRULEs bounded to the semester.
Call this when integrating with calendar tools or when the user wants their schedule as calendar events — it is authoritative on semester start and end dates, which get_schedule does not carry. Times are local America/New_York wall-clock times.
Inputs: term. Returns: result
get_student_contextARead-only
Who the student is right now: name, current term, class level, major, college, advisor, units carried, and expected graduation.
Call this first in any conversation touching academics, and whenever you
need the current semester to pass as a term argument elsewhere.
Inputs: no named parameters. Returns: The grounding record: who this student is, right now.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct data domain (schedule, grades, billing, etc.), but get_student_context and get_enrollment_status overlap on class level, major, and advisor. The descriptions clarify when to use which, so confusion is unlikely.
Every tool follows the exact same get_<domain> pattern with clear, descriptive nouns. This is perfectly consistent and predictable.
Eight tools is well within the ideal range for a student data server. Each tool covers a meaningful data area without redundancy or bloat.
The server covers the full read-only student information surface: context, schedule, grades, credits, enrollment, billing, and campus life. No obvious missing queries for the stated purpose.
Related MCP Connectors
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Public read-only MCP access to digital learning concepts, semantic relationships, and citations.
Read-only access to InfluSense influencer discovery, ratings, watchlists, and reports via MCP.
Read-only access to a student's recorded classes: transcripts, notes, slides and concept map.
Related MCP Servers
- 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.-
- FlicenseNot gradedqualityDmaintenanceEnables querying student information such as marks, attendance, pending assignments, and timetables from a MySQL database through MCP tools.-
- AlicenseAqualityBmaintenanceProvides read-only access to StudyLife data including courses, notes, sessions, and learning goals, enabling MCP clients to query study information via natural language.7AGPL 3.0
- AlicenseAqualityCmaintenanceRead-only MCP server for Canvas LMS that exposes tools to list courses, assignments, grades, submissions, syllabi, announcements, modules, pages, and files, without any write operations.1112 npm1MIT