{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_bm7zhay7nwbm","handle":"vit-student-mcp","url":"https://wellknown.network/agents/vit-student-mcp","links":{"self":"https://wellknown.network/agents/vit-student-mcp/record.json","html":"https://wellknown.network/agents/vit-student-mcp","markdown":"https://wellknown.network/agents/vit-student-mcp/record.md","api":"https://wellknown.network/api/v1/agents/vit-student-mcp","status":"https://wellknown.network/api/v1/agents/vit-student-mcp/status","claim":"https://wellknown.network/agents/vit-student-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/vit-student-mcp/claim.json","badge":"https://wellknown.network/agents/vit-student-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:vit-student-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"vit-student-mcp","summary":"A local MCP server for VIT students to sync and access VTOP data with Claude.","description":"# VIT Student MCP Server\n\nA powerful local Model Context Protocol (MCP) server designed for VIT students. It seamlessly scrapes your VTOP profile using a headless Playwright browser and exposes all your academic data (Marks, Attendance, Exams, Assignments, Timetable) to Claude Desktop as an AI assistant tool.\n\n**Key Features:**\n- **Auto-Captcha Solving**: Uses a lightweight Neural Network (`ddddocr`) to automatically solve VTOP captchas.\n- **Full Automation**: Injects JS exactly like the official Android App to safely extract data from VTOP.\n- **SQLite Caching**: Saves everything locally so the MCP server responds instantly to Claude without needing to hit VTOP repeatedly.\n- **Claude Integration**: Ask Claude questions like \"What's my schedule tomorrow?\", \"Did I pass Cloud Computing?\", or \"Am I debarred in any subject?\"\n\n---\n\n## 🛠️ Installation & Setup\n\n### 1. Prerequisites\nYou need **Python 3.9+** and `pip` installed on your machine.\nIf you use Conda, it is highly recommended to create a new environment:\n```bash\nconda create -n vit-mcp python=3.11\nconda activate vit-mcp\n```\n\n### 2. Install Dependencies\nClone this repository and install the required packages:\n```bash\ngit clone https://github.com/Inesh03/VIT-STUDENT-MCP-SERVER.git\ncd VIT-STUDENT-MCP-SERVER\npip install -r requirements.txt\n```\n\n### 3. Install Playwright Browsers\nThe scraper requires headless Chromium to run:\n```bash\nplaywright install chromium\n```\n\n---\n\n## 🔄 How to Sync Your Data\nBefore Claude can answer questions, you need to pull your latest data from VTOP into the local database.\n\nRun the sync script in your terminal:\n```bash\npython src/sync.py\n```\nYou will be prompted to enter your Registration Number and Password. The script will open a hidden browser, solve the Captcha automatically, and download your entire academic profile!\n\n---\n\n## 🤖 Connecting to Claude Desktop\nTo let Claude access your data, you need to add this project as an MCP Server.\n\n1. Open your Claude Desktop Configuration File:\n …","publisher":null,"homepage":null,"repository":null,"version":"1.0.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:vit-student-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"infra.browser-automation","name":"Browser Automation","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.802,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.779,"provenance":"derived"}],"categories":["data","dev","infra"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"vit-student-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:14.434Z","publishedAt":"2026-06-08T13:28:50.931824Z","latestVersion":"1.0.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"vit-student-mcp","url":"https://pypi.org/project/vit-student-mcp/","firstSeenAt":"2026-09-10T15:23:44.105Z","fetchedAt":"2026-09-10T15:23:44.105Z","normalizedAt":"2026-09-10T15:23:44.105Z"}]},"firstSeenAt":"2026-09-10T15:23:44.105Z","updatedAt":"2026-09-10T15:25:14.434Z"}