NTNU Courses (unofficial) MCP Server

io.github.MartinSA04/ntnu-mcp

answering

NTNU Courses (unofficial) is answering right now. Last checked 11 min ago. It exposes 12 tools. Last commit 28 Jul 2026.

Unofficial NTNU course data: search, timetables, grades, course info, and exam logistics.

Uptime history 41 hours of history

41 hours agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

860 ms

Response time

average over 24h

Stars

last commit 28 Jul 2026

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 11 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add ntnu-mcp --transport http https://ntnu-mcp.martinsundal.no/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ntnu-mcp": {
      "url": "https://ntnu-mcp.martinsundal.no/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.ntnu-mcp]
url = "https://ntnu-mcp.martinsundal.no/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "ntnu-mcp": {
      "url": "https://ntnu-mcp.martinsundal.no/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "ntnu-mcp": {
      "url": "https://ntnu-mcp.martinsundal.no/mcp"
    }
  }
}

Available tools 12

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

course

get_course_info

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.

get_course_schedule

Every 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.

get_course_versions

The DBH-versioned course codes (like 'TDT4100-1') that exist for a bare NTNU course code. Useful when grade lookups come back empty.

study

get_study_plan

The 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.

search_study_programs

Search 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.

compare

compare_courses

Side-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.

courses

search_courses

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.

exam

get_exam_info

Exam 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.

grade

get_grade_distribution

Historical 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.

semesters

get_semesters

NTNU's terms (semesters) with ids like '26h' (autumn 2026) / '26v' (spring), teaching weeks, exam-period dates, and which term is current.

timetable

check_timetable_conflicts

Checks 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.

weekly

get_weekly_timetable

The 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.

Endpoints

URL	Transport	State	Latency	Checked
https://ntnu-mcp.martinsundal.no/mcp	streamable-http	answering	977 ms	11 min ago

NTNU Courses (unofficial) — questions

Answers built from our own checks of this server.

What can NTNU Courses (unofficial) do?

It exposes 12 tools, read directly from the server on our last check. Among them: check_timetable_conflicts, compare_courses, get_course_info, get_course_schedule, get_course_versions, get_exam_info and 6 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is NTNU Courses (unofficial) mostly used for?

Its tools cluster around course and study. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is NTNU Courses (unofficial) working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 860 ms. The bar chart above shows every period we have measured.

How do I connect NTNU Courses (unofficial)?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does NTNU Courses (unofficial) need an API key?

No. NTNU Courses (unofficial) completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 12 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is NTNU Courses (unofficial)?

It answers our handshake in 860 ms on average, which is faster than 8% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is NTNU Courses (unofficial) open source?

Yes — it is published under the MIT licence, written in TypeScript and 1 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.