Search Reachable Places

The search_reachable_places MCP tool finds places of one category inside the area reachable from an origin within a travel-time or travel-distance limit.

Use this tool for questions like "Which pharmacies can I walk to in 10 minutes?" or "Which supermarkets are within a 15-minute drive?". The tool calculates the reachable area and searches for places inside it in one call, so an AI assistant does not need to pass a large polygon between tools.

Tool name


search_reachable_places


Request URL


https://api.geoapify.com/v1/mcp?apiKey=YOUR_API_KEY


Input parameters

Name Type Required Description
origin object Yes Starting point with lat and lon. Latitude range: -90 to 90; longitude range: -180 to 180.
type string Yes time or distance.
range number Yes Travel limit: seconds for time, meters for distance with metric units, or miles with imperial units. Must be at least 1.
category string Yes One supported place category, for example healthcare.pharmacy. Call list_place_categories to get the supported values.
limit integer No Maximum number of places to return. Supported range: 1 to 100. Default: 20.
lang string No Result language as a supported two-letter language code. Default: en.
include_geometry boolean No Set to true to also return the reachable area as a GeoJSON FeatureCollection in isoline. Default: false.
mode string No Travel or vehicle mode. Default: drive. Supports the same modes as Calculate Isoline.
units string No metric or imperial. Default: metric.
route_type string No Route preference: balanced, short, or less_maneuvers. Default: balanced.
traffic string No Traffic model for motorized modes: free_flow or approximated. Default: free_flow.
avoid array of strings No Up to three unique features to avoid: tolls, ferries, and highways.
max_speed number No Maximum vehicle speed: 10 to 252 km/h with metric units, or 6.5 to 155 mph with imperial units.

The transit and approximated_transit modes support only type: "time". The maximum range depends on your account limits. The input schema does not allow additional properties.

Example request

This request finds pharmacies within a 10-minute walk of Alexanderplatz in Berlin:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_reachable_places",
    "arguments": {
      "origin": { "lat": 52.5219, "lon": 13.4132 },
      "type": "time",
      "mode": "walk",
      "range": 600,
      "category": "healthcare.pharmacy",
      "limit": 5
    }
  }
}

Response

The tool returns:

  • reachability - the applied origin, type, range, range_units (seconds, meters, or miles), mode, and routing options.
  • category and count - the searched category and the number of returned places.
  • results - places inside the reachable area with the same fields as Search Places: name, address, coordinates, distance in meters from the origin, categories, data source, and details such as opening hours when they are available.
  • isoline - the reachable area as a GeoJSON FeatureCollection, only when include_geometry is true.

Results are ordered by proximity and relevance, not by travel time, and the limit applies after the area filter. When no area is reachable, results is empty.

Example response

Shortened structuredContent:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ... }"
      }
    ],
    "structuredContent": {
      "reachability": {
        "origin": { "lat": 52.5219, "lon": 13.4132 },
        "type": "time",
        "mode": "walk",
        "units": "metric",
        "route_type": "balanced",
        "traffic": "free_flow",
        "range": 600,
        "range_units": "seconds"
      },
      "category": "healthcare.pharmacy",
      "count": 3,
      "results": [
        {
          "name": "Panorama Apotheke",
          "formatted": "Panorama Apotheke, Panoramastraße 1, 10178 Berlin, Germany",
          "lat": 52.521847,
          "lon": 13.4098188,
          "distance": 230,
          "opening_hours": "Mo-Fr 09:00-19:00; Sa 09:00-14:00",
          "categories": ["commercial.health_and_beauty", "commercial.health_and_beauty.pharmacy", "healthcare", "healthcare.pharmacy"],
          "datasource": { "sourcename": "openstreetmap", "license": "Open Database License" }
        },
        { "name": "Bezirksapotheke am Roten Rathaus", "formatted": "Bezirksapotheke am Roten Rathaus, Rathausstraße 5, 10178 Berlin, Germany", "distance": 283 },
        { "name": "Alexa Apotheke", "formatted": "Alexa Apotheke, Grunerstraße 20, 10179 Berlin, Germany", "distance": 361 }
      ]
    },
    "isError": false
  }
}

The results show which places are inside the reachable area. They don't include the travel time to each place; use Calculate Route Matrix to compare travel times. Place data comes from OpenStreetMap and changes as the map is updated.

Related tools

Related API

For direct HTTP API integration, see Isoline API and Places API.