Category Search Tool
category_search_toolFind all places matching a category such as museums, coffee shops, or EV chargers, returning nearby results as JSON or readable text.
Instructions
Return all places that match a category (industry, amenity, or NAICS‑style code). Use when the user asks for a type of place, plural or generic terms like 'museums', 'coffee shops', 'electric‑vehicle chargers', or when the query includes is‑a phrases such as 'any', 'all', 'nearby'. Do not use when a unique name or brand is provided. Supports both JSON and text output formats.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"category": "<category>"
},
"name": "category_search_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bbox | No | Bounding box to limit results within specified bounds | |
| limit | No | Maximum number of results to return (1-25) | |
| format | No | Output format: "json_string" returns raw GeoJSON data as a JSON string that can be parsed; "formatted_text" returns human-readable text with place names, addresses, and coordinates. Both return as text content but json_string contains parseable JSON data while formatted_text is for display. | formatted_text |
| country | No | Array of ISO 3166 alpha 2 country codes to limit results | |
| category | Yes | The canonical place category name to search for (e.g., "restaurant", "hotel", "cafe"). To get the full list of supported categories, use the category_list_tool. | |
| language | No | IETF language tag for the response (e.g., "en", "es", "fr", "de", "ja") | |
| proximity | No | Location to bias results towards as {longitude, latitude}. If not provided, defaults to IP-based location. | |
| poi_category_exclusions | No | Array of POI categories to exclude from results |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | ||
| features | Yes | ||
| attribution | Yes | ||
| mapboxRender | No | Map-payload reference for `render_map_tool`. Surfaced so the LLM can chain the next call without re-emitting geometry. |