Category Search Tool
category_search_toolRead-onlyIdempotent
Find all places matching a specified category (e.g., restaurant, hotel) using Mapbox. Supports proximity bias and bounding box filters.
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.
Input Schema
TableJSON 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
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | ||
| features | Yes | ||
| attribution | Yes |