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

yatmo_get_nearby_pois

An ordered list of points of interest around a property, optionally filtered by category, within a radius. Use it when the assistant needs to enumerate options (“list schools within 800 m”).

MCP TOOL yatmo_get_nearby_pois LicenceKey header

Server-side caps prevent runaway requests; results are sorted by distance ascending.

Inputs

Name In Type Description
latitude required argument double Latitude in decimal degrees.
longitude required argument double Longitude in decimal degrees.
language required argument string Two-letter language code (see location summary).
country required argument string Market code from your licence.
radiusMeters argument int Search radius. Server caps at 3000 m even if a larger value is requested. Default: 3000.
categories argument string[] Category tokens to keep; [] or omitted = no filter. See the category vocabulary.
maxResults argument int Maximum POIs returned, sorted by distance ascending. Server caps at 50. Default: 50.

Example

Schools and public transport within 800 m of the Brussels Grand-Place:

{
  "name": "yatmo_get_nearby_pois",
  "arguments": {
    "latitude": 50.8503, "longitude": 4.3517,
    "language": "fr", "country": "BE",
    "radiusMeters": 800,
    "categories": ["school", "public_transport"],
    "maxResults": 10
  }
}

Response

Name In Type Description
pois array POIs sorted by distance ascending. Each item: {category, name, distanceMeters, latitude, longitude}.
radiusMeters int Effective radius applied (after server-side capping).
totalReturned int Number of POIs in pois (≤ maxResults).

Each POI’s category is the canonical, granular token: school, nursery, train_station, motorway, public_transport, etc. — not the generic upstream type. A train station POI is labelled train_station, not public_transport.

{
  "text": "5 point(s) of interest found within 800 m.",
  "facts": {
    "pois": [
      { "category": "public_transport", "name": "STIB/MIVB - 65 - GARE CENTRALE - MACHELEN", "distanceMeters":  46, "latitude": 50.850478, "longitude": 4.3513 },
      { "category": "public_transport", "name": "STIB/MIVB - 1 - GARE DE L'OUEST - STOCKEL",  "distanceMeters":  63, "latitude": 50.850, "longitude": 4.352 },
      { "category": "school",           "name": "Maria-Boodschaplyceum",                    "distanceMeters": 581, "latitude": 50.850082, "longitude": 4.344922 }
    ],
    "radiusMeters": 800,
    "totalReturned": 3
  },
  "warnings": [],
  "metadata": { "country": "BE", "language": "FR", "generatedAtUtc": "…" }
}
Pick categories deliberately
public_transport matches every transit point including the train station and the motorway access. If you specifically need stops/lines, use public_transport; for the train, use train_station; for highway exits, use motorway.

Notes