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 Grand-Place in Brussels, replayed on 21 September 2026:

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

Response

Name In Type Description
pois array Places sorted by distance ascending. Each item: {category, name, distanceMeters, travelMode, latitude, longitude}.
radiusMeters int Effective radius applied (after server-side capping).
totalReturned int Number of items in pois, always equal to the count quoted in text (at most maxResults).

Each item carries a category token. It is granular for two families only: children (school or nursery) and the train station and motorway access (train_station, motorway). Everything else in the transport family is labelled public_transport: bus, tram and metro stops, but also airports, charging stations and shared bike or car stations. A Villo bike-sharing station, for instance, comes back as public_transport.

{
  "text": "10 point(s) of interest found within 800 m.",
  "facts": {
    "pois": [
      {
        "category": "public_transport",
        "name": "STIB/MIVB - 95 - GRAND-PLACE - WIENER",
        "distanceMeters": 233,
        "travelMode": "walking",
        "latitude": 50.845003,
        "longitude": 4.351728
      },
      {
        "category": "public_transport",
        "name": "STIB/MIVB - 48 - ANNEESSENS - DECROLY",
        "distanceMeters": 233,
        "travelMode": "walking",
        "latitude": 50.845003,
        "longitude": 4.351728
      },
      {
        "category": "public_transport",
        "name": "Villo - Place Saint-Jean / Sint-Jansplein",
        "distanceMeters": 241,
        "travelMode": "walking",
        "latitude": 50.845222,
        "longitude": 4.351484
      },
      {
        "category": "public_transport",
        "name": "STIB/MIVB - 89 - WESTLAND SHOPPING - GARE CENTRALE",
        "distanceMeters": 345,
        "travelMode": "walking",
        "latitude": 50.846832,
        "longitude": 4.356626
      },
      {
        "category": "school",
        "name": "Cefa - Centre Scolaire Eperonniers-Mercelis",
        "distanceMeters": 363,
        "travelMode": "cycling",
        "latitude": 50.844355,
        "longitude": 4.349471
      },
      {
        "category": "public_transport",
        "name": "STIB/MIVB - 10 - HOPITAL MILITAIRE - CHURCHILL",
        "distanceMeters": 405,
        "travelMode": "walking",
        "latitude": 50.848072,
        "longitude": 4.349439
      },
      {
        "category": "public_transport",
        "name": "STIB/MIVB - 4 - GARE DU NORD - STALLE (P)",
        "distanceMeters": 405,
        "travelMode": "walking",
        "latitude": 50.848072,
        "longitude": 4.349439
      },
      {
        "category": "public_transport",
        "name": "STIB/MIVB - 5 - ERASME - HERRMANN-DEBROUX",
        "distanceMeters": 430,
        "travelMode": "walking",
        "latitude": 50.849821,
        "longitude": 4.352486
      },
      {
        "category": "public_transport",
        "name": "STIB/MIVB - 1 - GARE DE L'OUEST - STOCKEL",
        "distanceMeters": 430,
        "travelMode": "walking",
        "latitude": 50.849821,
        "longitude": 4.352486
      },
      {
        "category": "train_station",
        "name": "Brussel-Centraal / Bruxelles-Central",
        "distanceMeters": 462,
        "travelMode": "transit",
        "latitude": 50.845658,
        "longitude": 4.356801
      }
    ],
    "radiusMeters": 800,
    "totalReturned": 10
  },
  "warnings": [],
  "metadata": {
    "country": "BE",
    "language": "FR",
    "generatedAtUtc": "2026-09-21T12:45:41Z"
  }
}
Pick categories deliberately
As a filter, public_transport keeps the whole transport family, train stations and motorway accesses included, while those two keep their own label in the results. To look only for trains, filter on train_station; for motorway exits, on motorway.

How distances and times are computed

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.

Notes