moses-mcp
The moses-mcp server provides access to TU Berlin's public Moses MTS (Modulverzeichnis) system, allowing you to search, browse, and analyze degree programs and modules without login. You can:
Search degree programs by name, optionally filtering by faculty or degree type (Bachelor/Master).
Retrieve a program's curriculum structure (e.g., Pflichtbereich, Wahlpflichtbereich) with module/credit counts per area.
List modules within a curriculum area, including credits, grading, exam type, Turnus, and StuPO passing rules.
Search modules by title or module number, returning details like credits, language, and responsible person.
Get full module details: description, learning outcomes, content, exam type, teaching language, and cross-listings (which other programs use that module).
Answer complex queries, e.g., identify mandatory modules with specific exam types, or find all programs that use a module.
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., "@moses-mcp Which modules are mandatory for the Informatik B.Sc.?"
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.
moses-mcp
An MCP server for discovering degree programs and modules in Moses — TU Berlin's course, exam, and module planning system. It talks to Moses' official REST API (https://moseskonto.tu-berlin.de/moses/api/v2), which innoCampus (who run Moses) can provision on request.
Scope
Search and browse degree programs (Studiengänge) and their curriculum structure (Pflichtbereich, Wahlpflichtbereich, ...).
Search modules and read full module descriptions, including exam type (Prüfungsform) and which other degree programs use a given module.
Out of scope: Vorlesungsverzeichnis (VVZ)/timetables, and anything requiring login (exam registration, editing module data).
Related MCP server: hisinone-mcp
Tools
Tool | What it does |
| Search degree programs by name, e.g. "Informatik" |
| Get a program's curriculum areas (Pflichtbereich, Wahlpflichtbereich, ...) with module/credit counts |
| List the modules in one curriculum area, with credits, grading, exam type, and Turnus — plus the StuPO's passing rules for that area (e.g. credit min/max) |
| Search modules by title or number, e.g. "Computer Vision" |
| Full module description: content, exam type, and which other degree programs use it |
Example things you can ask an MCP client connected to this server:
"Which modules are mandatory (Pflichtmodul) for the Informatik B.Sc.?"
"Of those, which use a Portfolioprüfung instead of a written exam?"
"Recommend some Computer Vision modules for the Computer Science Master's."
"What other degree programs can take module 40022?"
"Make me a 6-semester study plan for the Informatik B.Sc. specializing in Theoretical Computer Science" (respects each area's StuPO passing rules, not just credit totals)
Requirements
Node.js 20 or later
A Moses API token (see below)
API access
There's no self-service signup — email innoCampus (who run Moses) and ask for API access; they'll issue a token and tell you which endpoints are enabled for it. Keep the token secret: it authenticates as you, and the endpoint owners can rate-limit or block API keys that generate excessive load (e.g. bulk-scanning without cause), so use refresh: true sparingly and avoid scripting bulk queries beyond what this tool already does.
Setup
git clone <this-repo>
cd moses-mcp
npm install
cp .env.example .env # then edit .env and set API_TOKEN=<your token>
npm run buildThis produces a runnable server at dist/index.js, which communicates over stdio (standard MCP transport). The server reads .env itself on startup (resolved next to its own install location, not the caller's working directory), so a .env file in this project directory is enough — you don't need to configure the token separately in your MCP client, though you can (see below) if you'd rather not keep it in a file.
Using it with an MCP client
Claude Code
claude mcp add moses -- node /absolute/path/to/moses-mcp/dist/index.jsThis registers the server at local scope (just this project, just you). Use -s user to make it available in every project, or -s project to check a shared .mcp.json into this repo for teammates. Check claude mcp list or run /mcp inside a session to confirm it's connected.
Claude Desktop / other stdio clients
Add it to your client's MCP server config, pointing at the built dist/index.js. For example, in Claude Desktop's claude_desktop_config.json:
{
"mcpServers": {
"moses": {
"command": "node",
"args": ["/absolute/path/to/moses-mcp/dist/index.js"]
}
}
}Any MCP client that supports stdio servers can use this the same way — point it at node dist/index.js. If you'd rather not keep the token in .env, most clients also let you set per-server environment variables directly in their config (e.g. add "env": {"API_TOKEN": "..."} alongside "command"/"args" above) instead.
Enabling cross-program module usage lookups
get_module_details's usedInPrograms (which other degree programs use a module) needs a reverse-lookup index that Moses' API doesn't support querying directly — building it means scanning the full assignment tables (~445k records), which takes on the order of 10-15 minutes. So it's never built automatically; run it explicitly, and re-run occasionally to refresh (it's cached for 7 days regardless):
npm run build-usage-indexUntil this has been run at least once, usedInPrograms comes back as an empty list rather than blocking tool calls.
Development
npm install
npm run dev # run the MCP server via stdio (tsx, no build step)
npm run build # compile to dist/
npm test # run unit tests against fixture data (no network)
npm run e2e # build, then exercise all 5 tools against the LIVE APIsrc/api/client.ts is the typed REST client (token auth via X-API-Key, batched idlist lookups, a small concurrency cap). src/api/entities.ts has the API's entity shapes. The trickiest part of src/services/degreePrograms.ts is that Moses' curriculum data comes in two structurally different shapes depending on the StuPO: a newer studiengangsbereich model, and an older per-semester bolognamodulliste model still used by some programs (Informatik B.Sc. among them) — get_degree_program_structure/list_area_modules detect and handle both. src/services/moduleUsageIndex.ts builds the cross-program usage index described above. scripts/e2e-check.ts runs the built server end-to-end against the live API.
Troubleshooting
A degree program's curriculum looks empty /
mapped: false: not every Studien-/Prüfungsordnung (StuPO) has curriculum data mapped yet.get_degree_program_structureautomatically tries a few recent StuPOs to find one with data if you don't specifystupo/semesterexplicitly.Stale results after a Moses update: pass
refresh: trueto any tool to bypass the cache, or delete the.cache/directory.get_module_details'susedInProgramsis always empty: runnpm run build-usage-indexat least once — see above.A tool errors unexpectedly: the Moses API is under active development and has some known rough edges (e.g.
idlistsilently doesn't filter on a couple of endpoints — already worked around insrc/api/client.ts). If a new one shows up, issues/PRs welcome.
Available Tools
5 toolsget_degree_program_structureGet degree program curriculum structureA
Get a degree program's curriculum areas (Pflichtbereich, Wahlpflichtbereich , Wahlbereich, Bachelorarbeit, ...) for a given StuPO + semester snapshot, with module/credit counts per area. If stupo/semester are omitted, resolves the newest StuPO+semester Moses actually has curriculum data for. Use the returned stupo/semester values with list_area_modules to see the actual modules in an area.
Inputs: programId (required), stupo, refresh, semester.
get_module_detailsGet module detailsA
Get a module version's full description: title, credits, exam type (Prüfungsform), grading, teaching language, faculty/institute/Fachgebiet, learning outcomes, content, and — critically — the list of degree programs (usedInPrograms) that use this module version. Use this to answer 'what other majors could take this module'. If version is omitted, resolves the current version.
Inputs: moduleNumber (required), refresh, version.
list_area_modulesList modules in a curriculum areaA
List the modules assigned to one curriculum area of a degree program (e.g. 'Pflichtbereich' or 'Wahlpflichtbereich Theoretische Informatik'), for a specific StuPO + semester (get these from get_degree_program_structure first). Each module includes credits (lp), whether it's graded, its exam type (examType, e.g. 'Schriftliche Prüfung' or 'Portfolioprüfung'), and Turnus. Filter the results client-side on examType to answer questions like 'which mandatory modules use a Portfolioprüfung'.
Inputs: area (required), stupo (required), semester (required), programId (required), +1 more.
search_degree_programsSearch degree programsA
Search TU Berlin Moses degree programs (Studiengänge) by name, e.g. 'Informatik' or 'Computer Science'. Returns each program's id (needed by get_degree_program_structure), short name, degree type (e.g. Bachelor of Science), and faculty.
Inputs: query (required), faculty, refresh, degreeType.
search_modulesSearch modulesA
Search TU Berlin Moses modules by title or exact module number, e.g. 'Computer Vision'. Useful for discovering/recommending modules by topic. Returns module number/version, title, language(s), credits, grading, responsible person, and organizational unit (Fachgebiet). Use get_module_details for the full description and which degree programs use a given module.
Inputs: query (required), refresh, semester.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct entity and action: searching programs, getting program structure, listing modules in an area, searching modules, and getting module details. The workflow is clear, and there is no ambiguity between search functions for different entity types.
All tool names follow a consistent verb_noun pattern in snake_case: search_degree_programs, get_degree_program_structure, list_area_modules, search_modules, get_module_details. The verbs (search, get, list) accurately reflect the operations and are used consistently.
With exactly 5 tools, the server is well-scoped for its purpose of browsing degree programs and modules. Each tool covers a necessary step in the workflow without redundancy or bloat.
The tool set covers the core workflow of discovering degree programs, exploring their curriculum areas, listing modules in those areas, and retrieving module details. A minor gap is the lack of a direct 'get_degree_program' tool by ID, though search_degree_programs returns id and basic info, and get_degree_program_structure can be used with the id.
Maintenance
Related MCP Connectors
Academic literature search, retrieval, and private library management on top of OpenAlex.
Federated search of books and papers, BibTeX/RIS citations, open-access retrieval and reading.
Read-only Frosh MCP: search and read public frosh.org docs, blog and overview.
Search university course materials, your flashcards, quizzes, streak and quota. All tools read-only.
Related MCP Servers
- AlicenseBqualityDmaintenanceExposes Dutch university Osiris course catalogs as MCP tools, enabling search, retrieval, and exploration of course information across multiple institutions via the public Osiris Student API.10MIT
- AlicenseAqualityCmaintenanceEnables reading study data and downloading documents from HISinOne campus portals using the signed-in account.91MIT
- AlicenseAqualityBmaintenanceEnables read-only access to University of Leeds Minerva (Blackboard Learn Ultra) and Gradescope through a browser-authenticated session. Supports listing courses, announcements, contents, grades, deadlines and calendar events, downloading attachments, and querying Gradescope assignments and submissions.36ISC
- AlicenseBqualityBmaintenanceEnables users to query official undergraduate and graduate course schedules, indexes, prerequisites, and exam timetables, including tools for comparing indexes and finding matching schedules. It is read-only, local, and supports filtering by days, times, lesson types, teaching weeks, and schedule clashes.7211 PyPI1MIT