Labs · NPM PackageMCP Server Now in ChatGPT

vtop-mcp

A programmatic VTOP API for VIT Chennai, packaged as a Model Context Protocol (MCP) server. Ask any AI client — now including ChatGPT, plus Claude, Cursor and VS Code — about your attendance, marks, timetable, exam seats, CGPA or curriculum progress in plain language, or script VTOP access yourself.

Source npm· VIT Chennai only

Use VTOP directly from ChatGPT

Beyond the local clients, vtop-mcp now runs as a hosted remote connector. Link your VTOP account once and ask ChatGPT “what's my attendance?” — your credentials are encrypted into a personal link and never stored on the server.

1
Register
Open the connector page and enter your VTOP login. You get a personal, encrypted link.
2
Add to ChatGPT
Settings → Connectors → Create. Paste your link, set authentication to None.
3
Ask anything
Enable the connector in a chat and ask about attendance, marks, CGPA or exams.

Connect VTOP to ChatGPT vtopmcp.onrender.com

Prefer Claude, Cursor or VS Code? They run the same 12 tools locally over stdio — see the one-click options below.

$ npm i @vikranth2005/vtop-mcp

Add to your client

One click for Cursor & VS Code. Copy-paste for Claude.

Cursor

One-click deeplink

Add to Cursor

VS Code

One-click deeplink

Add to VS Code

Claude Code

Run in your terminal

claude mcp add vtop -- npx -y @vikranth2005/vtop-mcp

Claude Desktop

Paste into claude_desktop_config.json

{ "mcpServers": { "vtop": { … } } }

On first use the assistant fetches a captcha, reads it, and logs in. Set VTOP_USERNAME / VTOP_PASSWORD in the env block for hands-free login, or it'll ask you in chat. Windows: keep NODE_OPTIONS=--use-system-ca.

12 read-only tools

Scrapes like a browser using cookies, CSRF and captcha. Nothing is written back to VTOP.

get_captchaFetch the login captcha image (the model OCRs it)

loginAuthenticate. Uses env creds or asks you in chat

logoutEnd the VTOP session

get_semestersList every available semester

get_profileName, reg no, branch, school, contact

get_attendancePer-course attended / total / %

get_timetableSlots, venues, faculty, credits

get_marksComponent-wise internal assessment marks

get_exam_scheduleCAT-1 / CAT-2 / FAT dates + seats

get_semester_gradesCourse grades + GPA for a term

get_grade_historyCGPA, credits, per-semester GPA

get_curriculum_progressCredits left, baskets, grade spread