Skip to main content
Glama
mapbox

Mapbox Developer MCP Server

Official
by mapbox

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MAPBOX_ACCESS_TOKENYesA Mapbox access token is required to use this MCP server.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_styles_toolA

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

create_style_toolC

Create a new Mapbox style

retrieve_style_toolA

Retrieve a specific Mapbox style by ID

update_style_toolC

Update an existing Mapbox style

delete_style_toolB

Delete a Mapbox style by ID

preview_style_toolA

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

style_builder_toolA

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

geojson_preview_toolA

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

check_color_contrast_toolA

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

compare_styles_toolA

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

optimize_style_toolA

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

style_comparison_toolA

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

create_token_toolA

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

list_tokens_toolA

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)

bounding_box_toolA

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

country_bounding_box_toolA

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

coordinate_conversion_toolA

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

get_feedback_toolA

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.

list_feedback_toolA

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.

tilequery_toolB

Query vector and raster data from Mapbox tilesets at geographic coordinates

validate_expression_toolA

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

validate_geojson_toolA

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

validate_style_toolA

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

Prompts

Interactive templates invoked by user choice

NameDescription
create-and-preview-styleCreate a new Mapbox map style and generate a shareable preview link. Automatically handles token management by checking for or creating a public token with the required scopes.
build-custom-mapUse conversational AI to build a custom styled map based on a theme description. Supports themes like "dark cyberpunk", "nature-focused", "minimal monochrome" and can emphasize specific features.
analyze-geojsonAnalyze and visualize GeoJSON data. Validates format, calculates bounding box, and generates an interactive map visualization.
setup-mapbox-projectComplete setup workflow for a new Mapbox project. Creates tokens with proper security settings, initializes a map style, and provides integration guidance.
debug-mapbox-integrationSystematic troubleshooting workflow for Mapbox integration issues. Diagnoses token problems, style errors, API issues, and provides actionable solutions.
design-data-driven-styleCreate a map style with data-driven properties that respond dynamically to feature data. Guides you through expressions, color scales, and property-based styling.
prepare-style-for-productionComprehensive quality validation workflow for Mapbox styles before production deployment. Validates expressions, checks accessibility compliance, optimizes performance, and generates a deployment-ready quality report.

Resources

Contextual data attached and managed by the client

NameDescription
Mapbox Style Preview UIInteractive UI for previewing Mapbox styles rendered inline with Mapbox GL JS (MCP Apps)
Mapbox Style Comparison UIInteractive UI for comparing two Mapbox styles with a draggable slider (MCP Apps)
GeoJSON Preview UIInteractive UI for previewing GeoJSON data rendered inline with Mapbox GL JS (MCP Apps)
Mapbox Style Specification GuideMapbox GL JS style specification reference for layer types, paint/layout properties, and Streets v8 source layers
Mapbox Streets v8 Fields ReferenceComplete field definitions for all Mapbox Streets v8 source layers including available values for each field. Use this to understand what fields and values are available when filtering or styling map features.
Mapbox Token Scopes ReferenceReference guide for Mapbox access token scopes and their permissions. Use this to understand what each scope allows and which scopes are needed for different operations.
Mapbox Layer Type MappingMapping of Mapbox Streets v8 source layers to compatible Mapbox GL JS layer types. Use this to understand which layer types (fill, line, symbol, etc.) work with which source layers.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mapbox/mcp-devkit-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server