Skip to main content
Glama

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 sync

Add it to Claude Code:

claude mcp add ufind --scope user -- uv --directory /absolute/path/to/ufind-mcp run ufind-mcp

Or 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

search_courses

Free text course search across titles, LV numbers, lecturers and semesters

get_course

One course in full: groups, lecturers, every date and room, curriculum placement, description, registration window, exams

get_course_schedule

Weekly pattern and all dates of a group, or the raw iCal feed

list_departments

Every top level unit of the Vorlesungsverzeichnis for a semester

list_programs

Bachelor, Master, Doktorat and extension curricula, filterable by department or name

get_program_courses

Every course a department or programme offers in a semester, grouped by module

get_program_modules

Curriculum structure without the courses

search_staff, get_staff

Staff lookup with room, email and affiliations

search_units, get_unit

Institutes, departments and faculties

search_exams

Courses that have exam records

list_semesters

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

UFIND_MCP_LANG

de

Set to en for English pages and titles

UFIND_MCP_CACHE_DIR

~/.cache/ufind-mcp

Where responses are cached

UFIND_MCP_NO_CACHE

unset

Set to 1 to disable the cache

UFIND_MCP_TIMEOUT_S

60

Request timeout, the staff search page can be slow

UFIND_MCP_MIN_GAP_S

0.25

Minimum pause between requests

UFIND_MCP_USER_AGENT

ufind-mcp/0.1 ...

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 protocol

Disclaimer

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 tools
get_courseA
Read-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_scheduleA
Read-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_coursesA
Read-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_modulesA
Read-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_staffA
Read-only

Contact details, room and affiliations of one person.

Inputs: id (required). Returns: result

get_unitB
Read-only

One institute/department: name, website, locations and place in the university hierarchy.

Inputs: id (required). Returns: result

list_departmentsA
Read-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_programsA
Read-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_semestersA
Read-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_coursesA
Read-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_examsA
Read-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_staffA
Read-only

Find university staff by name; returns ids, unit, email and room where published.

Inputs: query (required), limit. Returns: result

search_unitsB
Read-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

    A4/5.0

    Scored across 13 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers