home / mcp / sabis mcp server

SABIS MCP Server

Provides MCP access to SABIS grades with secure authentication and real-time retrieval via Puppeteer.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "hanifisenturk-sabis-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/sabis-mcp-server/build/index.js"
      ],
      "env": {
        "PASSWORD": "your_password",
        "USERNAME": "your_student_number"
      }
    }
  }
}

You can access live SABIS academic grades securely through this MCP server. It connects to the Sakarya University SABIS portal, authenticates with your credentials, and retrieves detailed course and grade information in a structured way for MCP-enabled assistants and apps.

How to use

Use a compatible MCP client to fetch your SABIS grades by calling the get-grades tool. The server authenticates with your SABIS credentials and returns the academic year, semester, and a breakdown of courses with their respective assessments and final grades. This enables AI assistants to present up-to-date, course-by-course grade information in natural language.

How to install

Prerequisites: Node.js 18+ and TypeScript 5.8+.

Install dependencies and build the project locally.

Configuration

Environment credentials are required to access SABIS. You can configure credentials in one of two ways. The first option embeds credentials in the MCP client configuration. The second option uses a separate .env file at the project root.

{
  "mcpServers": {
    "sabis-mcp-stdio-1": {
      "command": "node",
      "args": [
        "/path/to/sabis-mcp-server/build/index.js"
      ],
      "env": {
        "USERNAME": "your_student_number",
        "PASSWORD": "your_password"
      }
    }
  }
}

{
  "mcpServers": {
    "sabis-mcp-stdio-2": {
      "command": "node",
      "args": [
        "/path/to/sabis-mcp-server/build/index.js"
      ]
    }
  }
}

Security & privacy

Credentials are stored in environment variables and the server operates in headless mode to prevent exposing sensitive data. All communications with SABIS use HTTPS, and grades are fetched in real time without local storage.

Troubleshooting

Common issues include missing credentials, login failures, or Puppeteer/browser problems. Ensure you provide valid SABIS credentials and that the SABIS portal is accessible from your network. If Puppeteer requires dependencies on Linux, install them as needed.

API Reference

Tool: get-grades — authenticates with SABIS and retrieves academic grade information. It returns the academic year and semester, course details with grades, assessment breakdowns, and final grades where available.

Available tools

get-grades

Authenticates with SABIS and retrieves academic grade information including year, semester, course details, assessments, and final grades.