Skip to content

NTU Omnibus: MCP reference

Service overview · CLI reference · MCP reference

Tools

Inputs are required only where marked. Output fields marked required may still be null when their type allows it. See the data types for object fields.

omnibus_get_live_buses

Get current live vehicle positions for one NTU campus shuttle route. An empty list means no positions were reported in this snapshot; source timestamps may be unavailable.

Input: route_code (Blue, Brown, Green, Grey, or Red), default Blue.

Returns bus positions, speed/direction and available crowd data for one selected route. reported_bus_count and buses can be empty. source_timestamp may be null when NTU publishes its placeholder timestamp; retrieved_at is when this MCP fetched the snapshot.

Inputs

Field Type Required Details
route_code "Blue", "Brown", "Green", "Grey", "Red" No default: "Blue"

Output

Field Type Required Details
retrieved_at string Yes format: date-time
source_urls array of string Yes —
cached boolean No default: false
route_code string Yes —
reported_bus_count integer Yes minimum: 0
source_timestamp string or null No default: null; format: date-time
buses array of BusPosition Yes —

Unknown fields are not accepted.

omnibus_list_routes

List public NTU shuttle routes and their published display colors. This does not include route path geometry.

Returns the app's campus shuttle routes and published route colors. The route-list action currently lists Blue, Brown, Green, Grey, and Red. It does not supply route path geometry.

Inputs

None.

Output

Field Type Required Details
retrieved_at string Yes format: date-time
source_urls array of string Yes —
cached boolean No default: false
routes array of Route Yes —
colors array of RouteColor Yes —

Unknown fields are not accepted.

omnibus_list_stops

Search NTU shuttle and LTA bus stops by stop name or code, optionally limited to a route/service. Follow next_offset for more results.

Inputs: optional query (stop name or code), route_code (campus route or 179, 179A, 199), limit (1–100, default 20), and offset (default 0).

Returns matching route-stop associations, with total_count and next_offset. A stop associated with more than one route can appear more than once. cached is true when every requested route came from the stop cache; retrieved_at is the oldest contributing route snapshot, including when fresh and cached routes are combined.

Inputs

Field Type Required Details
query string No maximum length: 120; default: ""
route_code "Blue", "Brown", "Green", "Grey", "Red", "179", "179A", "199" or null No default: null
limit integer No minimum: 1; maximum: 100; default: 20
offset integer No minimum: 0; default: 0

Output

Field Type Required Details
retrieved_at string Yes format: date-time
source_urls array of string Yes —
cached boolean No default: false
stops array of Stop Yes —
total_count integer Yes minimum: 0
next_offset integer or null No default: null; minimum: 0

Unknown fields are not accepted.

omnibus_get_arrivals

Get arrival estimates for NTU shuttles and/or LTA services 179, 179A, and 199. Filter by route and stop name/code; at most 20 matching route-stop pairs can be fetched per call. Broader matches require a narrower filter. LTA estimates use minutes; unavailable estimates and unpublished seconds are null.

Inputs: optional route_filter (campus route or 179, 179A, 199), stop_query, and source (all, shuttle, or lta; default all).

Returns shuttle_arrivals and lta_arrivals separately. LTA minute estimates are retained; seconds/load are null when the public per-stop action does not publish them. IsETA_NotFound becomes null estimates rather than a zero-minute arrival. A call fetches at most 20 matching route-stop pairs; broader matches return an explicit error asking for a narrower stop/route filter. Services 179, 179A and 199 are exposed by the arrival and stop tools, not the campus shuttle vehicle-position endpoint. Estimates may be unavailable.

Inputs

Field Type Required Details
route_filter "Blue", "Brown", "Green", "Grey", "Red", "179", "179A", "199" or null No default: null
stop_query string No maximum length: 120; default: ""
source "all", "shuttle", "lta" No default: "all"

Output

Field Type Required Details
retrieved_at string Yes format: date-time
source_urls array of string Yes —
cached boolean No default: false
route_filter string or null Yes —
stop_query string Yes —
shuttle_arrivals array of ShuttleArrival Yes —
lta_arrivals array of LtaArrival Yes —

Unknown fields are not accepted.

omnibus_get_service_status

Get the published first/last bus schedule, public-holiday/special-day flags, and temporary notices for an NTU campus shuttle route.

Input: route_code (campus route), default Blue.

Returns published first/last bus schedule rows, whether the app used its local schedule table, public-holiday and special-day flags, and temporary service messages. Schedules and notices are source data, not a live guarantee of operation.

Inputs

Field Type Required Details
route_code "Blue", "Brown", "Green", "Grey", "Red" No default: "Blue"

Output

Field Type Required Details
retrieved_at string Yes format: date-time
source_urls array of string Yes —
cached boolean No default: false
route_code string Yes —
schedules array of RouteSchedule Yes —
schedule_from_local_db boolean Yes —
is_public_holiday boolean Yes —
is_special_day boolean Yes —
special_day_notice string or null No default: null
has_temporary_message boolean Yes —
temporary_message string or null No default: null
no_active_bus_message string or null No default: null
no_operations_message string or null No default: null

Unknown fields are not accepted.

See the MCP data types for nested object fields.