Digii Campus MCP Server
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., "@Digii Campus MCP Server show my attendance summary for this term with per-course breakdown"
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.
Digii Campus MCP Server
Read-only MCP server (Python + FastMCP, stdio transport) wrapping the
Digii/CollPoll student portal REST API — works for any college on the
Digii platform (<your-college>.digiicampus.com). Exposes attendance,
courses, timetable, calendar, profile, drive usage, the campus feed, mentor,
hostel, passes, notifications, help-centre requests and venue bookings as
trimmed, high-signal MCP tools — plus exactly ONE write: gated outpass filing
(preview_outpass + create_outpass, refused unless confirmed=true).
Coverage proof: CENSUS.md (86 endpoints mapped, 81 live-verified). Gap analysis: GAPCLOSE.md (form schemas, submit targets, blocked families).
Setup
One-liner (uvx, recommended) — no clone needed:
uvx digii-campus-mcpCreate a .env in your working directory (or export in your shell) as
below, and point your MCP client at the command above instead of a venv
path.
From source:
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .envFill in .env:
DIGII_BASE_URL=https://<your-college>.digiicampus.com
DIGII_UKID=<your numeric student id>
DIGII_AUTH_TOKEN=<your JWT>
DIGII_TERM=32 # optional, current term id for attendanceGetting the token and ukid
Log into your college portal in your browser. Your ukid is the number in your
profile URL (/users/<ukid>/...). For the token, open DevTools, then
Application, then Local Storage, and copy the token field inside userInfo
(the user cookie holds the same JWT). Tokens expire; when a call returns
TOKEN_EXPIRED, paste a fresh one. Never commit .env.
Related MCP server: IIT Roorkee Academics MCP
Tools
Tool | Description |
| Overall attendance percent plus per-course and component breakdown. |
| Enrolled courses: code, name, class, faculty, credits, next class times. |
| Upcoming lessons over the next N days with start and end, venue, faculty, |
| Institutional calendar events (holidays, fests). |
| Compact identity card (ukid, user type, tenant, pending stats). |
| Human-readable drive used, free, allocated. |
| Latest campus feed posts: text, author, timestamp. Announcements and community posts; for personal alerts use |
| Assignments per class (all classes when |
| Full assignment detail: description, dates, submission state, grade fields, mark limits, submissions, resource file URLs. |
| Without |
| Gradebook snapshot for a class: student identity plus published assessment component results and grades (empty until declared). |
| Assigned faculty mentor: name, email, phone, department. |
| Allotment (hostel, room, status, dates) plus hostel attendance roll for the last N days plus profile hostel data. |
| Quick pass/outpass status check; when the console is empty, outpass history via the Campus Help Centre requests list as fallback. For the full record use |
| List-only notification bell: unread count plus newest rows. Never marks anything read (see note). |
| Complete help-desk record: service catalogue plus paged request list; with |
| Own venue bookings in the period window (TODAY, TOMORROW, NEXT_7_DAYS, PAST) plus student-bookable venue types. |
| No-mutation preview: builds the exact JSON that would be POSTed to |
| THE ONLY WRITE IN THIS SERVER. Files the outpass via |
Auth: every request sends header Auth-Token. A 401 surfaces a
TOKEN_EXPIRED tool error instructing you to refresh the token. Requests are
sequential, 20s timeout, no retries on 4xx, and the token is never logged.
Safety envelope: mutations are limited to the outpass filing pair above.
preview_outpass performs GETs only (form schema) and never submits;
create_outpass refuses with no HTTP request at all unless confirmed is
literally true. get_notifications is list-only by design — the mark-read
endpoints (PUT /rest/service/readNotificationObjects, legacy
POST /rest/feed/seenByUkid/v2) are intentionally never called so unread
counts stay authoritative; no other tool writes anything.
Mandatory client setup: per-tool approval (read this)
Eighteen tools in this server pour untrusted third-party text (feed posts,
assignment descriptions, notification content, help-desk comments) into your
agent's context. A crafted post could instruct the agent to file an outpass,
and the agent would supply confirmed=true itself. The server's confirmation
gate stops accidents; it cannot stop a manipulated agent, because the agent
is the party being asked to confirm — and a fraudulent outpass lands on a
real warden's desk under the student's name.
So: configure your MCP client to auto-approve the 18 read tools and always
require human approval for create_outpass (preview_outpass may stay
auto-approved; it performs no mutation). This is mandatory setup, not
optional hardening. Examples:
Claude Code / OpenCode: add
create_outpassto the ask/approval list (e.g. OpenCodepermissionrules), leave the rest allowed.Claude Desktop: set tools to ask-first where supported, or confirm the preview output in chat before any
create_outpasscall.Any client: never grant blanket write approval to this server; the only write it contains is the one that notifies a human authority.
Run locally for a smoke test:
source .venv/bin/activate
python3 verify.py # live verification against your portal
python3 server.py # stdio serverClient configuration
Use your own paths. The server reads .env from its own directory, so no
secrets belong in client configs.
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"digii-campus": {
"command": "/path/to/digii-mcp/.venv/bin/python",
"args": ["/path/to/digii-mcp/server.py"]
}
}
}OpenCode (opencode.json)
{
"mcp": {
"digii-campus": {
"type": "local",
"command": [
"/path/to/digii-mcp/.venv/bin/python",
"/path/to/digii-mcp/server.py"
],
"enabled": true
}
}
}Hermes
hermes config set mcp_servers.digii-campus \
'{"command": "/path/to/digii-mcp/.venv/bin/python",
"args": ["/path/to/digii-mcp/server.py"],
"timeout": 60}'Restart the client after adding. Do not commit .env or any file
containing the token. See CONTRIBUTING.md to add your college's coverage.
Available Tools
19 toolscreate_outpassCreate OutpassA
File an outpass request via POST /api/chc/request/v2. HARDC GATE:
confirmed MUST literally be true. If it is not true, the tool refuses without touching the network — run preview_outpass with the SAME params first, review the payload, then call this with confirmed=true.
Inputs: out_date, out_time, confirmed, service_id, +3 more. Returns: result
get_assignmentGet AssignmentA
Full detail for one assignment: description, start/due dates, submission state, grade fields, mark limits, student submissions and resource files.
Inputs: class_id (required), assignment_id (required). Returns: result
get_assignmentsGet AssignmentsB
Assignments across enrolled classes (or one class): draft/upcoming/previous buckets with due dates and submission state.
Inputs: page, class_id, per_page. Returns: result
get_attendance_summaryGet Attendance SummaryB
Overall attendance percentage plus a per-course breakdown (counts and %).
Inputs: term, detail. Returns: result
get_calendar_eventsGet Calendar EventsB
Institutional calendar events (holidays, fests, exams) for SNU Chennai.
Inputs: no named parameters. Returns: result
get_class_assessmentsGet Class AssessmentsB
Gradebook snapshot for one class: the student's assessment component results and grades as published (empty when nothing is declared yet).
Inputs: class_id (required). Returns: result
get_coursesGet CoursesA
Enrolled courses with compact fields (code, name, class, faculty, credits, next class times).
Inputs: no named parameters. Returns: result
get_drive_usageGet Drive UsageB
Human-readable drive storage usage: used vs allocated (and free).
Inputs: no named parameters. Returns: result
get_feedGet FeedC
Latest posts from the campus feed: text, author, timestamp (and booth, category).
Inputs: n. Returns: result
get_help_requestsGet Help RequestsA
Campus Help Centre: requestable services + my help requests (paged);
with request_id, full detail for ONE request incl. form values and comments.
Inputs: page, per_page, request_id, include_services. Returns: result
get_hostel_summaryGet Hostel SummaryB
Hostel snapshot: allotment (hostel/room/status/dates), hostel attendance
roll for the last days days (yes/no per date), and profile hostel data.
Inputs: days. Returns: result
get_mentorGet MentorB
Assigned faculty mentor: name/salutation, contact, department.
Inputs: no named parameters. Returns: result
get_notificationsGet NotificationsA
Campus notification bell, list-only: unread count + latest rows.
NOT mutations are performed: notifications are never marked as seen (see the policy comment in server.py's implementation for why).
Inputs: limit. Returns: result
get_passesGet PassesB
My-passes console: own pass requests (paged) + hostel identity, plus, when the pass console has no rows, the help-centre outpass requests as fallback.
Inputs: page, per_page, include_fallback. Returns: result
get_profileGet ProfileA
Compact identity card for the authenticated student (ukid, user type, tenant/college, pending stats).
Inputs: no named parameters. Returns: result
get_resultsGet ResultsA
Semester results: overall CGPA/percentage rollup + every exam term with declaration state (omit term_id), or per-term course grades (with term_id).
Inputs: term_id. Returns: result
get_timetableGet TimetableB
Upcoming scheduled lessons across all enrolled courses within the next
days_ahead days (start/end, venue, faculty, requiresAttendance, status).
Inputs: days_ahead. Returns: result
get_venue_bookingsGet Venue BookingsB
My venue bookings (Book-a-Venue): self bookings in the selected period window, plus the infrastructure types a student may book direct.
Inputs: page, size, period. Returns: result
preview_outpassPreview OutpassA
PREVIEW ONLY (no mutation): build the EXACT JSON that create_outpass would POST to /api/chc/request/v2 for an outpass request and show it with a human summary. Nothing is sent to the campus API.
Inputs: out_date, out_time, service_id, description, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Most tools target a clearly distinct resource or action, and singular/plural naming helps separate get_assignments (list) from get_assignment (detail). However, get_passes and get_help_requests overlap on outpass requests because get_passes falls back to help-centre outpass data, creating some ambiguity for an agent seeking outpass information.
All read tools use a consistent get_<resource> snake_case pattern, while the two mutation-adjacent tools use preview_outpass and create_outpass. The naming is highly predictable and readable throughout.
19 tools is on the heavy side, but the broad campus domain (calendar, profile, drive, assignments, results, assessments, feed, notifications, mentor, hostel, passes, attendance, courses, timetable, help, venue, outpass) justifies nearly every tool. No obvious duplicates or filler tools exist.
Read coverage is extensive across student portal resources, but mutations are minimal: only outpass creation exists, with no cancel/update, no help-request creation, no venue booking creation, and no assignment submission. This leaves notable lifecycle gaps despite the rich read surface.
Maintenance
Related MCP Connectors
MCP server providing attendance data queries via the CloudTime API.
Notes, files, GitHub, and Drive through one MCP connection.
Notes, files, GitHub, and Drive through one MCP connection.
Notes, files, GitHub, and Drive through one MCP connection.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceSimple MCP server that exposes a tool to fetch student result/CGPA data from MANIT ERP APIs.ISC
- AlicenseAqualityCmaintenanceEnables interaction with the IIT Roorkee Academics portal through MCP tools for authentication, academic data retrieval (fee, grades, transcripts), and safe API calls.24MIT
- FlicenseNot gradedqualityDmaintenanceEnables querying student information such as marks, attendance, pending assignments, and timetables from a MySQL database through MCP tools.-
- FlicenseNot gradedqualityDmaintenanceProvides MCP tools for searching student profiles, viewing marks/attendance, and finding low-attendance students. Enables AI assistants like Gemini to interact with college student data through natural language.-