UAAR University

You can run the UAAR University MCP Server to give Claude AI agents structured access to UAAR’s academic ecosystem. It exposes tools for academic operations, admissions, student services, and administrative tasks, enabling intelligent automation and quick information retrieval through both a local CLI integration and a web API.

How to use

You will connect your MCP client to the UAAR University MCP Server using either the local CLI transport or the HTTP/SSE API. With the CLI transport, you run the server in standard input/output mode and issue tool requests directly through the Claude Code CLI or a compatible MCP client. With the HTTP/SSE API, you access the same 53 tools through a REST-like interface over http.

Typical usage patterns include asking for course information, checking admission status, retrieving class or exam schedules, managing library or hostel services, and querying administrative data. You can choose the Transport Mode that fits your workflow: using the Claude Desktop/Code CLI for direct interactions, or using the HTTP/SSE API for programmatic access from any HTTP client.

How to install

Prerequisites include Python 3.10 or newer, Git, and either Claude Desktop or Claude Code CLI. You also need about 500MB of free disk space and a working internet connection.

# Step 1: Clone the server repository
git clone https://github.com/SARAMALI15792/InstituaionMCPServer.git
cd InstituaionMCPServer

# Step 2: Install dependencies
pip install -e .
# or if you prefer a faster setup in development
uv pip install -e .

# Step 3: Configure environment
cp .env.example .env
# Edit .env to set your preferred values

# Step 4: Run the server (CLI transport)
python -m server.cli
# This starts the CLI/stdio transport for Claude Code CLI integration

# Step 5: Run the server (HTTP/SSE API transport)
python -m server.main
# This starts the HTTP/SSE API at http://localhost:8000

Configuration, security, and notes

Configuration is driven by environment settings. An example environment template is provided as .env.example. Customize this file to configure database connections, authentication settings, and network options. The server uses JWT-based authentication and bcrypt for password hashing, and relies on an SQLite database with a 25-table schema seeded for initial use.

Security features include JWT tokens with a 30-minute expiry, role-based access control, input validation, parameterized queries to prevent injection, and audit logging. HTTPS is recommended for production deployments, and you should enable rate limiting and IP whitelisting if exposed to the public internet.

If you need to upgrade or troubleshoot, you can first verify that the HTTP API is reachable at http://localhost:8000 and that the CLI transport responds via standard input/output. For production deployments, consider containerization with Docker, a traditional server with a reverse proxy, or deployment on a cloud platform.

Available tools

search_courses

Search university courses by name or code.

list_departments

Retrieve a list of all academic departments.

get_merit_list

Fetch merit rankings for a department.

get_class_schedule

Get class timetables.

get_exam_schedule

Get exam schedules.

get_today_classes

Show today’s classes.

check_admission_status

Check admission status for a user.

start_admission_form

Begin a new admission application.

fill_admission_field

Fill a step in the admission form.

preview_admission_form

Preview the admission form before submission.

confirm_and_submit_admission_form

Submit the admission form.

search_library_books

Search library catalog.

check_book_availability

Check availability of a library book.

check_hostel_availability

Check hostel room availability.

get_mess_menu

Retrieve campus meal options.

get_bus_routes

Get campus bus routes.

find_bus_stop

Find a bus stop location.

list_scholarships

List available scholarships.

check_scholarship_eligibility

Check eligibility for scholarships.

get_semester_result

Retrieve semester results.

calculate_gpa

Calculate GPA for a student.

search_faculty

Search faculty directory by keyword.

get_user_profile

Retrieve a user profile.

list_upcoming_events

List upcoming university events.

get_latest_news

Get the latest university news.

admin_add_department

Add a new department (admin only).

admin_add_course

Add a new course (admin only).

submit_help_ticket

Submit a support ticket to the admin system.

get_emergency_contacts

Retrieve emergency contact information.