# Mapbox MCP > Official Mapbox geospatial MCP server exposing search, geocoding, routing, isochrone, map rendering, and offline geometry tools. Canonical: https://www.mcpfolio.com/servers/mapbox Last updated: 2026-10-28 ## Catalog record - Publisher: Mapbox - Categories: search, version-control ## Website https://www.mapbox.com/ ## Repository https://github.com/mapbox/mcp-server ## Transports Streamable HTTP (hosted); stdio (local) ## Authentication Hosted endpoint authenticates using browser OAuth. Local server requires MAPBOX_ACCESS_TOKEN for Mapbox API requests. ## Tools - **distance_tool**: Calculate the distance between two geographic coordinates using the Haversine formula. - **bearing_tool**: Determine compass direction between coordinates with cardinal directions. - **midpoint_tool**: Find the geographic center along the circle path between two points. - **centroid_tool**: Calculate geometric center of polygons for marker placement. - **area_tool**: Compute polygon areas in multiple units (acres, hectares, square miles, etc.). - **bounding_box_tool**: Generate minimum bounding rectangles containing geometries. - **buffer_tool**: Create proximity zones around points, lines, or polygons. - **simplify_tool**: Reduce polygon vertices using Douglas-Peucker algorithm while preserving shape. - **destination_tool**: Calculate a destination point given a starting point, bearing, and distance. Useful for computing waypoints or search offsets. - **length_tool**: Measure the total length of a line in kilometers, miles, meters, or feet. Useful for measuring routes or boundaries without a routing API call. - **convex_tool**: Compute the convex hull of a set of points — the smallest convex polygon that contains all the points. - **union_tool**: Merge two or more polygons into a single unified geometry. Useful for combining service areas, delivery zones, or isochrones. - **intersect_tool**: Find the intersection geometry of two polygons — the area they share in common. - **difference_tool**: Subtract one polygon from another, returning the area in the first polygon not covered by the second. - **nearest_point_tool**: Find the nearest point in a collection to a given target point. Useful for finding the closest store, stop, or landmark. - **nearest_point_on_line_tool**: Snap a point to the nearest position on a line or route. Returns the closest point on the line and the distance to it. - **points_within_polygon_tool**: Test one or more geographic points against a polygon, returning only those inside. Handles single or batch points. Useful for delivery zone validation and geofencing. - **search_and_geocode_tool**: Uses the Search Box API to search for and geocode POIs, addresses, and places. - **category_search_tool**: Searches for geographic categories such as countries, regions, or postal codes with proximity filtering. Powered by the Search Box API. - **reverse_geocode_tool**: Converts geographic coordinates into a readable address or place name with customizable detail levels. Powered by the Geocoding API – Reverse Geocoding. - **ground_location_tool**: Answers questions about what is near a location: neighborhood context, nearby POIs by category, and travel-time reachability. Use this as the first tool when given coordinates and asked about nearby places or area summaries. - **place_details_tool**: Retrieves detailed information about a specific place using its Mapbox ID, including photos, opening hours, phone numbers, and website URLs. Use after `search_and_geocode_tool`, `category_search_tool`, or `reverse_geocode_tool` to get additional details. Primarily covers points of interest; results for neighborhoods, cities, and other administrative boundaries are more limited. Public Preview, with a default quota of 1,000 requests/month. - **resource_reader_tool**: Accesses static reference data and category lists through MCP Resources (e.g., `mapbox://categories`). Only available for clients that do not support native MCP resources; enable by setting `CLIENT_NEEDS_RESOURCE_FALLBACK=true`. - **category_list_tool**: Retrieves the list of supported search categories. **Deprecated** — use `resource_reader_tool` with the `mapbox://categories` URI instead. Kept for backward compatibility with clients that need the resource fallback tools. - **directions_tool**: Calculates optimal routes between waypoints for driving (with traffic), walking, or cycling. Supports 2-25 waypoints with alternative routes. Powered by the Directions API. - **matrix_tool**: Computes travel times and distances between multiple points. Ideal for optimizing logistics. Supports traffic-aware departures. Powered by the Matrix API. - **isochrone_tool**: Calculates areas reachable within a specified travel time from a location. Powered by the Isochrone API. - **optimization_tool**: Solves traveling sales rep problems for 2-12 locations to find optimal routes. Powered by the Optimization API. - **map_matching_tool**: Snaps GPS traces to road networks with speed and congestion data. Powered by the Map Matching API. - **render_map_tool**: Displays a live, interactive Mapbox GL JS map in supported clients (Claude Desktop, VS Code with GitHub Copilot, Claude Code, Goose). Accepts `payload_refs` returned by other tools, or hand-composed GeoJSON layers, markers, and legends. Can also restyle the base map via `baseMapConfig`. - **static_map_image_tool**: Generates customizable map images with markers, polylines, polygons, and style options. Powered by the Static Images API. ## Sources - [official_complete_tool_reference](https://docs.mapbox.com/location-ai/mcp-servers/mcp-server/) - [official_server_catalog](https://docs.mapbox.com/location-ai/mcp-servers/) - [official_repository](https://github.com/mapbox/mcp-server) ## Setup Use the interactive setup panel on [the detail page](https://www.mcpfolio.com/servers/mapbox) to view instructions for each supported client.