Tools / places.nearby

Nearby places

places.nearby

Named restaurants, cafés, pharmacies, fuel, ATMs and more within a radius, nearest first.

LocationLaunch set2 units per call24 h cacheMCP: places_nearbyv1.0.0

When to use it

Use to find named businesses or amenities near a location. Results come from OpenStreetMap, so coverage varies by area, and opening hours are as mapped by volunteers.

Input

FieldTypeDescription
locationstring (2+ chars, ≤ 200 chars)Place name such as 'Tokyo' or 'Austin, TX'. Use instead of latitude and longitude.
latitudenumber (≥ -90, ≤ 90)Decimal latitude, -90 to 90.
longitudenumber (≥ -180, ≤ 180)Decimal longitude, -180 to 180.
category *one of restaurant, cafe, pharmacy, hospital, atm, fuel, library, supermarket, parkKind of place to search for.
radius_minteger (≥ 100, ≤ 5000)Search radius in metres. Default: 1000.
limitinteger (≥ 1, ≤ 50)Maximum places to return. Default: 20.

* required

Output

Returns data with: location, category, count, places: [{name, category, distance_m, latitude, longitude, address, opening_hours, website}].

Request

curl -X POST https://agentops.tools/v1/places.nearby \
  -H 'content-type: application/json' \
  -d '{"location":"Kreuzberg, Berlin","category":"cafe","radius_m":500,"limit":10}'

Over MCP the tool is named places_nearby. Over A2A its skill id is places.nearby. Same input, same envelope.

Try it

Counts against your rate limit.

Sources

© OpenStreetMap contributors (ODbL)

Notes

  • Only named places are returned. Unnamed map features are filtered out.