Skip to main content
Glama

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 against

SIOClient 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 push

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

Tools

Tool

Returns

get_student_context

name, current term, class level, major, advisor, units

get_schedule

sections with days/times/rooms/instructors + add/drop deadlines

get_schedule_ics

official .ics export (authoritative semester dates)

get_grades

per-course grades + QPA for a semester

get_advanced_placement

AP/transfer credit and exam scores

get_enrollment_status

enrollment record for a semester

get_account_activity

student account ledger + balance

get_campus_life

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 pytest

Parser 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 tools
get_account_activityA
Read-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_placementA
Read-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_lifeA
Read-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_statusA
Read-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_gradesA
Read-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_scheduleA
Read-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_icsA
Read-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_contextA
Read-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

    A4.4/5.0

    Scored across 8 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    Every tool follows the exact same get_<domain> pattern with clear, descriptive nouns. This is perfectly consistent and predictable.

    Tool Count5/5

    Eight tools is well within the ideal range for a student data server. Each tool covers a meaningful data area without redundancy or bloat.

    Completeness5/5

    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

    Related MCP Servers