get-gradesLABSCO SUMMARY
Scrapes the portal because there is nothing else to call.
Everything follows from that. Your portal password sits in an environment variable that a local process reads on every call, nothing is stored between calls, and the whole thing depends on the SABIS page markup staying where it is — a redesign upstream breaks the read. It is unaffiliated with the university, so treat it as a personal convenience rather than a supported integration.
What it is
An unofficial MCP server for SABIS, the Sakarya University student information system. There is no grades API, so it logs in with Puppeteer and reads the page: one tool, one answer, live from the portal each time rather than from a cached copy.
What you get
- One tool,
get-grades, which takes no parameters — the credentials come from the environment - The academic year and semester the results belong to, so a returned transcript is not ambiguous about which term it covers
- Per course: the course code and name, the group, and each assessment broken out by type with its weight as a percentage and the mark received
- The final letter grade for each course where one has been published
Requirements
A valid Sakarya University student account. The server reads two environment variables, USERNAME and PASSWORD, either from an .env file in the project directory or from the env block of your MCP client config. Node.js 18+ and TypeScript 5.8+. The package is sabis-mcp-server (1.0.0 in package.json); clone, npm install, npm run build, then run build/index.js with node. On Linux, Puppeteer needs the Chromium system libraries installed before the browser will start.
Setup effort
Build from source — git clone https://github.com/hanifisenturk/sabis-mcp-server.git
USE CASES
01
Checking whether a grade has been posted
Ask for grades and read the current term straight from the portal, rather than refreshing the page yourself.
02
Working out what you need on the final
Read each assessment with its weight and mark, and calculate the score the remaining exam has to reach.
03
Summarising a semester
Pull every course for the term with its final letter grade and turn it into a single overview instead of clicking through course by course.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
Node.js 18+
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
From source
TERMINAL
git clone https://github.com/hanifisenturk/sabis-mcp-server.git
cd sabis-mcp-server
npm install
npm run buildConfiguration file
JSON
{
"mcpServers": {
"sabis-mcp-server": {
"command": "node",
"args": [
"<YOUR_PATH_TO_SABIS_MCP_SERVER>/build/index.js"
],
"env": {
"USERNAME": "<YOUR_USERNAME>",
"PASSWORD": "<YOUR_PASSWORD>"
}
}
}
}
