infinitecampus-mcp

MCP server for Infinite Campus (Campus Parent portal). Single-account config — linked districts are auto-discovered via CUPS SSO after login.

Tools

19 tools across academics, daily life, documents, messaging, and feature discovery.

Domain	Tools
Districts	ic_list_districts
Students	ic_list_students
Schedule	ic_get_schedule
Assignments	ic_list_assignments (sectionID server-side; missingOnly / date filters client-side)
Grades	ic_list_grades, ic_list_recent_grades (default 14d window)
School calendar	ic_list_school_days
Attendance	ic_list_attendance (per-course summary), ic_list_attendance_events (individual events with codes + comments)
Behavior	ic_list_behavior (FeatureDisabled-aware)
Food service	ic_list_food_service (FeatureDisabled-aware)
Documents	ic_list_documents, ic_download_document
Messaging	ic_list_messages (3 sources: prism notifications + Messenger 2.0 inbox + portal announcements), ic_get_message (fetch parsed HTML body of an inbox message)
Teachers	ic_list_teachers (teachers per section + assigned counselors)
Assessments	ic_list_assessments (standardized test scores)
Fees	ic_list_fees (assignments + surplus balance)
Features	ic_get_features (per-enrollment displayOptions flags)

Tools that the harness will gate as write/IO operations: ic_download_document.

Configuration

infinitecampus-mcp tries two auth paths in priority order; whichever succeeds first is used. Existing setups keep working unchanged.

1. Env-var credentials (legacy). Set all four:

   IC_BASE_URL=https://campus.springfield.k12.example.us
   IC_DISTRICT=springfield
   [email protected]
   IC_PASSWORD=...
   IC_NAME=Springfield           # optional, defaults to IC_DISTRICT
   

2. fetchproxy fallback (no password needed). Set only IC_BASE_URL + IC_DISTRICT (still required so the MCP knows which host to talk to and which district to dispatch on), then install the fetchproxy 0.3.0 extension (Chrome Web Store / Safari .dmg) and sign into your IC portal once. The MCP reads the JSESSIONID (HttpOnly) + XSRF-TOKEN cookies from that tab and goes direct-to-API from Node thereafter — the extension is not in the request hot path. The read is repeated whenever the session lapses (JSESSIONID is a servlet session with a short idle timeout), so you stay signed in without restarting the MCP.

Set IC_DISABLE_FETCHPROXY=1 to opt out of the fallback (turns missing credentials into a hard error — useful in headless CI).

Linked districts (via CUPS SSO) are auto-discovered after primary login — a parent with kids in two districts only configures the primary. No extra config needed. If you have truly separate IC instances with different credentials, run two MCP instances.

See .env.example.

Status

Unofficial — not affiliated with Infinite Campus. AI-maintained.

Acknowledgement of Terms

By using this MCP server, you acknowledge and agree to the following:

1. This server accesses your own Campus Parent account. Auth happens via your own credentials, scoped to the student records your school district has authorized you to view. It does not — and cannot — access anyone else's student records.

2. Infinite Campus's Terms of Use govern your use of this server, just as they govern your direct use of Campus Parent. The clauses most relevant here: