NTU Course Index MCP
This server provides read-only NTU course timetable, index, and exam-schedule lookups.
Get course metadata and every index with its complete timetable.
List all indexes for a course, including lectures, tutorials, labs, and other sessions.
Get a graduate course’s class groups for the currently published term.
Get undergraduate exam dates and times for the latest or specified term.
Get every scheduled session for one course index.
Compare indexes to see shared vs index-specific sessions and optionally check clashes against supplied time slots.
Find matching indexes by day/time/lesson/week constraints, avoid windows, earliest/latest class times, required session patterns, and supplied timetable clashes.
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., "@NTU Course Index MCP find SC2001 indexes for AY2026/27 sem 1 that avoid Fridays"
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.
All About NTU
Explore NTU services from your terminal or connect them to an AI assistant. Search courses and library resources, navigate campus, check shuttle arrivals, and access your own learning materials and student services through a single application.
Documentation · CLI guide · MCP setup · Service reference · Report an issue
All About NTU provides two interfaces to the same services:
CLI: run
ntucommands directly in your terminal, with readable output or JSON for scripts.MCP: give a compatible AI client access to selected NTU tools through a local server or the hosted public server.
Quickstart
Install uv and Python 3.10 or newer. Then choose how you want to use All About NTU:
Use the CLI
uv tool install 'all-abt-ntu[cli,personal]@latest'
ntu cli setup
ntu --helpConnect an MCP client
uvx --from 'all-abt-ntu[cli,mcp,personal]@latest' ntu mcp setupSetup lets you choose a profile, enable tools, and configure Codex, Claude Code, or OpenCode. You can also connect to the hosted public server without installing anything locally.
For personal services such as NTULearn and One Stop, use CLI setup to save your credentials and install Chromium. You can skip these steps if you only use public services; no NTU account is needed for those.
Your password stays in your OS keyring. It is entered through a hidden prompt, stored locally with no plaintext fallback, and sent only to NTU or its Microsoft sign-in service when needed. It is never returned through MCP or shared with your AI client.
Related MCP server: McGill VSB MCP
Available services
Service | What you can do | CLI | Reference |
STARS | Search courses, explore prerequisites and indexes, view schedules and manage plans |
| |
NTULearn | Browse enrolled courses, learning materials, announcements, grades and calendars |
| |
CareerAxis | Find opportunities, employers, career events and resources |
| |
MazeMap | Search campus places and get walking directions |
| |
DR-NTU | Discover research publications, repository collections and datasets |
| |
Library | Search the catalogue, inspect records and explore facilities |
| |
Faculty | Find faculty members and research interests |
| |
News | Browse and search NTU news |
| |
Campus Services | Find food, shops, clinics and other campus services |
| |
Omnibus | Check shuttle routes, stops, arrivals and service status |
| |
One Stop @ SAC | Explore the catalog and manage requests, appointments and other student services |
|
The service references include CLI commands, MCP tools, arguments, outputs and service-specific limits.
Authentication
If you saved your credentials during setup, you do not need to save them again. To save or manage them later, run:
ntu auth save
ntu auth status
ntu auth deleteYour password is entered through a hidden prompt and stored locally in your OS keyring; there is no plaintext fallback. Your keyring must be available and unlocked. Never enter a password into an AI conversation or MCP client configuration.
If you use MCP through uvx without installing the CLI, save credentials with:
uvx --from 'all-abt-ntu[cli,personal]@latest' ntu auth saveSee credentials and platform setup for more details.
CLI
Installation
For public and authenticated services:
uv tool install 'all-abt-ntu[cli,personal]@latest'For public services only, install the smaller CLI extra:
uv tool install 'all-abt-ntu[cli]@latest'See the CLI installation guide for browser-cookie support.
Manual CLI installation
To run the CLI from a local checkout:
git clone https://github.com/pitchaya-s/all-abt-ntu.git
cd all-abt-ntu
uv sync --no-default-groups --extra cli --extra personal
uv run --no-sync playwright install chromium
uv run --no-sync ntu --helpFor public services only, omit --extra personal and the Chromium installation. Use uv run --no-sync ntu auth save to save credentials for personal services. See the manual CLI guide for environment activation and platform-specific details.
Examples
Search courses, inspect a course and explore its indexes and prerequisites:
ntu stars courses search "data structures" --year 2026 --semester 1 --limit 10 --offset 0
ntu stars course ZZ0001 --year 2026 --semester 1
ntu stars indexes ZZ0001 --year 2026 --semester 1 --limit 10 --offset 0
ntu stars prerequisites ZZ0001 --year 2026 --semester 1 --prerequisite-depth 2 --dependent-depth 2Browse NTULearn content and download a file or video:
ntu learn courses --limit 20 --offset 0
ntu learn content ZZ0001 --limit 20 --offset 0
ntu learn attachments ZZ0001 "_67890_1" --limit 20 --offset 0
ntu learn files download ZZ0001 "_67890_1" "_24680_1" --output "./lecture.pdf" --max-bytes 20000000
ntu learn videos download ZZ0001 "_67890_1" --output "./lecture.mp4" --max-mb 500ZZ0001 and the IDs above are fictional. Replace them with your course and content IDs from the preceding commands. Supported NTULearn content URLs can also be used in place of course and content IDs; see the NTULearn CLI guide. Downloads require confirmation.
Explore the rest of campus:
ntu map search "LT1" --limit 10 --offset 0
ntu bus arrivals --route Blue --stop "North Spine" --source shuttle
ntu library search "machine learning" --field title --match contains --limit 10 --offset 0
ntu news search "artificial intelligence" --sort latest --page 1
ntu services search "coffee" --location "North Spine" --limit 10 --offset 0Run ntu --help, ntu stars --help, or add --help to a command to see its available arguments. Many data commands support --json, pagination options and --refresh where applicable:
ntu map search "LT1" --limit 10 --offset 0 --jsonSee the CLI guide and complete command reference for more examples and options.
MCP
MCP connects NTU tools to compatible AI clients. The local server offers a public profile and a personal profile; personal tools use your locally saved credentials. You choose which tools are available, and actions and downloads require confirmation.
Local setup
uvx --from 'all-abt-ntu[cli,mcp,personal]@latest' ntu mcp setupTo review or change tools later:
uvx --from 'all-abt-ntu[cli,mcp,personal]@latest' ntu mcp tools list
uvx --from 'all-abt-ntu[cli,mcp,personal]@latest' ntu mcp tools list --all
uvx --from 'all-abt-ntu[cli,mcp,personal]@latest' ntu mcp tools disable news
uvx --from 'all-abt-ntu[cli,mcp,personal]@latest' ntu mcp tools enable starsTo run a public stdio server directly:
uvx --from 'all-abt-ntu[mcp]@latest' ntu mcp --profile publicThe MCP setup guide covers client configuration, profiles, Chromium and manual installation. See the tool reference for available tools.
Manual MCP installation
For interactive setup and personal tools from a local checkout:
git clone https://github.com/pitchaya-s/all-abt-ntu.git
cd all-abt-ntu
uv sync --no-default-groups --extra cli --extra mcp --extra personal
uv run --no-sync ntu mcp setupFor a public server, install only the MCP extra and start the server directly:
uv sync --no-default-groups --extra mcp
uv run --no-sync ntu mcp --profile publicIf you didn't save credentials during setup, use uv run --no-sync ntu auth save. The manual MCP guide has more details.
Hosted public server
Add the following URL to a client that supports remote MCP servers, using Streamable HTTP and no authentication:
https://all-abt-ntu-mcp.vercel.app/mcpThe hosted server provides public, read-only information. Personal services require the local server. See the hosted MCP guide for details.
Documentation and contributing
Browse the documentation site for getting started, service guides, architecture and security, known issues, and limitations.
To work on the project, see the development guide, testing guide, and contributing guide. Preview the documentation locally with:
uvx --from mkdocs-material mkdocs serveDisclaimer
This is an independent project and is not affiliated with, sponsored by, or endorsed by Nanyang Technological University (NTU), Singapore.
Your NTU credentials are retrieved locally from your OS keyring and submitted over HTTPS to NTU or its Microsoft sign-in service. They are never returned through MCP. Academic data returned by tools is visible to the AI client. Keyring storage protects credentials at rest; it does not isolate them from other programs or agents allowed to access your unlocked keyring or the server process.
Use this software only to access accounts and materials you are authorized to access. Do not download, copy, store, or redistribute course recordings, lecture files, library resources, research data, or other restricted or copyrighted material unless you have permission. Follow NTU policies, copyright and license notices, source-service terms, and applicable law. Do not bypass authentication, CAPTCHA, DRM, paywalls, or other access restrictions. You are responsible for ensuring your access, downloads, retention, and reuse are authorized.
Available Tools
7 toolscompare_indexesBRead-onlyIdempotent
Compare shared and index-specific sessions; optionally check clashes with supplied time slots.
Inputs: indexes (required), semester (required), course_code (required), academic_year (required), +1 more. Returns: object
find_matching_indexesARead-onlyIdempotent
Find indexes matching day/time/lesson/week rules and avoiding supplied timetable clashes.
Inputs: semester (required), course_code (required), academic_year (required), constraints, +1 more. Returns: object
get_courseBRead-onlyIdempotent
Get course metadata and every index with its complete timetable.
Inputs: semester (required), course_code (required), academic_year (required). Returns: object
get_course_indexesBRead-onlyIdempotent
List all indexes for a course, including every lecture, tutorial, lab, and other session.
Inputs: semester (required), course_code (required), academic_year (required). Returns: object
get_graduate_course_scheduleBRead-onlyIdempotent
Get a graduate course's class groups for NTU's currently published academic term.
Inputs: course_code (required). Returns: object
get_index_scheduleCRead-onlyIdempotent
Get every scheduled session for one course index.
Inputs: index (required), semester (required), course_code (required), academic_year (required). Returns: object
get_undergraduate_exam_scheduleARead-onlyIdempotent
Get public General Access exam dates and times for a course in the latest or specified published term.
Inputs: course_code (required), semester, academic_year. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
get_course returns course metadata AND every index with its complete timetable, which substantially overlaps with get_course_indexes (list all indexes) and get_index_schedule (one index's sessions). An agent could reasonably pick any of the three for overlapping needs. The exam/graduate schedules and the compare/find pair are clearly distinct, but the course/index trio blurs boundaries.
All names follow a verb_noun pattern (get_course, get_index_schedule, find_matching_indexes, compare_indexes) with snake_case throughout. The graduate/undergraduate schedule names are longer and add scope qualifiers, a minor deviation but still readable and predictable.
Seven tools is well-scoped for a course-index lookup domain, covering distinct resource/action combinations without bloat. No trivial single tool or excessive surface.
The surface covers course metadata, index listing, per-index schedules, graduate/undergraduate scheduling, exam dates, index comparison, and clash-aware matching, which is strong lifecycle coverage. Some gaps remain, such as no explicit search-by-course-code tool, but core planning workflows are supported.
Maintenance
Related MCP Connectors
Unofficial NTNU course data: search, timetables, grades, course info, and exam logistics.
Unofficial Wentworth (WIT) course catalog and student schedule. Needs a WIT sign-in.
Search university course materials, your flashcards, quizzes, streak and quota. All tools read-only.
Read-only University of Macau course, instructor and review data.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables course planning for University of Pennsylvania by searching the catalog, inspecting sections and ratings, detecting schedule conflicts, and building weekly schedules.15MIT
- AlicenseAqualityBmaintenanceGives AI assistants direct, on-demand access to McGill's public Visual Schedule Builder timetable data, letting them search course offerings, fetch sections and meeting times, check conflicts, and generate ranked schedule combinations without a login, API key, or browser session. Queries and schedule calculations run locally on structured results, with a short-lived cache for repeated requests.423 npm2MIT
- AlicenseAqualityBmaintenanceEnables read-only querying of eight campus services through independent local MCP adapters: mailbox search, reading and attachment download, Blackboard courses, academic-system terms, timetable and grades, library loans and navigation, teaching-office notices, the Nan7 market listings, course-review community ratings, and the campus data dashboard. Credentials and sessions remain on the user's own device, encrypted with Windows DPAPI, and nothing is submitted, registered, or booked on the user's behalf.71MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to read a student's own university academic data — class timetables, exam schedules, grades, available terms, and empty classrooms — from Qiangzhi (jsxsd) or Zhengfang V9 systems via a session imported from the browser. All access is strictly read-only, never performing course selection, withdrawal, or evaluations.61MIT