Yatmo MCP tools

Four read-only tools cover the AI-shaped neighbourhood use cases. They all share the same authentication, the same response envelope, and the same category vocabulary.

The four tools

yatmo_get_location_summary — human-readable neighbourhood paragraph plus structured nearest school, nursery, supermarket, transport, and reverse-geocoded place.
yatmo_get_nearby_pois — ordered list of POIs around a property, optionally filtered by category, within a radius.
yatmo_get_nearest_by_category — the single nearest POI of a category with distance and travel time.
yatmo_get_accessibility_profile — public-transport presence, nearest stop, nearest train station, nearest motorway access.

Common response envelope

Every tool returns the same JSON shape, so an AI client can render any tool result with one template:

{
  "text":     "short summary the AI can quote verbatim",
  "facts":    { /* structured data, shape depends on the tool */ },
  "warnings": [ /* optional notes, e.g. data gaps */ ],
  "metadata": { "country": "BE", "language": "FR", "generatedAtUtc": "…" }
}

On error, an additional error field appears (see Authentication · error codes). The envelope never includes a stack trace, internal field names, or your LicenceKey.

Category vocabulary

Tools that accept categories use a fixed, AI-friendly vocabulary — same tokens for every country, with country-specific sub-types resolved server-side.

Name	Type	Description
school	education	Actual schools (preschool / primary / secondary / high school). Aliases: `schools`, `education`. Excludes crèches and daycare.
nursery	education	Crèches and daycare only. Aliases: `creche`, `daycare`, `childcare`.
supermarket	shopping	Supermarkets and shops. Aliases: `shopping`, `shops`.
public_transport	transport	All public-transport points (bus, tram, metro, train…). Aliases: `transport`, `transports`.
train_station	transport	Train stations only. Aliases: `train`, `station`.
motorway	transport	Motorway / highway access points. Aliases: `highway`, `motorway_access`.
entertainment	leisure	Cinemas, theatres, sport, leisure venues.
daily_life	services	Banks, post offices, daily-life services. Alias: `dailylife`.
medical	health	Hospitals, clinics, doctors. Alias: `health`.
tourism	tourism	Tourist attractions and landmarks.

Why school excludes nursery

The upstream Yatmo taxonomy groups all child-related facilities under one category internally. AI assistants asking “is there a school nearby?” expect schools, not daycare. We split them into two tokens so each returns what the user means. See nearest by category for examples.

Pick a tool to drill into: location summary, nearby POIs, nearest by category, accessibility profile.