Mapbox
Mapbox
Tool
Poi Search Tool
poi_search_toolFind one specific place or brand location by its proper name or unique brand. Use only when the user's query includes a distinct title (e.g., "The Met", "Starbucks Reserve Roastery") or a brand they want all nearby branches of (e.g., "Macy's stores near me"). Do not use for generic place types such as 'museums', 'coffee shops', 'tacos', etc. Setting a proximity point is strongly encouraged for more relevant results. Always try to use a limit of at least 3 in case the user's intended result is not the first result. Supports both JSON and text output formats.
Pricing
Per call
$0.01
Model
flat
Pay only for what you use. No subscriptions.
Inputs
country
arraytypes
arraybbox
objecteta_type
stringorigin
objectformat
stringlanguage
stringnavigation_profile
stringauto_complete
booleanq *
stringproximity
stringlimit
numberpoi_category
arrayTry It
API
MCP Config
Input Parameters
Array of ISO 3166 alpha 2 country codes to limit results
Array of feature types to filter results (e.g., ["poi", "address", "place"])
Bounding box to limit results within specified bounds
Request estimated time of arrival (ETA) to results
Starting point for ETA calculations as coordinate object with longitude and latitude
formatted_text
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.
ISO language code for the response (e.g., "en", "es", "fr", "de", "ja")
Routing profile for ETA calculations
Search query text. Limited to 256 characters.
Location to bias results towards. Either coordinate object with longitude and latitude or "ip" for IP-based location. STRONGLY ENCOURAGED for relevant results.
Maximum number of results to return (1-10)
Array of POI categories to include (e.g., ["restaurant", "cafe"])