Mapbox MCP Server

What is Mapbox MCP Server?

Mapbox MCP Server is a Node.js implementation of the Model Context Protocol (MCP) that provides access to Mapbox APIs. It allows AI agents and MCP-compatible clients to perform geospatial tasks such as routing, geocoding, place search, static map generation, and isochrone calculations using a Mapbox access token.

How to use Mapbox MCP Server?

Configure your MCP client (e.g., Claude Desktop, VS Code) with a Mapbox access token. Build the server with npm run build, then inspect it using npx @modelcontextprotocol/inspector node dist/index.js or run via Docker. Detailed setup guides for Claude Desktop and VS Code are provided in the docs/ folder.

Key features of Mapbox MCP Server

• Matrix tool: Calculate travel times and distances between multiple points
• Static image tool: Generate custom static map images with markers and overlays
• POI search tool: Find specific points of interest or brand locations by name
• Category search tool: Search for places by category (restaurants, hotels, etc.)
• Forward and reverse geocoding tools: Convert addresses to coordinates and vice versa
• Directions tool: Fetch routing directions with multiple profiles and waypoints
• Isochrone tool: Compute reachable areas within specified travel times or distances

Use cases of Mapbox MCP Server

• Route planning: Generate driving, walking, or cycling directions with traffic-aware schedules
• Place discovery: Find nearby points of interest or branches of a specific brand
• Geocoding workflows: Transform addresses to coordinates for analysis or mapping
• Static map generation: Produce custom map images for reports or dashboards
• Accessibility analysis: Compute isochrones to determine service coverage areas

FAQ from Mapbox MCP Server

What is required to use this server?

A Mapbox access token is mandatory. Sign up for a free Mapbox account and create or retrieve a token from the Mapbox Account page.

Which Mapbox APIs does the server expose?

It exposes tools for the Matrix API, Static Image API, Search Box (forward and category search), Geocoding V6 API, Directions API, and Isochrone API.

How do I run or inspect the server?

Build with npm run build, then use npx @modelcontextprotocol/inspector node dist/index.js or run via Docker: docker run -i --rm --env MAPBOX_ACCESS_TOKEN="YOUR_TOKEN" mapbox-mcp-server. Integration guides for Claude Desktop and VS Code are available in the docs/ directory.

Are there any limits on data or usage?

The README does not specify usage limits beyond those imposed by your Mapbox account plan (e.g., free tier rate limits). Consult the Mapbox documentation for details.

How do I create a new tool for this server?

Use the Plop generator: npx plop create-tool and provide a tool name without suffix (e.g., Search).