ufind-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., "@ufind-mcp When and where does 180013 meet?"
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.
ufind-mcp
An MCP server for u:find, the course catalogue of the University of Vienna. Ask your assistant what a department offers this semester, when a course meets, who teaches it, or where a room is. Read only, no account, no API key.
Install
git clone https://github.com/ParadoxTR/ufind-mcp.git
cd ufind-mcp
uv syncAdd it to Claude Code:
claude mcp add ufind --scope user -- uv --directory /absolute/path/to/ufind-mcp run ufind-mcpOr add it to Claude Desktop, Cursor or any other MCP client:
{
"mcpServers": {
"ufind": {
"command": "uv",
"args": ["--directory", "/absolute/path/to/ufind-mcp", "run", "ufind-mcp"]
}
}
}Related MCP server: University Course Catalog MCP Server
What you can ask
Which courses does the Bachelor Informatik programme offer in 2026W?
When and where does 180013 meet, and who teaches it?
Find logic courses next semester with fewer than 3 ECTS.
What is Benjamin Schnieder teaching this winter?
Give me the module structure of the Master Philosophie curriculum.
Tools
Tool | What it does |
| Free text course search across titles, LV numbers, lecturers and semesters |
| One course in full: groups, lecturers, every date and room, curriculum placement, description, registration window, exams |
| Weekly pattern and all dates of a group, or the raw iCal feed |
| Every top level unit of the Vorlesungsverzeichnis for a semester |
| Bachelor, Master, Doktorat and extension curricula, filterable by department or name |
| Every course a department or programme offers in a semester, grouped by module |
| Curriculum structure without the courses |
| Staff lookup with room, email and affiliations |
| Institutes, departments and faculties |
| Courses that have exam records |
| Which semester codes exist and which one is current |
Semesters are written 2026W (winter 2026/27) or 2027S. Every tool also accepts current, next and previous.
Configuration
Variable | Default | Meaning |
|
| Set to |
|
| Where responses are cached |
| unset | Set to |
|
| Request timeout, the staff search page can be slow |
|
| Minimum pause between requests |
|
| User agent sent to u:find |
Good to know
u:find has no public API. This server reads the XML endpoints that the mobile clients use and, for the parts those endpoints do not cover, the public web pages. That means the university can change things without notice. Requests go out one at a time with a small pause, and every response is cached on disk, so normal use stays light on their servers.
A semester that has not started yet is incomplete. Course descriptions, registration windows and exam dates often stay empty until the term begins.
Catalogue paths are specific to one semester, so a programme has a different id in 2026W than in 2026S. The server resolves programmes by name for the semester you ask about and warns you if a path belongs to a different term.
A course that counts towards several modules appears once per module in a programme listing. Output always states how many entries and how many distinct courses that is.
Tests
uv run python tests/smoke.py # live data, parsing and completeness
uv run python tests/mcp_smoke.py # calls every tool over the MCP protocolDisclaimer
This project is not affiliated with, endorsed by or supported by the University of Vienna. It reads endpoints that are not part of a documented public API, so it can break at any time. Use it for your own studies and keep the default rate limiting in place. If you need guaranteed access, ask the university.
License
MIT
Available Tools
13 toolsget_courseARead-only
Everything about one course: type, ECTS, groups, lecturers, all dates with rooms, curriculum placement, plus description, assessment, registration window and exam dates.
Inputs: lv (required), semester, include_description. Returns: result
get_course_scheduleARead-only
Dates, times and rooms of a course group, as a weekday summary plus every single date, or as an iCal feed to subscribe to.
Inputs: lv (required), group, as_ical, semester. Returns: result
get_program_coursesARead-only
The complete course list a department or degree programme offers in one semester, grouped by curriculum module, in one request. Use this for "what does department/programme X offer in semester Y".
Inputs: program (required), limit, module, semester, +2 more. Returns: result
get_program_modulesARead-only
Module tree of a programme or department without any courses, a cheap overview of how a curriculum is structured.
Inputs: program (required), semester. Returns: result
get_staffARead-only
Contact details, room and affiliations of one person.
Inputs: id (required). Returns: result
get_unitBRead-only
One institute/department: name, website, locations and place in the university hierarchy.
Inputs: id (required). Returns: result
list_departmentsARead-only
All top-level units of the Vorlesungsverzeichnis for a semester: the 'Studienprogrammleitung' (SPL) departments plus special categories, each with the VVZ path needed to list its courses.
Inputs: semester. Returns: result
list_programsARead-only
Degree programmes and extension curricula (Bachelor, Master, Doktorat, Erweiterungscurriculum) offered in a semester, optionally filtered by department or name.
Inputs: limit, query, semester, department. Returns: result
list_semestersARead-only
Which semester codes to use, and which one counts as 'current'. Past semesters are archived; a semester more than one term ahead is usually still empty.
Inputs: no named parameters. Returns: result
search_coursesARead-only
Free-text search over all u:find courses (Lehrveranstaltungen).
Matches titles, LV numbers, lecturer names and semester codes. Use for "is there a course about X" or "what does lecturer Y teach".
Inputs: query (required), limit, semester. Returns: result
search_examsARead-only
Courses with matching exam records (Prüfungstermine). Returns the courses; call get_course for the concrete exam dates.
Inputs: query (required), limit, semester. Returns: result
search_staffARead-only
Find university staff by name; returns ids, unit, email and room where published.
Inputs: query (required), limit. Returns: result
search_unitsBRead-only
Find institutes, departments and faculties (addresses, website, hierarchy).
Inputs: query (required), limit. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Most tools are clearly separated by resource and action (courses, programs, staff, units, exams), and descriptions clarify purpose. The main overlap is get_course and get_course_schedule, since get_course already includes dates and rooms, though the schedule tool's iCal/group focus gives it a distinct use case.
All tool names follow a consistent verb_noun pattern using search_, get_, and list_. The verbs align predictably with behavior: search for discovery, get for details, list for enumerations.
13 tools is well-scoped for a university course and directory server. Each tool covers a meaningful part of the domain without redundancy or bloat.
The surface covers the full browse-and-search lifecycle for courses, schedules, programs, staff, units, exams, and semester metadata. Since this is a read-only university directory, CRUD gaps are not applicable, and the available operations support realistic queries without dead ends.
Maintenance
Related MCP Connectors
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Hosted MCP for LearnOS: search courses, lesson citations, flashcards and notes from any MCP client.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server for querying a university course catalog. Enables searching courses, checking prerequisites, and looking up instructors via natural language.-
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes a university course catalog to LLMs, enabling course search, prerequisite lookup, instructor details, and department directory through natural language.-
- AlicenseNot gradedqualityCmaintenanceA read-only MCP server exposing NTNU course data to LLM assistants, enabling course catalog search, teaching schedules, weekly timetables, grade statistics, and course comparison tools.MIT
- AlicenseNot gradedqualityCmaintenanceA local MCP server that exposes your UPV academic calendar and PoliformaT data to MCP clients, enabling natural language queries for classes, deadlines, announcements, and materials.1MIT