yatmo.com info@yatmo.com +32 491 597 199

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 Two-letter language code (case-insensitive). Supported: EN, FR, NL, DE, IT, PT, ES, CA, ZH, HI, AR, RU, JA.
country required argument string Market code (case-insensitive): BE, FR, NL, LU, DE, CH, ES, IT, PT, UK, IE, AT. Must be allowed by your licence.

Example

Real Brussels coordinate (Grand-Place area), French language:

{
  "name": "yatmo_get_location_summary",
  "arguments": {
    "latitude": 50.8503,
    "longitude": 4.3517,
    "language": "fr",
    "country": "BE"
  }
}

Response

The facts object exposes the most-used structured fields:

Name In Type Description
nearestSchool {name, distanceMeters}? Closest actual school (preschool / primary / secondary / high school). null when none in range. Excludes daycare.
nearestNursery {name, distanceMeters}? Closest crèche / daycare. null when none in range.
nearestSupermarket {name, distanceMeters}? Closest supermarket or shop.
transport {linesCount, nearestStopDistanceMeters} Public-transport count nearby and distance to the closest stop.
place {street, city, zip}? Reverse-geocoded place information; null when not resolvable.

Sample response (truncated):

{
  "text": "Transports: Ce bien, situé près de Quartier Saint-Jacques - Sint-Jacobswijk, profite d'un cadre de vie connecté aux commodités et aux transports du quartier …",
  "facts": {
    "nearestSchool":     { "name": "Maria-Boodschaplyceum",         "distanceMeters": 581 },
    "nearestNursery":    { "name": "Crèche Du Béguinage",           "distanceMeters": 473 },
    "nearestSupermarket":{ "name": "Carrefour Express City Anspach","distanceMeters": 129 },
    "transport":         { "linesCount": 14, "nearestStopDistanceMeters": 46 },
    "place":             { "street": "Quartier Saint-Jacques - Sint-Jacobswijk", "city": "Bruxelles - Brussel", "zip": "1000" }
  },
  "warnings": [],
  "metadata": { "country": "BE", "language": "FR", "generatedAtUtc": "…" }
}
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