Gamut
Mapbox logo
Developer ToolsAuth: OAuth

Mapbox MCP Server

Connect Mapbox to your AI agents with the Mapbox MCP server.

Updated

Use Mapbox on Gamut

What is Mapbox MCP?

The Mapbox MCP server is a Model Context Protocol server that connects Mapbox to AI agents and assistants as a set of tools. With it connected, an agent can work with Mapbox (maps & geospatial — geocoding, directions, navigation, places) directly — instead of you copying data in and out by hand.

It is a remote MCP server that uses OAuth, so you point your client at the server URL, authorize once, and the Mapbox tools become available to the model.

Connect the Mapbox MCP server

Connect Mapbox MCP to Claude Code

  1. 1

    Add the server

    Use `claude mcp add` with the Mapbox MCP server URL (or its `npx` command), following the official docs.

  2. 2

    Authorize

    Complete authentication (OAuth) so Claude Code can call the server.

  3. 3

    Verify

    Ask Claude to use a Mapbox tool to confirm the connection is live.

Connect Mapbox MCP to Cursor

  1. 1

    Open MCP settings

    In Cursor, go to Settings → MCP → Add new server.

  2. 2

    Add Mapbox

    Provide the Mapbox MCP server URL or command and complete authentication.

  3. 3

    Test

    Reference Mapbox from chat to confirm Cursor can reach the tools.

Sample use cases

Using Mapbox MCP with Gamut

On Gamut, the Mapbox MCP server becomes a tool your agents use inside an automated, event-driven workflow — triggered by an event or a schedule, acting through Mapbox and your other connected MCP servers, with the connection managed by Gamut rather than a local config file.

Frequently asked questions

Does the Mapbox MCP server support real-time traffic data?

Yes. Mapbox's Directions API includes traffic-aware routing, and the MCP server can request routes with real-time or typical traffic estimates.

Can I generate interactive maps through MCP?

The MCP server is best suited for data retrieval (geocoding, routing, POI search) and static map image generation. Interactive maps require the Mapbox GL JS SDK on the frontend.

What are the rate limits for Mapbox MCP?

Rate limits depend on your Mapbox account plan. Free tier includes 100,000 geocoding requests and 100,000 directions requests per month.

Does Mapbox MCP support batch geocoding?

You can geocode multiple addresses by making sequential requests through the MCP server. Mapbox's batch geocoding endpoint (if available on your plan) can also be used.

Can I use Mapbox MCP for navigation apps?

The MCP server can provide routing data, but real-time navigation with turn-by-turn guidance is typically handled by Mapbox's Navigation SDK on mobile devices.

Does it support custom map styles?

For static map generation, you can specify a Mapbox style URL. For interactive maps with custom styles, use the Mapbox Studio and GL JS directly.

Is Mapbox MCP free to use?

Mapbox has a generous free tier for most API services. The MCP server is free and open source; you pay only for Mapbox API usage above the free tier limits.