Search and Geocode Tool
search_and_geocode_toolSearch for points of interest, brands, cities, towns, and addresses, then geocode results; add a proximity point to bias searches toward local matches.
Instructions
Search for POIs, brands, chains, geocode cities, towns, addresses. Do not use for generic place types such as 'museums', 'coffee shops', 'tacos', etc, because category_search_tool is better for that. Setting a proximity point is strongly encouraged for more local results. The underlying Search Box API is rolling out natural-language query understanding (e.g. 'quiet coffee shops with wifi near downtown'), so richer free-text phrasing in q can work well for category + place + attribute combinations — but as of this writing, big-box retail brand searches tied to a specific address (e.g. 'Costco near ', 'Walmart near ', 'Target near ') are unreliable and often return unrelated results; verify those results before relying on them.
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": {
"q": "<q>"
},
"name": "search_and_geocode_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Search query text. Limited to 200 characters (the API rejects longer queries with a 400, despite the docs stating 256). Supports natural-language phrasing combining category, place, and attributes (e.g. "quiet coffee shops with wifi near downtown Seattle"), though big-box retail brand + address queries (e.g. "Costco near <address>") are currently unreliable. | |
| bbox | No | Bounding box to limit results within [minLon, minLat, maxLon, maxLat] | |
| types | No | Array of feature types to filter results (e.g., ["poi", "address", "place"]) | |
| origin | No | ||
| country | No | Array of ISO 3166 alpha 2 country codes to limit results | |
| eta_type | No | Request estimated time of arrival (ETA) to results | |
| language | No | ISO language code 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. STRONGLY ENCOURAGED for relevant results. | |
| poi_category | No | Array of POI categories to include (e.g., ["restaurant", "cafe"]) | |
| auto_complete | No | Enable partial and fuzzy matching | |
| navigation_profile | No | Routing profile for ETA calculations |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | ||
| features | Yes | ||
| attribution | No | ||
| mapboxRender | No | Map-payload reference for `render_map_tool`. Surfaced so the LLM can chain the next call without re-emitting geometry. |