Search Places

The search_places MCP tool finds places and points of interest by category near geographic coordinates.

Use this tool when you need nearby restaurants, shops, healthcare facilities, attractions, or other places from a supported Geoapify Places category. Call list_place_categories first when you do not know the category value.

Tool name

search_places

Request URL

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

Input parameters

Name	Type	Required	Description
`category`	string	Yes	Supported place category to find, such as `catering.restaurant`. Must contain 3 to 64 lowercase letters, digits, underscores, hyphens, or dot-separated parts.
`lat`	number	Yes	Latitude of the search center. Supported range: `-90` to `90`.
`lon`	number	Yes	Longitude of the search center. Supported range: `-180` to `180`.
`radius_meters`	number	No	Search radius in meters. Must be at least `1`. When omitted, the tool returns the nearest matching places without a hard distance limit.
`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`.

The input schema does not allow additional properties.

Example request

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_places",
    "arguments": {
      "category": "catering.restaurant",
      "lat": 52.52,
      "lon": 13.405,
      "radius_meters": 2000,
      "limit": 1,
      "lang": "en"
    }
  }
}

Response

The tool returns the category, search coordinates, optional radius, result count, and matching places. Results include common location, address, and category fields. Additional fields such as datasource information, contact details, facilities, distance, and place ID may be returned when available.

Example response

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ... }"
      }
    ],
    "structuredContent": {
      "category": "catering.restaurant",
      "coordinates": {
        "lat": 52.52,
        "lon": 13.405
      },
      "radius_meters": 2000,
      "count": 1,
      "results": [
        {
          "name": "BLOCK HOUSE",
          "country": "Germany",
          "country_code": "de",
          "city": "Berlin",
          "postcode": "10178",
          "district": "Mitte",
          "neighbourhood": "Nikolaiviertel",
          "suburb": "Mitte",
          "street": "Karl-Liebknecht-Straße",
          "housenumber": "7",
          "lon": 13.4051631,
          "lat": 52.5205315,
          "state": "Berlin",
          "state_code": "BE",
          "formatted": "BLOCK HOUSE, Karl-Liebknecht-Straße 7, 10178 Berlin, Germany",
          "categories": [
            "catering",
            "catering.restaurant",
            "catering.restaurant.steak_house"
          ],
          "distance": 60,
          "place_id": "518a17b08971cf2a4059d784b4c6a0424a40f00103f901bb70151a0000000092030b424c4f434b20484f555345"
        }
      ]
    },
    "isError": false
  }
}

Related tools

List Place Categories - get the supported category values for search_places.
Geocode Address - convert an address or place query into search-center coordinates.

Related API

For direct HTTP API integration, see Places API.