OutBlade/kit-campus-mcp

Getting started · Features
An MCP server for the KIT Campus portal (campus.studium.kit.edu). It reads
exam results, exam registrations, study progress, your timetable and the public
module catalogue, and it can report which results are new since the last
check - which is what a notification bot needs.
## How it works
campus.studium.kit.edu is only a KIT-branded frame. The application behind it
is CAS Campus at https://cascampus.studium.kit.edu, and the frame's own
kit-frame-config.js maps every portal page to a backend URL. This server talks
to those backend URLs directly.
Two access levels:
| | Login | Pages |
| Public | none | module catalogue, course catalogue, degree programmes |
| Account | Shibboleth SSO + token | results, exam registrations, study progress, timetable |
The account side is the interesting part. campus.kit.edu's own login page
(campus/login/chooseCampusUser.asp) no longer exists on KIT's server - it
returns a 404 - so logging in there directly is impossible. What the portal
actually does:
1. authenticate against the portal's SP:
campus.studium.kit.edu/Shibboleth.sso/Login -> idp.scc.kit.edu -> SAML POST back
2. call campus.studium.kit.edu/token.php, which returns a short-lived
tokenA plus the account's name and matriculation number
3. pass that token to the backend as login-token + login-ts on any
cascampus.studium.kit.edu URL, which is what creates the CAS Campus session
This server does the same three steps. Cookies and the token are cached, so
repeated polls do not re-run the SSO chain.
## Install
bash
git clone https://github.com/OutBlade/kit-campus-mcp.git
cd kit-campus-mcp
uv venv
uv pip install -e .
Copy .env.example to .env and fill in your KIT account:
KITUSERNAME=ab1234
KITPASSWORD=...
KITUSERNAME is the short KIT account (ab1234), not your e-mail address.
Verify:
bash
.venv\Scripts\kit-campus login
That prints who you are, your degree programmes with their GUIDs, and the
current term. Any tool that takes a programguid accepts those; omit it and
the first one is used.
## Register with an MCP client
bash
claude mcp add kit-campus -- C:\Users\blade\kit-campus-mcp\.venv\Scripts\kit-campus-mcp.exe
Or in a client config file:
json
"mcpServers": {
"kit-campus": {
"command": "C:\\Users\\blade\\kit-campus-mcp\\.venv\\Scripts\\kit-campus-mcp.exe",
"env": { "KITUSERNAME": "ab1234", "KITPASSWORD": "..." }
## Tools
Public catalogue - no login
| Tool | Purpose |
| kitsearchmodules | Search the Modulhandbuch by title, id, code or ECTS range |
| kitgetmodule | One module in full: lectures, exam dates with rooms, Teilleistungen, programmes |
| kitsearchevents | Search the Vorlesungsverzeichnis |
| kitlistprograms | List degree programmes |
Your account - needs credentials
| Tool | Purpose |
| kitchecksession | Verify login, show who you are, list your programme GUIDs |
| kitgetgrades | Every result with grade, ECTS, date, plus the official average |
| kitchecknewresults | Only what changed since the last check - poll this from a bot |
| kitlistregisteredexams | Exams you are registered for, with dates, rooms and deadlines |
| kitgetstudyprogress | Full study tree: what is done, what is still open |
| kitgettimetable | Personal timetable |