STARS: Courses, prerequisites and exams MCP tools
Service overview · CLI reference · All MCP tools · Data types
Courses, prerequisites and exams
Inputs are required only where marked. A required output field may still be null if its type allows it. See data types for nested objects.
stars_search_courses
Search NTU's public undergraduate Class Schedule by partial code or title keywords. Returns course codes, names and AUs for the requested term and study mode. Use offset/limit to page through matches, then stars_get_course_metadata or stars_get_course_indexes for details. This is not a graduate or all-catalogue search.
Find scheduled undergraduate offerings by partial code or title words.
Inputs: query of 2–80 characters, academic_year, semester; optional study_mode of "full_time" or "part_time", limit of 1–100 with default 20, and nonnegative offset with default 0. Wildcards are not accepted.
Returns: course codes, names, AUs, total_count, has_more, and source/retrieval metadata. Continue with a larger offset to read another page. Results cover scheduled offerings for that term and study mode, rather than the entire historical catalogue or graduate courses.
{"query":"ZZ00","academic_year":2030,"semester":1,"limit":20}
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
query |
string |
Yes | Partial course code or title words, such as SC20 or DATA STRUCTURES; no wildcards; minimum length: 2; maximum length: 80 |
academic_year |
integer |
Yes | — |
semester |
1, 2, "S" |
Yes | — |
study_mode |
"full_time", "part_time" |
No | default: "full_time" |
limit |
integer |
No | minimum: 1; maximum: 100; default: 20 |
offset |
integer |
No | minimum: 0; default: 0 |
Output
| Field | Type | Required | Details |
|---|---|---|---|
query |
string |
Yes | — |
academic_year |
integer |
Yes | — |
semester |
string |
Yes | — |
study_mode |
"full_time", "part_time" |
Yes | — |
total_count |
integer |
Yes | — |
offset |
integer |
Yes | — |
has_more |
boolean |
Yes | — |
courses |
array of CourseSearchMatch |
Yes | — |
source_url |
string |
Yes | — |
retrieved_at |
string |
Yes | — |
stars_get_course_metadata
Get course name, AUs, prerequisites, description, and term metadata.
Inputs: course_code, academic_year, semester, optional limit (1–50, default 10) and non-negative offset.
Returns: course name, AU, prerequisites when published, course description, course notes, term, and source metadata. course_description_status distinguishes available, not_listed, and unavailable. This tool returns metadata rather than index timetables.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
course_code |
string |
Yes | — |
academic_year |
integer |
Yes | — |
semester |
1, 2, "S" |
Yes | — |
Output
| Field | Type | Required | Details |
|---|---|---|---|
course_code |
string |
Yes | — |
academic_year |
integer or null |
Yes | — |
semester |
string or null |
Yes | — |
course_name |
string |
Yes | — |
au |
number or null |
Yes | — |
course_description |
string or null |
Yes | — |
course_description_status |
"available", "not_listed", "unavailable" |
Yes | — |
course_description_source |
string or null |
Yes | — |
prerequisites |
string or null |
Yes | — |
course_notes |
array of CourseNote |
Yes | — |
retrieved_at |
string or null |
Yes | — |
official_source |
string or null |
Yes | — |
stars_get_prerequisite_tree
Build before and after branches around a course, with separate depth limits. The before branch follows the course's prerequisite rules; the after branch finds courses that depend on it in the selected term. The center course is treated as completed for eligibility.
Build a tree around one course, with a before branch for its prerequisites and an after branch for courses that depend on it.
Inputs: course_code, academic_year, semester; optional prerequisite_depth and dependent_depth, each 0–5 with default 2; completed_courses (up to 100 course codes); only_eligible (default false); include_corequisites (default false); and max_nodes per branch, 1–100 with default 100. The center course is treated as completed for eligibility evaluation. only_eligible requires completed_courses and filters the after branch.
Returns: a nested tree with published prerequisite expressions on each course. Recognized AND/OR rules preserve their alternative paths; completed_courses marks which paths are satisfied. The before branch uses NTU course-content metadata for prerequisite courses that are not offered in the selected term. The after branch searches scheduled undergraduate offerings in that term across full-time and part-time study modes. source_urls lists the official endpoints used, and each expanded course includes its source when available.
Unrecognized expressions, conflicting full-time/part-time records, and unavailable off-term course metadata remain labeled uncertain. Possible text matches are not treated as confirmed prerequisite rules. The tree is bounded by both depth inputs and max_nodes; prerequisites_truncated and dependents_truncated identify a branch cut short. This is not a historical or complete course-catalogue search.
{"course_code":"ZZ0001","academic_year":2030,"semester":1,"prerequisite_depth":2,"dependent_depth":2,"completed_courses":["MH1812"]}
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
course_code |
string |
Yes | Course at the center of the prerequisite tree; minimum length: 2; maximum length: 10 |
academic_year |
integer |
Yes | — |
semester |
1, 2, "S" |
Yes | — |
prerequisite_depth |
integer |
No | How many prerequisite levels to expand before the center course; minimum: 0; maximum: 5; default: 2 |
dependent_depth |
integer |
No | How many dependent-course levels to expand after the center course; minimum: 0; maximum: 5; default: 2 |
completed_courses |
array of string or null |
No | Courses already completed; the center course is added automatically for eligibility evaluation; default: null; maximum items: 100 |
only_eligible |
boolean |
No | Keep only dependent courses whose parsed prerequisite rules are satisfied by completed_courses; default: false |
include_corequisites |
boolean |
No | Also follow co-requisite links in both directions; default: false |
max_nodes |
integer |
No | Maximum nodes per before/after branch; minimum: 1; maximum: 100; default: 100 |
Output
| Field | Type | Required | Details |
|---|---|---|---|
course_code |
string |
Yes | — |
academic_year |
integer |
Yes | — |
semester |
string |
Yes | — |
prerequisite_depth |
integer |
Yes | — |
dependent_depth |
integer |
Yes | — |
include_corequisites |
boolean |
Yes | — |
only_eligible |
boolean |
Yes | — |
completed_courses |
array of string or null |
Yes | — |
prerequisite_course_count |
integer |
Yes | — |
dependent_course_count |
integer |
Yes | — |
tree_node_count |
integer |
Yes | — |
prerequisites_truncated |
boolean |
Yes | — |
dependents_truncated |
boolean |
Yes | — |
truncated |
boolean |
Yes | — |
coverage |
object of integer |
Yes | — |
root |
PrerequisiteTreeNode |
Yes | — |
source_urls |
array of string |
Yes | — |
retrieved_at |
string |
Yes | — |
stars_get_graduate_course_schedule
Get a graduate course's class groups for NTU's currently published academic term.
Input: course_code.
Returns: the latest published graduate term, class groups, coordinators when provided, sessions, commencement dates, and schedule remarks. Graduate results use class groups rather than undergraduate indexes. GSLink/PGR does not publish teaching-week rules through this lookup.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
course_code |
string |
Yes | — |
Output
| Field | Type | Required | Details |
|---|---|---|---|
course_code |
string |
Yes | — |
course_name |
string |
Yes | — |
au |
number or null |
Yes | — |
academic_year |
integer |
Yes | — |
term |
string |
Yes | — |
schedule_complete |
boolean |
Yes | — |
class_groups |
array of GraduateClassGroup |
Yes | — |
source_url |
string |
Yes | — |
stars_get_undergraduate_exam_schedule
Get public General Access exam dates and times for a course in the latest or specified published term.
Inputs: course_code; optionally both academic_year and semester of 1 or 2. Omitting both selects NTU's latest published exam term.
Returns: exam date, day, start/end time, duration, publication notice, source, and retrieval time. exam_status distinguishes available from not_listed. General Access does not provide personal exam-seat assignments.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
course_code |
string |
Yes | — |
academic_year |
integer or null |
No | default: null |
semester |
1, 2 or null |
No | default: null |
Output
| Field | Type | Required | Details |
|---|---|---|---|
course_code |
string |
Yes | — |
course_name |
string or null |
Yes | — |
academic_year |
integer |
Yes | — |
semester |
string |
Yes | — |
exam_status |
"available", "not_listed" |
Yes | — |
exam_count |
integer |
Yes | — |
exams |
array of ExamResult |
Yes | — |
notice |
string or null |
Yes | — |
source_url |
string |
Yes | — |
retrieved_at |
string |
Yes | — |