Skip to content

MazeMap: 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.

mazemap_list_campuses

List campuses in NTU's MazeMap collection with IDs and center coordinates.

List NTU collection campuses with campus_id, name, and center coordinates. Accepts optional refresh. Main Campus is 2123; other campus IDs are discovered from the collection rather than hardcoded.

Inputs

Field Type Required Details
refresh boolean No default: false

Output

Field Type Required Details
retrieved_at string Yes format: date-time
source_url string Yes —
cached boolean Yes —
campuses array of Campus Yes —

Unknown fields are not accepted.

mazemap_list_buildings

List campus buildings and their floor IDs/names/levels. Defaults to NTU Main Campus. Optionally filter by building-name substring.

Inputs: optional campus_id, default 2123; optional query to filter building names by a case-insensitive substring; optional refresh.

Returns buildings with their floor IDs, printed names, and numeric levels. Floor names and levels can differ. A building with no published floors returns an empty floor list. Large polygon coordinates are omitted.

{"campus_id": 2123, "query": "North Spine"}

Inputs

Field Type Required Details
campus_id integer No Numeric ID returned by a MazeMap tool; greater than: 0; default: 2123
query string or null No default: null; minimum length: 1; maximum length: 200
refresh boolean No default: false

Output

Field Type Required Details
retrieved_at string Yes format: date-time
source_url string Yes —
cached boolean Yes —
campus_id integer Yes —
buildings array of Building Yes —

Unknown fields are not accepted.

mazemap_search_places

Search NTU rooms, venues and amenities by code, name or category, including aliases such as TR+7. Defaults to all NTU campuses; use campus_id to narrow. Follow next_offset for more matches. This is place search, not room availability.

Inputs: query, optional campus_id, limit from 1–50, default 10; offset from 0–10000, default 0; optional refresh.

Searches rooms, venues, and amenities using MazeMap's ranked search, including room aliases. Without a campus ID it searches the ntu-sg collection. Results include POI and campus IDs, name, identifier, aliases, building, floor, categories, coordinates, and a map link. Missing descriptions or capacities remain null.

Follow next_offset until it is null. The client requests one extra match to determine whether another page exists. Results are search matches, not a complete campus room inventory. Multiple buildings may use the same tutorial-room number; select the appropriate result before routing.

{"query": "TR+7", "campus_id": 2123, "limit": 5}

Inputs

Field Type Required Details
query string Yes minimum length: 1; maximum length: 200
campus_id integer or null No default: null; Numeric ID returned by a MazeMap tool; greater than: 0
limit integer No minimum: 1; maximum: 50; default: 10
offset integer No minimum: 0; maximum: 10000; default: 0
refresh boolean No default: false

Output

Field Type Required Details
retrieved_at string Yes format: date-time
source_url string Yes —
cached boolean Yes —
query string Yes —
places array of Place Yes —
next_offset integer or null Yes —

Unknown fields are not accepted.

mazemap_get_place

Read one NTU place's location, aliases, building, floor, categories and published description/capacity. Missing fields remain null.

Inputs: poi_id, optional refresh.

Returns one place's published details, including description and capacity where supplied. Deleted places, mismatched IDs, and places outside NTU are rejected.

{"poi_id": 1002362545}

Inputs

Field Type Required Details
poi_id integer Yes Numeric ID returned by a MazeMap tool; greater than: 0
refresh boolean No default: false

Output

Field Type Required Details
retrieved_at string Yes format: date-time
source_url string Yes —
cached boolean Yes —
place Place Yes —

Unknown fields are not accepted.

mazemap_get_directions

Get walking routes between two NTU POIs, estimated metres/seconds and English instructions where available. Choose REQUIRE_ACCESSIBLE to request only accessible paths. Accessibility and travel times do not guarantee current physical access.

Inputs: from_poi_id, to_poi_id; optional constraint, one of NO_CONSTRAINT, PREFER_ACCESSIBLE, or REQUIRE_ACCESSIBLE; optional refresh.

Both POIs must belong to NTU. Returns route alternatives, distance in metres, estimated duration in seconds, English directions when available, and referenced building/floor information. Distance is summed from the published basic path steps; duration comes from MazeMap's route estimate. Accessibility and uncertain-segment flags remain unknown when the source omits them. Missing directions for any leg are reported in issues, and instructions is null rather than presenting an incomplete instruction list as the whole route.

{"from_poi_id": 1002362545, "to_poi_id": 1002362569, "constraint": "REQUIRE_ACCESSIBLE"}

Inputs

Field Type Required Details
from_poi_id integer Yes Numeric ID returned by a MazeMap tool; greater than: 0
to_poi_id integer Yes Numeric ID returned by a MazeMap tool; greater than: 0
constraint "NO_CONSTRAINT", "PREFER_ACCESSIBLE", "REQUIRE_ACCESSIBLE" No default: "NO_CONSTRAINT"
refresh boolean No default: false

Output

Field Type Required Details
retrieved_at string Yes format: date-time
source_url string Yes —
cached boolean Yes —
from_poi_id integer Yes —
to_poi_id integer Yes —
constraint string Yes —
routes array of Route Yes —
buildings array of RouteBuilding Yes —
floors array of RouteFloor Yes —

Unknown fields are not accepted.

See the MCP data types for nested object fields.