Search / io.github.MartinSA04/ntnu-mcp
protogridR0· no sign-inUnofficial NTNU course data: search, timetables, grades, course info, and exam logistics.
v0.4.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"ntnu-mcp": {
"type": "http",
"url": "https://ntnu-mcp.martinsundal.no/mcp"
}
}
}claude mcp add --transport http ntnu-mcp https://ntnu-mcp.martinsundal.no/mcp[mcp_servers.ntnu-mcp]
url = "https://ntnu-mcp.martinsundal.no/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ntnu-mcp": {
"type": "remote",
"url": "https://ntnu-mcp.martinsundal.no/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"ntnu-mcp": {
"type": "http",
"url": "https://ntnu-mcp.martinsundal.no/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=ntnu-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbnRudS1tY3AubWFydGluc3VuZGFsLm5vL21jcCJ9"
}{
"servers": {
"ntnu-mcp": {
"type": "http",
"url": "https://ntnu-mcp.martinsundal.no/mcp"
}
}
}{
"mcpServers": {
"ntnu-mcp": {
"httpUrl": "https://ntnu-mcp.martinsundal.no/mcp"
}
}
}extensions:
"ntnu-mcp":
enabled: true
name: "ntnu-mcp"
type: streamable_http
uri: "https://ntnu-mcp.martinsundal.no/mcp"
timeout: 300
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky onestools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: search_courses (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_weekly_timetable (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_course_info (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …tools.token_costabout 1,679 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changesno tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website +reachable +uptime-99% ~updated-84d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://ntnu-mcp.martinsundal.no/mcp streamable-http | none | yes | 99% | 472 ms | 2025-11-25 | 2026-10-20 |
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. |
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. |
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. |
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. |
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. |
get_semesters | NTNU's terms (semesters) with ids like '26h' (autumn 2026) / '26v' (spring), teaching weeks, exam-period dates, and which term is current. |
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. |
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. |
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. |
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. |
Schemas: list_tools.
{
"name": "io.github.MartinSA04/ntnu-mcp",
"title": "NTNU Courses (unofficial)",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://ntnu-mcp.martinsundal.no/mcp",
"type": "streamable-http"
}
],
"version": "0.4.0",
"repository": {
"url": "https://github.com/MartinSA04/ntnu-mcp",
"source": "github"
},
"websiteUrl": "https://github.com/MartinSA04/ntnu-mcp",
"description": "Unofficial NTNU course data: search, timetables, grades, course info, and exam logistics."
}