Mapbox Developer MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MAPBOX_ACCESS_TOKEN | Yes | A 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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:
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:
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
| Name | Description |
|---|---|
| create-and-preview-style | Create 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-map | Use 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-geojson | Analyze and visualize GeoJSON data. Validates format, calculates bounding box, and generates an interactive map visualization. |
| setup-mapbox-project | Complete setup workflow for a new Mapbox project. Creates tokens with proper security settings, initializes a map style, and provides integration guidance. |
| debug-mapbox-integration | Systematic troubleshooting workflow for Mapbox integration issues. Diagnoses token problems, style errors, API issues, and provides actionable solutions. |
| design-data-driven-style | Create 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-production | Comprehensive 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
| Name | Description |
|---|---|
| Mapbox Style Preview UI | Interactive UI for previewing Mapbox styles rendered inline with Mapbox GL JS (MCP Apps) |
| Mapbox Style Comparison UI | Interactive UI for comparing two Mapbox styles with a draggable slider (MCP Apps) |
| GeoJSON Preview UI | Interactive UI for previewing GeoJSON data rendered inline with Mapbox GL JS (MCP Apps) |
| Mapbox Style Specification Guide | Mapbox GL JS style specification reference for layer types, paint/layout properties, and Streets v8 source layers |
| Mapbox Streets v8 Fields Reference | Complete 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 Reference | Reference 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 Mapping | Mapping 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
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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