Health-check tool.

Returns {"status": "ok"} so any MCP client can confirm reachability.

Example: ping() -> {"status": "ok"}

Forward geocode a place name to a WGS84 coordinate (decimal degrees).

Units: latitude/longitude in decimal degrees. Example: geocode(query="KLCC") -> GeoPoint(lat=3.1579, lon=101.7116)

Reverse geocode a coordinate to a human-readable address.

Units: lat/lon in decimal degrees; returns a display-name string. Example: reverse_geocode(lat=3.15, lon=101.71) -> "Bukit Bintang, ..."

Reachable-area polygon within a travel-time budget.

Units: lat/lon in decimal degrees; minutes in minutes; polygon ring as [lon, lat] pairs; area_m2 in square metres. Example: isochrone(lat=3.15, lon=101.71, mode="walk", minutes=10)

Points of interest inside a site's catchment, grouped by category.

Units: lat/lon decimal degrees; minutes minutes. categories is enum-constrained (no free-text queries). Example: catchment_pois(lat=3.15, lon=101.71, minutes=10, mode="walk", categories=["cafe","retail"])

Composite reach score in [0, 1] for a single OOH site.

Combines gravity-weighted POI density, junction density, and category diversity (public urban-analytics methodology). Returns the score plus an auditable breakdown. Units: lat/lon decimal degrees; minutes minutes; score unitless [0,1]. Example: site_reach_score(lat=3.15, lon=101.71, minutes=10, mode="walk")

Rank candidate sites by reach score (server-side, deterministic).

Ranking is computed here, not by the client model. Tie-break chain: score desc, POI density desc, category diversity desc, name asc. Units: lat/lon decimal degrees; minutes minutes. Example: compare_sites(sites=[{"name":"KLCC","lat":3.16,"lon":101.71}, {"name":"Bukit Bintang","lat":3.15,"lon":101.72}], minutes=10, mode="walk")