mcp-server · mapbox — Claude Code MCP server: what it does, how to install
Connects Mapbox location APIs to your AI assistant for geocoding, multi-modal routing, and map rendering. Helpful when building travel planners or spatial query assistants.
claude mcp add --transport http mcp-server https://mcp.mapbox.com/mcpWhat mcp-server does
The server exposes Mapbox tools over a hosted HTTP endpoint at https://mcp.mapbox.com/mcp or runs locally using Node.js via @mapbox/mcp-server. It lets your assistant convert street addresses into coordinates and calculate travel directions with live traffic.
Through render_map_tool, assistants can display an interactive Mapbox GL JS map with custom GeoJSON directly in supported chat views. Offline spatial calculations like measuring distances and polygon areas run locally without hitting web endpoints.
Every remote query requires this key. Obtain a MAPBOX_ACCESS_TOKEN from your Mapbox account before configuring the client.
What it helps with
- calculate travel directions with current traffic delays
- locate points of interest around specific coordinates
- generate isochrone polygons for walking or driving times
- render custom GeoJSON objects on interactive web maps
- match raw GPS points to the actual road grid
Example prompts for the agent
- Find coffee shops within a ten-minute walk from my coordinates
- Optimize a delivery route for these four addresses and show the total duration
- Draw an interactive map with a 15-minute driving isochrone around downtown
How to install mcp-server
1Platform CLI: remote server
claude mcp add --transport http mcp-server https://mcp.mapbox.com/mcp2Platform CLI
claude mcp add --env MAPBOX_ACCESS_TOKEN=<MAPBOX_ACCESS_TOKEN> --transport stdio mapbox-mcp-server -- npx -y @mapbox/mcp-serverReplace <…> with your own values
1Platform CLI: remote server
codex mcp add mapbox-mcp-server --url https://mcp.mapbox.com/mcp2Platform CLI
codex mcp add mapbox-mcp-server --env MAPBOX_ACCESS_TOKEN=<MAPBOX_ACCESS_TOKEN> -- npx -y @mapbox/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"mapbox-mcp-server": {
"url": "https://mcp.mapbox.com/mcp"
}
}
}{
"mcpServers": {
"mapbox-mcp-server": {
"command": "npx",
"args": [
"-y",
"@mapbox/mcp-server"
],
"env": {
"MAPBOX_ACCESS_TOKEN": "<MAPBOX_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mapbox-mcp-server": {
"type": "http",
"url": "https://mcp.mapbox.com/mcp"
}
}
}{
"servers": {
"mapbox-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mapbox/mcp-server"
],
"env": {
"MAPBOX_ACCESS_TOKEN": "<MAPBOX_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http mapbox-mcp-server https://mcp.mapbox.com/mcp2Platform CLI
gemini mcp add -e MAPBOX_ACCESS_TOKEN=<MAPBOX_ACCESS_TOKEN> mapbox-mcp-server npx -y @mapbox/mcp-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-server
How to install mcp-server in Claude Code?
Run claude mcp add --transport http mcp-server https://mcp.mapbox.com/mcp in your terminal.
What does mcp-server do?
It equips AI agents with Mapbox geospatial capabilities, including address search, navigation routes, travel matrices, and map visualizations.
Is a Mapbox account required?
Yes. You must provide a valid MAPBOX_ACCESS_TOKEN generated from your Mapbox dashboard.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →mcp-server by other authors comes first.
