Mapbox Developer MCP Server

Mapbox Developer MCP Server MCP Server

Direct access to Mapbox developer APIs for AI assistants. Enables style management, token management, GeoJSON preview, and other developer tools for building Mapbox applications.

What is an MCP Server?⁠

MCP Info

Image Building InfoDockerfile|https://github.com/mapbox/mcp-devkit-server/blob/main/Dockerfile⁠

Docker Image built by|Docker Inc. Docker Scout Health Score| Verify Signature|COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/mapbox-devkit --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pubLicence|MIT License

Available Tools (16)

Tools Details

Tool: bounding_box_tool

Calculates bounding box of given GeoJSON content, returns as [minX, minY, maxX, maxY]

This tool is read-only. It does not modify its environment.

Tool: coordinate_conversion_tool

Converts coordinates between WGS84 (longitude/latitude) and EPSG:3857 (Web Mercator) coordinate systems

This tool is read-only. It does not modify its environment.

Tool: country_bounding_box_tool

Gets bounding box for a country by its ISO 3166-1 country code, returns as [minX, minY, maxX, maxY].

This tool is read-only. It does not modify its environment.

Tool: create_style_tool

Create a new Mapbox style

This tool interacts with external entities.

Tool: create_token_tool

Create a new Mapbox public access token with specified scopes and optional URL restrictions.

This tool interacts with external entities.

Tool: delete_style_tool

Delete a Mapbox style by ID

This tool may perform destructive updates.

This tool is idempotent. Repeated calls with same args have no additional effect.

This tool interacts with external entities.

Tool: geojson_preview_tool

Generate a geojson.io URL to visualize GeoJSON data. Returns only the URL link.

This tool is read-only. It does not modify its environment.

Tool: get_latest_mapbox_docs_tool

Get the latest official Mapbox documentation, APIs, SDKs, and developer resources directly from Mapbox. Always up-to-date, comprehensive coverage of all current Mapbox services including mapping, navigation, search, geocoding, and mobile SDKs. Use this for accurate, official Mapbox information instead of web search.

Tool: list_styles_tool

List styles for a Mapbox account. Use limit parameter to avoid large responses (recommended: limit=5-10). Use start parameter for pagination.

This tool is read-only. It does not modify its environment.

This tool interacts with external entities.

Tool: list_tokens_tool

List Mapbox access tokens for the authenticated user with optional filtering and pagination. When using pagination, the "start" parameter must be obtained from the "next_start" field of the previous response (it is not a token ID)

This tool is read-only. It does not modify its environment.

This tool interacts with external entities.

Tool: preview_style_tool

Generate preview URL for a Mapbox style using an existing public token

This tool is read-only. It does not modify its environment.

Tool: retrieve_style_tool

Retrieve a specific Mapbox style by ID

This tool is read-only. It does not modify its environment.

This tool interacts with external entities.

Tool: style_builder_tool

Generate Mapbox style JSON for creating new styles or updating existing ones.

The tool intelligently resolves layer types and filter properties using Streets v8 data. You don't need exact layer names - the tool automatically finds the correct layer based on your filters.

BASE STYLES: • standard: ALWAYS THE DEFAULT - Modern Mapbox Standard with best performance • Classic styles: streets-v12/light-v11/dark-v11/satellite-v9/outdoors-v12/satellite-streets-v12/navigation-day-v1/navigation-night-v1 Only use Classic when user explicitly says "create a classic style" or working with existing Classic style

STANDARD STYLE CONFIG: Use standard_config to customize the basemap: • Theme: default/faded/monochrome • Light: day/night/dawn/dusk • Show/hide: labels, roads, 3D buildings • Colors: water, roads, parks, etc.

LAYER ORDERING: • Layers are rendered in order - last layer in the array appears visually on top • The 'slot' parameter is OPTIONAL - by default, layer order in the array determines visibility • For Standard style, you can optionally use 'slot' to control placement:

• No slot (default): Above all existing layers in the style
• 'top': Behind Place and Transit labels
• 'middle': Between basemap and labels
• 'bottom': Below most basemap features

LAYER RENDERING: • render_type controls HOW to visualize the layer (line, fill, symbol, etc.) • Most important: Use render_type:"line" for outlines/borders even on polygon features • Default "auto" picks based on geometry, but override for specific effects:

• Building outlines → render_type:"line" (not fill!)
• Solid buildings → render_type:"fill" or "fill-extrusion" (3D)
• Road lines → render_type:"line" (auto works too)
• POI dots → render_type:"circle"
• Labels → render_type:"symbol"

LAYER ACTIONS: • color: Apply a specific color • highlight: Make prominent • hide: Remove from view • show: Display with defaults

AUTO-DETECTION: The tool automatically finds the correct layer from your filter_properties. Examples: • { class: 'park' } → finds 'landuse' layer • { type: 'wetland' } → finds 'landuse_overlay' layer • { maki: 'restaurant' } → finds 'poi_label' layer • { toll: true } → finds 'road' layer • { admin_level: 0 } → finds 'admin' layer (for country boundaries) • { admin_level: 1 } → finds 'admin' layer (for state/province boundaries)

IMPORTANT LAYER NAMES: • Use "admin" for all boundaries (countries, states, etc.) • Use "building" (singular, not "buildings") • Use "road" for all streets, highways, paths

If a layer type is not recognized, the tool will provide helpful suggestions showing: • All available source layers from Streets v8 • Which fields are available in each layer • Examples of how to properly specify layers and filters

This tool is read-only. It does not modify its environment.

Tool: style_comparison_tool

Generate a comparison URL for comparing two Mapbox styles side-by-side

This tool is read-only. It does not modify its environment.

Tool: tilequery_tool

Query vector and raster data from Mapbox tilesets at geographic coordinates

This tool is read-only. It does not modify its environment.

This tool interacts with external entities.

Tool: update_style_tool

Update an existing Mapbox style

This tool interacts with external entities.

Use this MCP Server

{
  "mcpServers": {
    "mapbox-devkit": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MAPBOX_ACCESS_TOKEN",
        "mcp/mapbox-devkit"
      ],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠