Mapbox MCP Server transforms AI agents into geospatially-aware systems by providing seamless access to Mapbox's location intelligence platform. It enables AI applications to understand, reason about, and interact with geographic data, benefiting developers building location-aware AI tools.

How It Works

This Node.js server implements the Model Context Protocol (MCP), acting as a bridge between AI applications and various Mapbox APIs. It offers a suite of tools for geocoding, routing, points of interest search, static map generation, and isochrone calculations, allowing AI to leverage comprehensive geospatial data.

Quick Start & Requirements

• Primary install/run command: Local setup involves npm run build and inspection via npx @modelcontextprotocol/inspector node dist/index.js. Docker usage requires docker build -t mapbox-mcp-server . and inspection via npx @modelcontextprotocol/inspector docker run -i --rm --env MAPBOX_ACCESS_TOKEN="YOUR_TOKEN" mapbox-mcp-server.
• Non-default prerequisites: A Mapbox access token is mandatory. Node.js is required for local builds; Docker for containerized deployment.
• Links: Hosted MCP Endpoint: https://mcp.mapbox.com/mcp. Mapbox signup: mapbox.com/signup. Integration guides available for Claude Desktop, VS Code, Cursor AI IDE, and Smolagents.

Highlighted Details

• Provides tools for geocoding, POI search, multi-modal routing, matrix calculations, static map image generation, and isochrone analysis.
• Enables AI integration with popular clients like Claude Desktop, VS Code, and Cursor AI IDE.
• Data is sent directly from the user's environment to Mapbox APIs, with API token security maintained locally.
• Supports various Mapbox APIs including Geocoding V6, Directions, Search Box, and Isochrone.

Maintenance & Community

• Officially maintained by Mapbox, Inc., with regular updates, bug fixes, security patches, and compatibility maintenance.
• Support via email (mcp-feedback@mapbox.com) and GitHub Issues for bug reports and feature requests. Mapbox Support portal for API-related queries.

Licensing & Compatibility

• License type: BSD 3-Clause License.
• Compatibility notes: No explicit restrictions noted for commercial use or closed-source linking.

Limitations & Caveats

Requires a Mapbox access token, potentially incurring costs beyond free tier usage. Functionality is tied to Mapbox's specific geospatial service offerings.