IIT Roorkee Academics MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@IIT Roorkee Academics MCP Check my current semester fee status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
IIT Roorkee Academics MCP
A local, role-aware Model Context Protocol server for the official IIT Roorkee Academics/AIS portal at https://academics.iitr.ac.in.
The server was built from a production-bundle audit rather than a short student-only menu scrape. Its checked-in catalog contains:
577 backend operations across 23 API domains
192 dashboard screens across student, faculty, advisor, DAPC, AAO, DoSW, department, HOD, library, and shared roles
Login, email/SMS OTP, in-memory session setup, forgot-password, reset-token verification, and password-reset support
Explicit fee, profile, semester-record, gradesheet, and transcript helpers
A safe generic caller covering every recovered endpoint, including operations added to the portal later
Catalog, route, coverage, and session resources plus reusable workflow prompts
Portal authorization is not bypassed. The signed-in IITR account can only use the roles and operations allowed by the portal backend.
Install and build
Requirements: Node.js 20 or newer.
npm install
npm run buildThe stdio server entry point is:
node /absolute/path/to/iitr-academics-mcp/dist/index.jsFor Codex CLI, register that command:
codex mcp add iitr-academics -- node /absolute/path/to/iitr-academics-mcp/dist/index.jsThe server is also compatible with MCP hosts that accept a stdio command. Use node as the command and the absolute dist/index.js path as its argument.
Related MCP server: Nettskjema MCP Server
Authentication
The safest setup is to inject an existing portal session through the launch environment:
export IITR_AIS_USERNAME='your-enrollment-or-employee-id'
export IITR_AIS_ACCESS_TOKEN='your-current-AIS-AccessToken'
node dist/index.jsDo not commit these values or place them in a shared MCP configuration. They are intentionally absent from this repository.
Alternatively, call ais_auth_login, then ais_auth_verify_otp when the portal requires the 5-digit email/SMS OTP. The password and OTP are used only for their individual requests; the resulting token is held only in process memory.
Use ais_auth_status to check the session. It returns authentication source and token-expiry metadata, but never returns the token or decoded account claims.
MCP surface
Tool | Purpose |
| Show redacted session status |
| Set username and AccessToken in memory |
| Login with username/password |
| Finish email/SMS OTP login |
| Request the login OTP by SMS with confirmation |
| Clear the in-memory session |
| Send reset email, behind a feature flag and confirmation |
| Verify a reset token |
| Complete reset, behind a feature flag and confirmation |
| Change the authenticated account password using the portal cipher |
| Encrypt/decrypt AES, DES, TripleDES, or Rabbit portal payloads |
| Search endpoints/screens by query, domain, role, or risk |
| Inspect one endpoint or route |
| Return a shareable dashboard screen URL |
| Return the academic services linked by AIS |
| Invoke any cataloged or API-relative operation |
| Execute up to 20 non-mutating operations |
| Multipart upload with confirmation, path boundary, and size limit |
| Read and decrypt student profile data |
| Read current-semester fee status |
| Read and decrypt fee details and total |
| Read and decrypt semester history |
| Prepare the portal request and decrypt gradesheet data |
| Read and decrypt the authenticated student's transcript |
Resources:
iitr://catalog/endpointsiitr://catalog/routesiitr://catalog/coverageiitr://session/statusiitr://catalog/external-portals
Prompts:
ais-safe-operationais-fee-workflow
Calling an operation safely
Call
ais_list_featureswith a focused query.Inspect the selected operation with
ais_get_feature.For a read, call
ais_callwith the required query or JSON body.For a mutation, review the exact endpoint and payload, obtain user confirmation, then set
confirmWrite: true.
AIS often uses POST even for reads. The catalog records methods observed in the production client and separately classifies whether an operation mutates state. Seven unused environment constants have an explicit assumed-post method-evidence marker instead of being presented as observed calls.
Example read:
{
"identifier": "DIRECT_FEE_BASE_URL_GETSTUDENTCURRENTSEMFEES",
"body": {
"EnrollmentNo": "YOUR_ENROLLMENT",
"StSession": "2026-27",
"Semester": "Autumn"
}
}Example route lookup:
{
"route": "student-acad-fees-page"
}Security controls
Requests are restricted to the configured Academics API origin and
/api/prefix by default.Authentication follows the portal client exactly:
usernameplusauthorization: Bearer <AccessToken>.Passwords, OTPs, tokens, cookies, authorization headers, and JWT-looking strings are recursively redacted from tool output.
Token storage is memory-only.
Mutating and uncataloged non-GET calls require
confirmWrite: true.Password mutation tools are disabled unless
IITR_AIS_ENABLE_PASSWORD_TOOLS=1.Response size and timeout limits are enforced.
Multipart files must stay under
IITR_AIS_UPLOAD_ROOTand the total size limit.Multipart symlinks are resolved before the upload-root check.
Authenticated requests and uploads reject redirects so credentials and files cannot be forwarded to another origin.
Custom headers are allowlisted; callers cannot replace authorization or cookie headers.
See SECURITY.md for the trust model and configuration controls.
Configuration
Copy .env.example only as a reference; this project does not automatically read .env files.
Variable | Default | Meaning |
| unset | Enrollment/employee/portal username |
| unset | Existing AIS AccessToken |
| official | API base |
| official portal URL | Dashboard URL base |
|
| Request timeout |
|
| Maximum response size |
| process working directory | Only local tree allowed for multipart files |
|
| Maximum total bytes per multipart call |
|
| Permit calls outside the official API boundary |
|
| Enable password-reset mutations |
|
| Write startup diagnostics to stderr |
Verification
npm run typecheck
npm test
npm run build
npm auditThe completion audit asserts that every recovered endpoint resolves through ais_call, every recovered screen resolves through ais_get_portal_route, all URLs remain under the official API origin, method evidence is explicit (observed or assumed-post), and all catalog identifiers are unique.
For the domain-by-domain breakdown, see COVERAGE.md.
Scope and portal changes
The catalog is a snapshot of the production Angular client audited on 10 July 2026. ais_call accepts a safe API-relative path as an escape hatch for new backend operations before the catalog is refreshed. The production portal remains the source of truth for accepted payload fields and account permissions.
Available Tools
24 toolsais_auth_loginLog In to IITR AISA
Submit enrollment/employee username and password to AIS. If OTP is required, finish with ais_auth_verify_otp. Credentials are retained only for the request.
Inputs: password (required), username (required).
ais_auth_logoutClear AIS SessionAIdempotent
Forget the in-memory AIS session. The current portal has no remote logout endpoint.
Inputs: no named parameters.
ais_auth_send_sms_otpSend AIS Login OTP by SMSA
Ask AIS to send the current login OTP by SMS. This transmits the username and requires explicit confirmation.
Inputs: confirm (required), username.
ais_auth_set_sessionSet Existing AIS SessionAIdempotent
Set an existing portal username and AccessToken in process memory. Prefer environment variables because MCP tool arguments may be logged by clients.
Inputs: username (required), accessToken (required).
ais_auth_statusAIS Authentication StatusARead-only
Show whether this MCP process has an IITR AIS session. Tokens are never returned.
Inputs: no named parameters.
ais_auth_verify_otpVerify AIS Login OTPA
Verify the 5-digit IITR email/SMS OTP and establish an in-memory AIS session.
Inputs: otp (required), username.
ais_batch_readBatch Read IITR AISARead-only
Run up to 20 cataloged non-mutating operations sequentially. POST-based reads are supported.
Inputs: requests (required).
ais_callCall Any IITR AIS OperationADestructive
Call a cataloged endpoint by symbol/alias/URL, or an API-relative path. Cataloged mutations and uncataloged non-GET calls require confirmWrite=true.
Inputs: identifier (required), body, query, method, +3 more.
ais_crypto_transformTransform AIS Encrypted PayloadCRead-only
Encrypt or decrypt an AIS payload with CryptoJS-compatible AES, DES, TripleDES, or Rabbit. Session-key mode derives the portal key from the active AccessToken.
Inputs: value (required), operation (required), key, algorithm, +1 more.
ais_get_featureGet IITR AIS FeatureARead-only
Resolve one endpoint symbol/alias/URL or one dashboard route.
Inputs: identifier (required).
ais_get_portal_routeGet AIS Screen URLARead-only
Return the shareable dashboard URL for a cataloged AIS screen. The recipient must log in with their own permissions.
Inputs: route (required).
ais_list_external_portalsList IITR Academic PortalsARead-only
Return the external academic services linked by the production AIS login/dashboard.
Inputs: no named parameters.
ais_list_featuresList IITR AIS FeaturesBRead-only
Search the production-derived endpoint and screen catalog by text, API domain, portal role, or mutation status.
Inputs: kind, role, limit, query, +3 more.
ais_password_changeChange Authenticated AIS PasswordCDestructive
Change the current account password using the portal's encrypted changeAuthPass protocol.
Inputs: confirm (required), newPassword (required), currentPassword (required).
ais_password_reset_completeComplete AIS Password ResetADestructive
Submit the reset token and new-password payload to AIS. Requires explicit confirmation and the password-tools feature flag.
Inputs: confirm (required), payload (required).
ais_password_reset_requestRequest AIS Password ResetA
Send an AIS password-reset email. Requires explicit confirmation and the password-tools feature flag.
Inputs: email (required), confirm (required).
ais_password_reset_verifyVerify AIS Password Reset TokenARead-only
Verify a password-reset token without changing the password.
Inputs: payload (required).
ais_student_fee_detailsGet Student Fee DetailsCRead-only
Read and decrypt current-semester fee details and the total returned by AIS.
Inputs: payload.
ais_student_fee_statusGet Student Fee StatusBRead-only
Read the current-semester fee status from the official AIS fees service.
Inputs: payload.
ais_student_gradesheetGet Student GradesheetBRead-only
Read and decrypt semester gradesheet data. Pass EnrollmentNo, semRecrdid, SemesterID, StSession, and Semester from a semester record.
Inputs: payload.
ais_student_profileGet Student ProfileARead-only
Read and decrypt student personal/profile information; pass the fields required by the portal, usually Enrollment.
Inputs: payload.
ais_student_semester_recordsGet Semester RecordsCRead-only
Read and decrypt a student's semester records from the endpoint used by the student screens.
Inputs: payload.
ais_student_transcriptGet Student TranscriptCRead-only
Read and decrypt the authenticated student's transcript data from the endpoint used by the student transcript screen.
Inputs: payload.
ais_uploadUpload a File to IITR AISC
Call a cataloged multipart upload operation. Every file must be inside IITR_AIS_UPLOAD_ROOT and the total must fit IITR_AIS_MAX_UPLOAD_BYTES.
Inputs: files (required), identifier (required), confirmWrite (required), query, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Each tool has a clearly distinct purpose, covering authentication steps, batch operations, cataloged calls, crypto, feature retrieval, password management, and various student data endpoints. No overlapping tool functions; descriptions are precise.
All tools follow a consistent 'ais_verb_noun' pattern in snake_case, making it easy to predict functionality from the name. No mixing of conventions or odd abbreviations.
With 24 tools, the count is slightly high but still reasonable for a comprehensive academic portal. Each tool serves a specific function, and the scope justifies the number.
The tool surface covers core workflows: authentication, password management, student data retrieval (fees, grades, transcript, profile, semester records), feature catalog browsing, and file upload. Minor gaps exist (e.g., no course registration or direct profile update), but the essential operations are present.
Related MCP Connectors
Authenticated MCP access to WebMoney wallets, transactions, messages and invoices.
Authenticated MCP access to the AIKI open knowledge commons.
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
MCP adapter for the Paxaver school community platform. Streamable HTTP, OAuth 2.1, capability auth.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables interaction with D2L Brightspace through the MCP protocol, supporting multi-strategy authentication and opt-in write operations.146 npm16MIT
- AlicenseAqualityBmaintenanceEnables interaction with Nettskjema forms, submissions, invitations, and data export through the MCP protocol.38GPL 3.0
- AlicenseNot gradedqualityDmaintenanceSimple MCP server that exposes a tool to fetch student result/CGPA data from MANIT ERP APIs.ISC
- AlicenseNot gradedqualityCmaintenanceMCP server for Canvas LMS with automatic OAuth authentication. Enables interaction with courses, assignments, grades, modules, discussions, quizzes, files, calendar, messaging, and more without manual API token management.3,565 npm1MIT