yatmo_get_location_summary

A human-readable neighbourhood paragraph plus structured nearest school, nursery, supermarket, transport, and reverse-geocoded place facts. The single most useful tool for “explain why this property is well-situated” prompts.

MCP TOOL yatmo_get_location_summary LicenceKey header

Calls upstream GET /summary/text-and-data; cached server-side for 7 days per (lat, lng, language).

Inputs

Name	In	Type	Description
latitude required	argument	double	Latitude in decimal degrees, between −90 and 90. Must be inside the country’s borders.
longitude required	argument	double	Longitude in decimal degrees, between −180 and 180.
language required	argument	string	Language code (case-insensitive), two letters except `CNR` (Montenegrin, which has no two-letter code). Supported: `EN`, `FR`, `NL`, `DE`, `IT`, `PT`, `ES`, `CA`, `ZH`, `HI`, `AR`, `RU`, `JA`, `EL`, `HR`, `MT`, `SL`, `SR`, `TR`, `BS`, `CNR`, `SQ`, `BG`.
country required	argument	string	Market code (case-insensitive): `BE`, `FR`, `NL`, `LU`, `DE`, `CH`, `ES`, `IT`, `PT`, `UK`, `IE`, `AT`, `CA`, `GR`, `MA`, `AU`, `HR`, `MT`, `SI`, `RS`, `CY`, `BA`, `ME`, `BG`, `AL`. Must be allowed by your licence.

Example

The Grand-Place in Brussels, French, replayed on 21 September 2026:

{
  "name": "yatmo_get_location_summary",
  "arguments": {
    "latitude": 50.846714,
    "longitude": 4.352514,
    "language": "fr",
    "country": "BE"
  }
}

How distances and times are computed

distanceMeters is a network distance, measured along streets, paths or transport links, never a straight line from the property.
It is the shortest of the available modes. Yatmo measures each place by car, on foot, by bike and by public transport; the tool keeps the entry with the shortest distance. That is often walking, but not always.
travelMode says which mode that was: walking, cycling, driving or transit, the same in every language. travelTimeMinutes, where present, belongs to that same mode, rounded to the minute.
A missing value stays unknown. When no mode has travel information, the distance is null; it is never replaced by another mode or by zero.

An assistant should therefore quote the mode with the figure. The nearest school from the Grand-Place comes back at 363 m with travelMode: "cycling": that is “363 metres, 3 minutes by bike”, not “a 3 minute walk”. To get a time in a mode you choose, call REST /route with that mode.

Response

The facts object exposes the most-used structured fields:

Name	Type	Description
nearestSchool	{name, distanceMeters, travelMode}?	Closest actual school (preschool, primary, secondary or high school). `null` when none in range. Excludes daycare.
nearestNursery	{name, distanceMeters, travelMode}?	Closest crèche or daycare. `null` when none in range.
nearestSupermarket	{name, distanceMeters, travelMode}?	Closest supermarket.
transport	{linesCount, nearestStopDistanceMeters, nearestStopTravelMode}	`linesCount` is the number of places of the transport family in the summary (stops, stations, motorway accesses, shared-mobility stations), not a number of lines. `nearestStopDistanceMeters` is `null` when none of them has travel information.
place	{street, city, zip}?	Reverse-geocoded place information; `null` when not resolvable.

Response; only text is shortened, facts are complete:

{
  "text": "Transports: Vivre près de la Grand-Place - Grote Markt offre un cadre de vie pratique, avec un accès facilité aux commerces, transports et services [...]",
  "facts": {
    "nearestSchool": {
      "name": "Cefa - Centre Scolaire Eperonniers-Mercelis",
      "distanceMeters": 363,
      "travelMode": "cycling"
    },
    "nearestNursery": {
      "name": "César De Paepe",
      "distanceMeters": 551,
      "travelMode": "transit"
    },
    "nearestSupermarket": {
      "name": "Carrefour Express Gare Central",
      "distanceMeters": 257,
      "travelMode": "transit"
    },
    "transport": {
      "linesCount": 14,
      "nearestStopDistanceMeters": 233,
      "nearestStopTravelMode": "walking"
    },
    "place": {
      "street": "Grand-Place - Grote Markt",
      "city": "Bruxelles - Brussel",
      "zip": "1000"
    }
  },
  "warnings": [],
  "metadata": {
    "country": "BE",
    "language": "FR",
    "generatedAtUtc": "2026-09-21T12:45:41Z"
  }
}

AI usage

The text field is pre-formatted for an AI assistant to quote verbatim. The facts are stable JSON for downstream filtering / comparison. Combine both: use text in the assistant’s answer, use facts for sort/filter logic.

Notes

Read-only. The tool never writes to Yatmo.
First call for a new (lat, lng) is ~1 second. Subsequent calls hit the upstream 7-day cache and an additional 1-hour local cache — tens of milliseconds.
Coordinates outside the country’s borders return 400.
See related: nearby POIs, nearest by category, REST /summary.

See this tool answering a property question