An unofficial Uniclare / Student Uni Portal client built to reveal full ESE marks and every hidden result field the official portal doesn’t display. Includes Frontend, MCP Server, API, developed for personal educational purposes and not affiliated with Uniclare or Student Portal.
What Makes This Client Better than the Official Uniclare App or Student Uni Portal
- End-semester marks: Shows full ESE marks for every subject, which the official client hides even though the backend provides them.
- Complete marks breakdown: Displays all components returned by the API — end marks, IA marks, viva/practical marks, and totals.
- Additional result fields: Reveals extra data like percentage, credits, grade points, credit points, and more that the official portal doesn’t show.
- MCP server support: Allows integration with LLMs for automation, summarization, or custom result analysis.
The client can be run in several ways. For detailed steps, see the Getting Started wiki page.
Option 1. Prebuilt Releases – Download and run the latest release for your platform:
Option 2. One-Click Deployment (Render) – Deploy the client instantly in the cloud:
Option 3. Run from Source – Clone the repository and run the client directly in development mode.
-
For developers who want to modify the client.
git clone https://github.com/viraj-sh/uniclare-client cd uniclare-client python -m venv venv venv\Scripts\activate # Windows source venv/bin/activate # macOS/Linux pip install --upgrade pip pip install -r requirements/base.txt python app.py
Option 4. Build from Source – For developers or contributors: clone the repo, install dependencies, and run locally.
Option 5. Docker – Run the client in a consistent containerized environment.
For complete instructions, platform-specific steps, and Docker usage, see the Getting Started wiki.
Once the client is running, these endpoints are accessible (host may vary):
-
Frontend [http://localhost:8000/] : Static interface to interact with the API.
-
MCP Server [http://localhost:8000/mcp] : Endpoint (
/mcp) compatible with Model Context Protocol (MCP) clients like LLM Clients or LangChain bots. -
API [http://localhost:8000/api] : FastAPI backend for authentication, semesters, subjects, documents, and attendance.
- Interactive Docs: [http://localhost:8000/docs] : API testing Swagger UI for developers.
For full instructions on configuring the MCP server, check out the MCP Documentation.
| Detailed Result | Login |
|---|---|
![]() |
![]() |
| Result List | Profile |
|---|---|
![]() |
![]() |
This project is unofficial and intended for personal and educational use only. Uniclare, Student Portal or the college has no affiliation or endorsement with this project.
Use responsibly. The author is not liable for misuse, data loss, or any violations of institutional policies.



