Mapbox Developer

You can run and use the Mapbox Developer MCP Server to give AI assistants direct, token-secured access to Mapbox developer APIs. This server enables conversational tools to create, read, validate, and manage Mapbox styles, tokens, GeoJSON data, and more, helping you build Mapbox applications faster and with better integration.

How to use

To use the MCP server, connect your preferred MCP client to the hosted endpoint and authenticate with a Mapbox access token that has the required scopes for the tasks you perform. The server exposes a broad set of tools and prompts that guide you through common Mapbox workflows, such as token management, style creation and validation, data-driven styling, and GeoJSON processing.

How to install

Prerequisites: you need Node.js installed on your machine. You may also install and run a local inspector or tracing stack if you want observability for development.

# Install dependencies for the MCP project (if you are cloning or running locally)
npm install

# Build and run a local development server
npm run build
npm run start

Hosted MCP endpoint and required environment

You can access the hosted MCP endpoint to start using the server without setting up a local environment. Use the following endpoint in your MCP client.

{
  "type": "http",
  "name": "mapbox_mcp_devkit",
  "url": "https://mcp-devkit.mapbox.com/mcp",
  "args": []
}

Available tools

get_latest_mapbox_docs_tool

Fetch the latest Mapbox documentation from the official docs source to inform AI assistants about APIs, SDKs, and developer resources.

get_reference_tool

Access static Mapbox references and schemas such as style layers, Streets fields, token scopes, and layer type mappings.

Style Builder Tool

Create and modify Mapbox styles programmatically via conversational prompts.

ListStylesTool

List all Mapbox styles in an account with optional pagination and filtering.

CreateStyleTool

Create a new Mapbox style using a provided style specification.

RetrieveStyleTool

Retrieve a Mapbox style by its ID.

UpdateStyleTool

Update an existing Mapbox style with new metadata or style JSON.

DeleteStyleTool

Delete a style by its ID.

PreviewStyleTool

Generate a preview URL for a Mapbox style using a public token to render a live preview.

ValidateStyleTool

Validate a Mapbox style JSON against the Mapbox Style Specification offline.

ValidateGeoJSON tool

Validate GeoJSON structures for correctness without requiring API access.

Validate Expression tool

Validate Mapbox style expressions for syntax and argument correctness offline.

Coordinate Conversion tool

Convert coordinates between WGS84 and Web Mercator coordinate systems.

Bounding Box tool

Compute the bounding box for a given GeoJSON content.

Color Contrast Checker tool

Evaluate WCAG 2.1 color contrast compliance between foreground and background colors.

compare_styles_tool

Compare two Mapbox styles and report structural differences and diffs.

Style Optimization tool

Optimize Mapbox styles by removing redundancies and simplifying expressions to reduce size.

create-token

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

list-tokens

List Mapbox access tokens for the authenticated user with filtering and pagination.

list_feedback_tool

List user feedback items from the Mapbox Feedback API with filtering and pagination.

get_feedback_tool

Get a single user feedback item by its unique ID.

GeoJSON Preview tool

Generate a geojson.io URL to visualize GeoJSON data.

analyze-geojson

Analyze and visualize GeoJSON data with automatic validation and bounding box calculation.

setup-mapbox-project

Complete setup workflow for a new Mapbox project with token security and style initialization.

debug-mapbox-integration

Troubleshoot Mapbox integration issues with guided steps and actionable fixes.

design-data-driven-style

Create a Mapbox style with data-driven properties that respond to feature data using expressions.

prepare-style-for-production

Quality validation workflow for Mapbox styles before deployment to production.