List Place Categories

The list_place_categories MCP tool returns the category values accepted by search_places.

Use this tool before searching when you need to discover or verify the exact category identifier for a type of place.

Tool name

list_place_categories

Request URL

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

Input parameters

This tool takes no arguments. Send an empty arguments object. The input schema does not allow additional properties.

Example request

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_place_categories",
    "arguments": {}
  }
}

Response

The tool returns the number of supported categories and an array containing their identifiers. Pass one of these identifiers as the category argument of search_places.

Example response

The following example is abbreviated. The live response used for this example returned 833 category identifiers; only the first entries are shown here.

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ... }"
      }
    ],
    "structuredContent": {
      "count": 833,
      "categories": [
        "accommodation",
        "accommodation.hotel",
        "accommodation.hut",
        "accommodation.apartment",
        "accommodation.chalet",
        "accommodation.guest_house",
        "accommodation.hostel",
        "accommodation.motel"
      ]
    },
    "isError": false
  }
}

Related tools

• Search Places - find nearby places using one of the returned categories.

Related API

For direct HTTP API integration and the category hierarchy, see Places API categories.