Isparta Üniversitesi OBS MCP Tools Server

You use this MCP server to securely access Isparta University’s OBS data via a standardized MPC interface. It lets you retrieve student information, announcements, courses, transcripts, and more, while enabling analytics, notifications, and exports in multiple formats.

How to use

Connect to the MCP server from your client to access OBS data and features. Start by launching the local MCP server, then use the provided functions to log in, fetch data, and perform actions such as academic analytics, course planning, and data exports. The server supports both secure login and page-based data retrieval, ensuring you can work with up-to-date information through a consistent interface.

Typical usage flow you will follow:

• Start the MCP server locally
• Log in with valid credentials
• Retrieve your student information, announcements, and courses
• Optionally run academic analytics, track performance, or use the course advisor
• Export data in JSON, CSV, PDF, or Excel formats as needed

If you want to debug or inspect login results, you can use the debug variant of the login function to gather extra details about the authentication flow and responses from the server

How to install

# Prerequisites
Python 3.10+
pip (or uv)

# 1. Clone the MCP project
git clone https://github.com/kullanici-adi/isparta-uni-obs-mcp.git
cd isparta-uni-obs-mcp

# 2. Install dependencies
pip install -r requirements.txt

# 3. Start the MCP server
python server.py

Additional sections

Configuration details are defined by how you start and connect to the MCP server. The primary runtime flow uses Python to run the server script, which exposes the MCP endpoints you will call from your client.

Security is focused on secure credential handling and automated session management. Ensure you use HTTPS for remote connections and protect your credentials. The server supports session-based authentication and CSRF protections are handled automatically.

Common troubleshooting steps include verifying Python version, ensuring dependencies installed correctly, and checking that the server process is running. If login fails, enable debug information to inspect payloads and responses.

Available tools

student_login

Authenticate a student against the OBS MCP server using a base URL and credentials.

student_login_debug

Authenticate with additional diagnostic payloads to inspect the login flow.

student_logout

End the current session and log out the user.

student_info

Fetch basic student profile information such as personal and academic data.

student_info_parsed

Return a parsed, structured view of the student information.

parse_student_info

Parse raw HTML or content into structured student information.

student_announcements

Retrieve announcements for the student, with optional path and limit.

student_courses

Get the list of courses for the student, with optional path.

student_transcript

Fetch the academic transcript for the student.

student_term_courses

Retrieve courses for the current term.

student_my_courses

Get the list of courses the student is enrolled in.

student_navigate_to_page

Navigate to a specific OBS page and retrieve its content.

student_academic_analytics

Provide a comprehensive academic analytics report including GPA trend and credits completed.

student_performance_tracking

Track academic performance against set targets and progress toward graduation.

student_course_advisor

Offer course recommendations based on prerequisites, credits, and conflicts.

student_notifications

Fetch all notifications for the student, including priorities and read status.

student_notification_settings

Manage notification preferences and triggers.

student_mark_notification_read

Mark a notification as read by its ID.

student_export_data

Export student data in formats such as JSON or CSV.

student_export_formats

List supported export formats.