Mapbox
Mapbox
Tool
Forward Geocode Tool
forward_geocode_toolForward geocode addresses, cities, towns, neighborhoods, districts, postcodes, regions, and countries using Mapbox Geocoding API v6. Converts location name into geographic coordinates. Setting a proximity point helps to bias results towards a specific area for more relevant results. Do not use this tool for geocoding points of interest like businesses, landmarks, historic sites, museums, etc. Supports both JSON and text output formats.
Pricing
Per call
$0.01
Model
flat
Pay only for what you use. No subscriptions.
Inputs
q *
stringcountry
arraytypes
arrayautocomplete
booleanproximity
stringpermanent
booleanbbox
objectformat
stringlimit
numberlanguage
stringworldview
stringTry It
API
MCP Config
Input Parameters
Search text to geocode. Max 256 characters, 20 words, no semicolons.
Array of ISO 3166 alpha 2 country codes to limit results
Array of feature types to filter results
Location to bias results towards. Either [longitude, latitude] coordinates or "ip" for IP-based location. Can help get more relevant results when searching in a specific area.
Bounding box to limit results within specified bounds
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.
Maximum number of results to return (1-10)
IETF language tag for the response (e.g., "en", "es", "fr", "de", "ja")
us
Returns features from a specific regional perspective

