io.github.MartinSA04Published by GitHub account MartinSA04v0.4.0Updated Oct 25, 2026
Unofficial NTNU course data: search, timetables, grades, course info, and exam logistics.
Unofficial remote MCP server for NTNU course data: search courses and study programs, view timetables, grades, course info and exam logistics.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.MartinSA04%2Fntnu-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"ntnu-courses-unofficial": {
"type": "http",
"url": "https://ntnu-mcp.martinsundal.no/mcp"
}
}
}A remote MCP server that exposes NTNU (Norwegian University of Science and Technology) course data to LLM assistants; course catalog search, teaching schedules, weekly timetables, grade statistics, course descriptions, exam logistics, and study programs with their official study plans, plus comparison tools for students choosing between courses. Runs as a Cloudflare Worker; no installation required on the client side.
Twelve tools, all read-only:
search_courses — free-text search of NTNU's course catalog for a given year; returns codes, names, campus, and exam dates.get_course_schedule — every dated teaching activity (lectures, labs) for a course in a year, with Oslo-local times and rooms.get_weekly_timetable — the recurring weekly timetable grid for a course: weekday, times, ISO-week ranges, and rooms.get_grade_distribution — historical grade distribution for a course, per year and semester, with counts and percentages.get_course_versions — the DBH-versioned course codes (e.g. TDT4100-1) behind a bare course code, useful when grade lookups come back empty.get_semesters — NTNU's terms with ids like 26h/26v, teaching weeks, exam-period dates, and which term is current.get_course_info — everything about a course except exam logistics: credits, level, campus, prerequisites, mandatory activities, content/learning outcomes, credit reductions, the study programs the teaching is planned for, contacts, and alert notices. English by default, language: "nb" for Norwegian.get_exam_info — exam logistics for up to 10 courses in one call: every occasion (ordinary/re-sit) with date, start time, duration, permitted-aids code ("hjelpemiddelkode") with its meaning, exam system, and assigned rooms.search_study_programs — search NTNU's ~400 study programs by text, level, and city; returns program codes for get_study_plan.get_study_plan — the official plan for a program and cohort intake year: courses (codes, credits, mandatory/elective) per semester, with specialization choice points — the bridge from "I study X" to concrete course codes.compare_courses — side-by-side comparison of several courses: name, campus, exam dates, weekly teaching hours, and latest grade distribution.check_timetable_conflicts — pairwise check for weekly-schedule clashes and exam-date collisions across a set of courses, before registering for them.Paste the server's MCP URL into Claude's or ChatGPT's custom connector settings:
The server requires no authentication, since it only serves public, read-only NTNU course data.
The server is also listed in the
official MCP registry as
io.github.MartinSA04/ntnu-mcp (see server.json); clients
that browse the registry can discover it there. It is an unofficial
community server, not affiliated with NTNU. Registry updates are
tag-driven: npm version <patch|minor|major> && git push --follow-tags —
the version script keeps server.json in sync, and the
release workflow runs the check suite,
deploys the Worker, re-publishes the registry entry (GitHub OIDC), and
creates the GitHub Release.
All NTNU upstream knowledge — endpoints, retry policy, parsing of the
Liferay catalog, DBH grade statistics, and TP semester data — lives in the
ntnu-api TypeScript client
library, which this repo depends on as an npm package. Upstream fixes and
new data sources land in ntnu-api, not here. This repo's only job is to
call that typed client and shape its output for LLM consumption: English
names with Norwegian fallback, Oslo-local timestamps, grade rows collapsed
into per-term distribution tables, and guidance notes on empty results. This
layering is set out in ntnu-api's
TypeScript migration spec.
To keep load on NTNU's servers minimal, every upstream call is cached in two tiers (per-isolate memory in front of a shared Workers KV namespace), so each resource is fetched roughly once per TTL globally: catalog searches, timetables, and schedules for 1 hour; grade statistics and the semester list for 24 hours. KV failures degrade to memory-only caching, never to tool errors. In tests the cache runs memory-only.
Requires Node 22 (pinned via mise).
Common tasks, available both as mise tasks and npm scripts:
Tests run under plain Node (not the Workers pool) with vitest, driving the
tool functions directly against fetch fixtures captured verbatim from
ntnu-api's test suite — no calls to real NTNU services are made in CI or
locally.
Pushes to main deploy automatically (the repo is connected to Cloudflare
Workers Builds). For a manual deploy from a checkout:
Runs on Cloudflare's free plan: the MCP session state is backed by a Durable Object using SQLite storage, which is available on the free tier (no Workers Paid subscription required unless per-request CPU limits are hit at scale).
MIT — see LICENSE.
Source: README.md at commit 62ccc4c
Search NTNU's course catalog for a given year (server-side free-text search over course names and codes; Norwegian terms often match best, e.g. 'maskinlæring' rather than 'machine learning'). Call this first when you don't know the exact course code. Returns course codes, Norwegian names, campus, and exam dates.
pageyearrequiredqueryEvery dated teaching activity (lectures, labs) for a course in a year, with Oslo-local times and rooms. Long output for large courses — prefer get_weekly_timetable for a compact recurring-week overview.
yearrequiredcourse_coderequiredThe recurring weekly timetable grid for a course in a year: weekday, times, ISO-week ranges, rooms, and a classified 'kind' per slot (lecture / exercise / lab / seminar / unknown). The compact way to answer 'when are the lectures for X' — filter on kind == 'lecture', since NTNU's own activity titles are free-form Norwegian text.
yearrequiredcourse_coderequiredHistorical grade distribution for an NTNU course (per year and semester, with counts and percentages; grades A-F, or pass/fail codes). Accepts bare codes like 'TDT4100'. Omit years to get all recorded years. Small counts may be privacy-masked. Data comes from Norway's official DBH statistics.
yearscourse_coderequiredThe DBH-versioned course codes (like 'TDT4100-1') that exist for a bare NTNU course code. Useful when grade lookups come back empty.
course_coderequiredNTNU's terms (semesters) with ids like '26h' (autumn 2026) / '26v' (spring), teaching weeks, exam-period dates, and which term is current.
Takes no parameters.
Everything about an NTNU course except exam logistics: credits, level, campus, language of instruction, prerequisites, mandatory activities, course content / learning outcomes, credit reductions ('studiepoengreduksjon'), which study programs the teaching is planned for, contacts, and any alert notices (e.g. 'no longer taught'). English text by default; pass language 'nb' for Norwegian. Omit year for the current study year. For exam dates, times, aid codes, and rooms use get_exam_info.
yearlanguagecourse_coderequiredExam logistics for one or more NTNU courses in a single call: every exam occasion (ordinary / re-sit) with date, start time, duration, permitted-aids code ('hjelpemiddelkode') with its meaning, exam system, and assigned rooms. The way to answer 'when and where are my exams and what can I bring' for a whole semester at once. Rooms are only published days before the exam; unpublished fields are null. Omit year for the current study year.
yearlanguagecourse_codesrequiredSearch NTNU's study-program catalog (~400 programs) by free text (name, code, keywords), study level (e.g. 'bachelor', 'master', 'ph.d'), and/or city (Trondheim, Gjøvik, Ålesund). Returns program codes like 'MTDT' — the input for get_study_plan. Call this first when you only know a program's name.
citylevelqueryThe official study plan for an NTNU program and cohort intake year: which courses (codes, credits, mandatory/elective) belong to each semester, and the specialization choice points with their course groups. The bridge from 'I study X' to concrete course codes — feed them to get_weekly_timetable, check_timetable_conflicts, or get_exam_info. cohort_year is the year the student STARTED (defaults to the current cohort); students in their Nth year started N-1 years ago.
cohort_yearprogram_coderequiredSide-by-side comparison of NTNU courses for a given year — campus, exam dates, weekly teaching hours, and latest grade distribution — to help choose between courses. Accepts bare course codes.
yearrequiredcourse_codesrequiredChecks a set of NTNU courses for the same year for clashing lecture/lab times and colliding exam dates — a clash check to run before registering for courses. Accepts bare course codes. Each side of a conflict carries its activity 'kind': a lecture-vs-lecture clash is unavoidable, while one involving an exercise or lab often has alternative groups. Exam dates come from the catalog, which does not mark deferred (utsatt/kont) sittings.
yearrequiredcourse_codesrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
https://ntnu-mcp.martinsundal.no/mcpmise install # installs the pinned Node versionnpm installmise run dev # npm run dev — wrangler dev, local worker with hot reloadmise run test # npm test — vitest, over captured fixtures (no live network)mise run typecheck # npm run typecheck — tsc --noEmitmise run lint # npm run lint — biome checkmise run fmt # npm run fmt — biome check --writemise run check # lint + typecheck + testnpm run deploy # wrangler deploy