mcp/mapbox-devkit repository overview

⁠Mapbox Developer 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 Info

Attribute	Details
Dockerfile	https://github.com/mapbox/mcp-devkit-server/blob/fa7ddeb21c19a68c1a04f30eb83208040edcaa5f/Dockerfile⁠
Commit	fa7ddeb21c19a68c1a04f30eb83208040edcaa5f
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.pub
Licence	MIT License

⁠Available Tools (23)

⁠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: check_color_contrast_tool

Checks color contrast ratios between foreground and background colors for WCAG 2.1 accessibility compliance

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

⁠Tool: compare_styles_tool

Compares two Mapbox styles and reports differences in structure, layers, sources, and properties

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_feedback_tool

Get a single user feedback item from the Mapbox Feedback API by its unique ID. Use this tool to retrieve detailed information about a specific user-reported issue, suggestion, or feedback about map data, routing, or POI details. Requires user-feedback:read scope on the access token.

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

This tool interacts with external entities.

⁠Tool: list_feedback_tool

List user feedback items from the Mapbox Feedback API with filtering, sorting, and pagination. Use this tool to access user-reported issues, suggestions, and feedback about map data, routing, and POI details. Supports comprehensive filtering by status, category, date ranges, trace IDs, and search text. Requires user-feedback:read scope on the access token.

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

This tool interacts with external entities.

⁠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. Returns metadata for all tokens (public and secret), but the actual token value is only included for public tokens (secret token values are omitted for security). 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: optimize_style_tool

Optimizes Mapbox styles by removing unused sources, duplicate layers, and simplifying expressions

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

⁠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.

⁠Tool: validate_expression_tool

Validates Mapbox style expressions for syntax, operators, and argument correctness

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

⁠Tool: validate_geojson_tool

Validates GeoJSON objects for correctness, checking structure, coordinates, and geometry types

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

⁠Tool: validate_style_tool

Validates Mapbox style JSON against the Mapbox Style Specification, checking for errors, warnings, and providing suggestions for improvement

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

⁠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?⁠