VTOP MCP Server

A standalone MCP (Model Context Protocol) server that lets AI assistants fetch your university academic data from VTOP, LMS, and Vitol.

Tools

Tool	Description
get_attendance	Attendance % and per-class breakdown
get_grades	Current semester grades, CGPA, curriculum
get_all_grades	Semester-wise grade history
get_schedule	Exam schedule with venues and seats
get_calendar	Academic calendar with holidays
get_hostel	Hostel info and leave history
get_lms_assignments	Moodle assignments and due dates
get_vitol_assignments	Vitol test assignments
get_status	Check VTOP availability

Setup

Install

git clone https://github.com/legitcoconut/vtop-mcp-server.git
cd vtop-mcp-server
npm install
npm run build

Configuration

You can automatically generate the correct MCP configuration snippet for your preferred assistant/IDE by running the setup script:

For macOS/Linux:

./setup.sh

For Windows:

setup.bat

The script will ask for your VTOP credentials and output the exact configuration block needed for Claude Desktop, Claude Code, Cursor, Antigravity, Codex, or OpenCode! Simply copy and paste it into your respective settings file.

Requirements

• Node.js 18+
• canvas package system dependencies:

  # Ubuntu/Debian
  apt install build-essential libcairo2-dev libjpeg-dev libpango1.0-dev libgif-dev librsvg2-dev

Acknowledgments

This project is built upon the foundation of UniCC by Arya4930.

License

This project is licensed under the MIT License. You are free to clone, edit, distribute, and use the code for any purpose.