@ink-waffle/sisu-mcp
v0.1.0
Published
MCP server for any Sisu (Funidata) student information system: attainments, study rights, enrolments, timetables, plans, and the course catalogue
Maintainers
Readme
@ink-waffle/sisu-mcp
Use Sisu from an MCP client: study rights, attainments, grades, enrolments, timetable, study plan, and course catalogue. It is read-only.
Install
Configure this MCP in your MCP client (Claude Code, Windsurf, Cursor, Zed, OpenCode, or any other MCP-capable editor/agent):
mcp add sisu -- npx -y @ink-waffle/sisu-mcp(Assuming mcp is your client's MCP client management CLI — adjust for your editor.)
Ask your agent to run sisu_connect giving it your sisu url, e.g sisu.tuni.fi. Log in in the browser tab if asked. The server stores the session locally and renews its short-lived access automatically.
Tools
| tool | use it for |
|---|---|
| sisu_connect, sisu_status, sisu_disconnect | connect and manage sites |
| sisu_studies, sisu_attainments | see your study status and grades |
| sisu_enrolments, sisu_calendar | see enrolments and timetable |
| sisu_plan | read your study plan |
| sisu_search, sisu_course | search and inspect the course catalogue |
| sisu_call, sisu_endpoints | make read-only API requests and discover available paths |
Shared browser
This MCP is designed to run beside @ink-waffle/aplus-mcp and @ink-waffle/moodle-mcp. All three use the sibling @ink-waffle/study-browser package when browser access is needed.
By default it creates and reuses one isolated Chrome profile:
~/.chrome-profiles-mcp/study-automation-profileIt starts Chrome with a local CDP endpoint when necessary. Sibling MCP processes reuse that browser instead of starting conflicting copies. The browser stays open until you close it.
Works on macOS, Windows, and Linux.
Alternative setups
One HTTP server, many clients
# Run as a persistent service (systemd, Windows Service, launchd, etc.):
npx -y @ink-waffle/sisu-mcp --port 8935# Then configure your MCP client to connect via HTTP:
mcp add --transport http sisu http://127.0.0.1:8935/mcpYour own Chrome
npx -y @ink-waffle/sisu-mcp --cdp http://127.0.0.1:9222The MCP only attaches to an explicit CDP endpoint; it never starts or closes that browser. Use SISU_MCP_CDP instead of --cdp with a service manager.
Local data
Session data and cached results live in ~/.sisu-mcp/. Treat config.json as a password file.
