Mapbox MCP server
Mapbox's official MCP server gives agents geocoding, search, routing, isochrones, static maps, and offline geospatial math.
Mapbox MCP is the official Model Context Protocol server from Mapbox, exposing the Mapbox web-services APIs so an AI agent can reason about the physical world. It searches and geocodes places and addresses (free-text and by category), reverse-geocodes coordinates to addresses, fetches turn-by-turn directions with live traffic, computes travel-time and distance matrices, snaps GPS traces to roads with map matching, optimizes the order of stops on a multi-point route, calculates isochrones (the area reachable within a time or distance budget), and renders static map images with markers and overlays in Mapbox's styles. That makes it a practical, current option for location work in an agent.
It also ships a set of offline geospatial tools that run pure calculations without any API call — distance and bearing between points, midpoints and centroids, polygon area and bounding boxes, buffers, simplification, and point-in-polygon tests — plus a resource reader for static reference data like POI category lists. The server is available as the @mapbox/mcp-server npm package run locally over stdio with a MAPBOX_ACCESS_TOKEN, and as a hosted remote endpoint at https://mcp.mapbox.com/mcp authenticated with OAuth so there is no token to manage. It is MIT-licensed.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Available tools
| Tool | Description |
|---|---|
| search_and_geocode_tool | Unified search and geocoding for POIs, addresses, and places. |
| category_search_tool | Searches for points of interest by category. |
| reverse_geocoding_tool | Converts coordinates into a street address. |
| directions_tool | Fetches routing directions between points, with traffic support. |
| matrix_tool | Calculates travel times and distances between multiple origins and destinations. |
| isochrone_tool | Computes the area reachable within a given time or distance budget. |
| map_matching_tool | Snaps GPS traces to the road network. |
| optimization_tool | Solves the traveling-salesman problem to optimize the order of stops on a route. |
| static_image_tool | Generates a static map image with markers and overlays in a chosen style. |
| resource_reader_tool | Reads MCP resources such as POI category lists by URI. |
| category_list_tool | Returns default POI category data (deprecated; use resource_reader_tool). |
| distance_tool | Calculates the distance between coordinates in various units (offline). |
| bearing_tool | Determines the compass bearing between two coordinates (offline). |
| midpoint_tool | Finds the geographic midpoint between two locations (offline). |
| centroid_tool | Computes the geometric center of a polygon (offline). |
| area_tool | Calculates a polygon's area in multiple units (offline). |
| bounding_box_tool | Generates the minimum bounding box for a geometry (offline). |
| buffer_tool | Creates a buffer zone around a geographic feature (offline). |
| simplify_tool | Reduces polygon or line vertices using the Douglas-Peucker algorithm (offline). |
| point_in_polygon_tool | Tests whether a point lies within a polygon (offline). |
Required configuration
- MAPBOX_ACCESS_TOKENRequired
Mapbox access token used to authenticate API calls when running the server locally.
What you can do with it
Answer location questions
The agent searches and geocodes an address, finds nearby places by category, and reverse-geocodes coordinates so it can ground answers about the physical world instead of guessing.
Plan and optimize routes
Compute directions with traffic, build a distance matrix, optimize the stop order across waypoints, and render a static map image of the result for the user.
FAQ
- Is it free?
- The server is open source under the MIT license. It calls the Mapbox web-services APIs, which bill against your Mapbox account beyond the monthly free usage tier; the offline geospatial tools make no API calls and incur no cost.
- Does it support remote/OAuth?
- Yes. There is a hosted remote endpoint at https://mcp.mapbox.com/mcp authenticated with OAuth, so you complete a browser flow with no token to manage. The local stdio package authenticates with a MAPBOX_ACCESS_TOKEN instead.
- Is this Mapbox's official server?
- Yes. It is maintained by Mapbox and published as @mapbox/mcp-server, distinct from the separate Mapbox docs and devkit MCP servers aimed at developer documentation.