mcp-devkit-server — Claude Code MCP server: setup guide
Connects AI assistants directly to Mapbox developer APIs for style editing and token management. Helpful when building mapping features in your workspace.
claude mcp add --transport http mcp-devkit-server https://mcp-devkit.mapbox.com/mcpWhat mcp-devkit-server does
This server connects your coding assistant to the Mapbox Styles API and local geospatial processing utilities. It includes tools for listing, inspecting, and generating map styles, alongside a conversational Style Builder tool. MCP resources like resource://mapbox-style-layers and resource://mapbox-streets-v8-fields provide reference schemas directly to the context window.
Local processing tools handle coordinate conversions, bounding box calculations, style comparison, and GeoJSON previews. You can run the server locally via npx or hook into the hosted HTTP endpoint.
A valid MAPBOX_ACCESS_TOKEN is mandatory. Every tool depends on specific token permissions. Style updates fail without styles:write, while token generation requires tokens:write.
What it helps with
- Build and modify Mapbox styles using conversational prompts
- Inspect source layer fields from the Mapbox Streets v8 schema
- Convert coordinates and compute geographic bounding boxes
- Create and list Mapbox access tokens directly in your editor
- Compare and optimize map style specifications
Example prompts for the agent
- Create a dark navigation map style using the Style Builder tool
- What fields are available in the Streets v8 landuse layer?
- Calculate the bounding box for these coordinates
How to install mcp-devkit-server
1Platform CLI: remote server
claude mcp add --transport http mcp-devkit-server https://mcp-devkit.mapbox.com/mcp2Platform CLI
claude mcp add --env MAPBOX_ACCESS_TOKEN=<MAPBOX_ACCESS_TOKEN> --transport stdio mcp-devkit-server -- npx -y @mapbox/mcp-devkit-serverReplace <…> with your own values
1Platform CLI: remote server
codex mcp add mcp-devkit-server --url https://mcp-devkit.mapbox.com/mcp2Platform CLI
codex mcp add mcp-devkit-server --env MAPBOX_ACCESS_TOKEN=<MAPBOX_ACCESS_TOKEN> -- npx -y @mapbox/mcp-devkit-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp-devkit-server": {
"url": "https://mcp-devkit.mapbox.com/mcp"
}
}
}{
"mcpServers": {
"mcp-devkit-server": {
"command": "npx",
"args": [
"-y",
"@mapbox/mcp-devkit-server"
],
"env": {
"MAPBOX_ACCESS_TOKEN": "<MAPBOX_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp-devkit-server": {
"type": "http",
"url": "https://mcp-devkit.mapbox.com/mcp"
}
}
}{
"servers": {
"mcp-devkit-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mapbox/mcp-devkit-server"
],
"env": {
"MAPBOX_ACCESS_TOKEN": "<MAPBOX_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http mcp-devkit-server https://mcp-devkit.mapbox.com/mcp2Platform CLI
gemini mcp add -e MAPBOX_ACCESS_TOKEN=<MAPBOX_ACCESS_TOKEN> mcp-devkit-server npx -y @mapbox/mcp-devkit-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-devkit-server
How to install mcp-devkit-server in Claude Code?
Run this command in your terminal: claude mcp add --env MAPBOX_ACCESS_TOKEN=<MAPBOX_ACCESS_TOKEN> --transport stdio mcp-devkit-server -- npx -y @mapbox/mcp-devkit-server.
What does mcp-devkit-server do?
It gives AI assistants direct access to Mapbox APIs for style editing and token operations, alongside local geospatial helper tools and layer documentation.
How does mcp-devkit-server differ from mcp-docs-server?
mcp-devkit-server performs actions through developer APIs like managing styles and tokens, while mcp-docs-server retrieves documentation guides and API references.
