Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Developer platforms - official Mapbox server

Mapbox MCP server

Exposes Mapbox web services APIs (geocoding, POI search, directions, matrix, isochrones, optimization, map matching, static maps) plus offline Turf.js geospatial tools to MCP clients, with live interactive map rendering in supported clients. Mapbox hosts it at https://mcp.mapbox.com/mcp, or you can run @mapbox/mcp-server (npm) locally with OAuth or API key auth.

Last verified 15 tools6 sources

Install

Terminal
claude mcp add --transport http mapbox-mcp https://mcp.mapbox.com/mcp
Terminal
codex mcp add mapbox-mcp --url https://mcp.mapbox.com/mcp
JSON
{
  "mcpServers": {
    "mapbox-mcp": {
      "url": "https://mcp.mapbox.com/mcp"
    }
  }
}

VS Code

JSON
{
  "servers": {
    "mapbox-mcp": {
      "type": "http",
      "url": "https://mcp.mapbox.com/mcp"
    }
  }
}

Generic

JSON
{
  "mcpServers": {
    "MapboxServer": {
      "command": "npx",
      "args": [
        "-y",
        "@mapbox/mcp-server"
      ],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "YOUR_MAPBOX_ACCESS_TOKEN"
      }
    }
  }
}

Tools

search_and_geocode_tool
Search for and geocode POIs, addresses and places via the Search Box API.
category_search_tool
Search places by category with proximity filtering.
reverse_geocode_tool
Convert coordinates into a readable address or place name.
ground_location_tool
Answer what is near a coordinate: neighborhood context, nearby POIs and travel-time reachability in one call.
place_details_tool
Retrieve photos, hours, phone and website for a place by Mapbox ID (Public Preview).
directions_tool
Routes between 2-25 waypoints for driving with traffic, walking or cycling.
matrix_tool
Travel times and distances between multiple points.
isochrone_tool
Areas reachable within a given travel time.
optimization_tool
Optimal visiting order for 2-12 locations.
map_matching_tool
Snap GPS traces to the road network.
render_map_tool
Display a live interactive Mapbox GL JS map in supported clients via MCP Apps.
static_map_image_tool
Generate map images with markers, polylines and polygons.
distance_tool
Offline Haversine distance between two coordinates.
buffer_tool
Offline proximity zones around points, lines or polygons.
points_within_polygon_tool
Offline test of which points fall inside a polygon.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Hosted endpoint uses an OAuth browser flow or a Mapbox access token as a Bearer header; local npm/Docker use requires MAPBOX_ACCESS_TOKEN.
  • API usage is billed against the Mapbox account per normal API pricing.
  • The docs page shows v0.12.0 while npm latest is 0.16.0 (published 2026-10-15).
  • Claude Desktop needs mcp-remote for the hosted endpoint. --enable-tools/--disable-tools flags filter tools locally.

FAQ

What does the Mapbox MCP server do?

Exposes Mapbox web services APIs (geocoding, POI search, directions, matrix, isochrones, optimization, map matching, static maps) plus offline Turf.js geospatial tools to MCP clients, with live interactive map rendering in supported clients. The vendor documents 15 tools, including search_and_geocode_tool, category_search_tool, reverse_geocode_tool and ground_location_tool.

How do I add the Mapbox MCP server to Claude Code?

Run claude mcp add --transport http mapbox-mcp https://mcp.mapbox.com/mcp, copied from Mapbox's docs. This page also has snippets for Codex, Cursor, VS Code and Generic.

Does the Mapbox MCP server need authentication?

Yes, OAuth or API key. Transport: Streamable HTTP, stdio. Status: Unlabelled, last checked October 17, 2026.

Sources

Last verified against 6 Mapbox pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.