TechMCP - PSG College of Technology

TechMCP is a Python-based MCP server that connects to PSG Tech’s e-campus portal to give your AI assistants direct access to your academic data, such as CA marks, attendance, and timetables. It runs locally and serves data through an MCP connection so you can ask questions like your CA1 marks or next class, with real-time updates.

How to use

You run the TechMCP server on your machine and connect your MCP client (Cursor, Claude Desktop, or Raycast) to the local SSE endpoint. Once connected, you can query your academic data using natural language questions or your client’s MCP commands. Typical tasks include checking CA marks, viewing attendance, and getting your timetable for today or tomorrow.

How to install

Prerequisites you need before starting:

• Python 3.10 or newer
• Git
• Internet access to clone and install dependencies

git clone https://github.com/codit04/TechMCP.git
cd TechMCP

Install dependencies and set up credentials

pip install -r requirements.txt

Create and edit the configuration file to provide your PSG Tech e-campus credentials. You must fill in your actual roll number and password in the following structure.

{
  "credentials": {
    "roll_number": "YOUR_ACTUAL_ROLL_NUMBER",
    "password": "YOUR_ACTUAL_PASSWORD"
  },
  "server": {
    "host": "localhost",
    "port": 8080,
    "sse_mode": true
  }
}

Run the server

python server.py

The server starts and serves the MCP endpoint at http://127.0.0.1:8080/sse. Use this URL in your MCP client to establish a connection.

Available tools

get_ca1_subject_mark

Fetch CA1 marks for a specific subject using its subject code.

get_ca2_subject_mark

Fetch CA2 marks for a specific subject using its subject code.

get_ca1_all_marks

Retrieve CA1 marks for all subjects for the logged-in student.

get_ca2_all_marks

Retrieve CA2 marks for all subjects for the logged-in student.

get_assignment_mark_by_subject

Get assignment marks for a specific subject.

get_all_assignment_marks

Get all assignment marks across subjects.

get_tutorial_marks_by_subject

Fetch tutorial marks for a subject.

get_all_tutorial_marks

Fetch all tutorial marks.

list_available_subjects

List all available subjects.

health_check

Check the health status of the data scraper.

get_subject_attendance_percentage

Get attendance percentage for a subject.

get_all_attendance_percentages

Get attendance percentages for all subjects.

get_subject_absent_hours

Get absent hours for a specific subject.

get_all_absent_hours

Get absent hours for all subjects.

get_subject_present_hours

Get present hours for a specific subject.

get_all_present_hours

Get present hours for all subjects.

get_subject_available_bunks

Calculate available bunks for a subject while maintaining minimum attendance.

get_all_available_bunks

Calculate available bunks for all subjects.

get_next_class

Get your next scheduled class with location details.

get_todays_schedule

Get today's complete schedule.

get_schedule_from_now

Get remaining classes for today.

get_tomorrows_schedule

Get tomorrow's schedule.

get_schedule_for_day

Get schedule for a specific day.

get_weekly_schedule

Get the complete weekly timetable.

get_break_schedule

Get break times and current break status.

get_all_courses

Get the list of all courses.

search_courses

Search courses by name or code.

get_course_details

Get detailed information for a specific course.