Submit Log in

Mapbox MCP Server

by Mapbox

Released Jun 12, 2025

v0.14.0

MIT

Repository Docs npm

Web & Search

mapboxmapsgeocodingroutinggeospatialisochronelocation

Summary

Mapbox's official MCP server — geocoding, POI search, routing, isochrones and live interactive maps rendered inside the chat.

Features

Forward and reverse geocoding plus worldwide POI and category search
Driving, walking and cycling directions with live traffic and route optimisation
Isochrones, travel-time matrices and GPS map matching
ground_location_tool answers coordinate-first questions in a single composite call
render_map_tool draws a live interactive Mapbox GL JS map inside the chat
Offline Turf.js geometry: distance, area, bearing, buffers, point-in-polygon
Static map images as base64 PNG/JPEG for clients without MCP Apps

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it, filling in the environment variables with your own values.
Restart the agent — the "Mapbox MCP Server" tools will be available.

{
  "mcpServers": {
    "mapbox-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mapbox/mcp-server"
      ],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "your-mapbox-access-token"
      }
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add mapbox-mcp-server -e MAPBOX_ACCESS_TOKEN=your-mapbox-access-token -- npx -y @mapbox/mcp-server

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "mapbox-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mapbox/mcp-server"
      ],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "your-mapbox-access-token"
      }
    }
  }
}

Cursor

{
  "command": "npx",
  "args": [
    "-y",
    "@mapbox/mcp-server"
  ],
  "env": {
    "MAPBOX_ACCESS_TOKEN": "your-mapbox-access-token"
  }
}

Windsurf

{
  "command": "npx",
  "args": [
    "-y",
    "@mapbox/mcp-server"
  ],
  "env": {
    "MAPBOX_ACCESS_TOKEN": "your-mapbox-access-token"
  }
}

VS Code

{
  "command": "npx",
  "args": [
    "-y",
    "@mapbox/mcp-server"
  ],
  "env": {
    "MAPBOX_ACCESS_TOKEN": "your-mapbox-access-token"
  }
}

Description

Mapbox's official MCP server gives an assistant a working sense of where. It wraps the Mapbox location platform — geocoding, search, directions, matrices, isochrones, map matching — and adds a rendering primitive that draws the result as a real, interactive map rather than describing it in prose.

Location intelligence it provides

Geocoding and search — forward and reverse geocoding worldwide, plus POI search across millions of businesses and landmarks.
Routing — driving, walking and cycling directions with live traffic; travel-time matrices for accessibility analysis; route optimisation over multiple stops (the travelling-salesman case); map matching to snap raw GPS traces onto the road network.
Isochrones — polygons of everything reachable within a time or distance budget.
`ground_location_tool` — a composite for coordinate-first questions ("what's near me", "what neighbourhood is this", "what's reachable in fifteen minutes"). It picks between reverse geocoding, category search and isochrone internally and returns typed records with citations, in one call instead of three.
Offline geospatial maths — distance, bearing, midpoint, centroid, area, bounding box, destination-from-bearing, buffers and point-in-polygon, computed locally with Turf.js. No API call, no token spend, works without connectivity.

Rendering

render_map_tool is the server's single visualisation primitive. Through the MCP Apps protocol it renders a self-contained Mapbox GL JS panel inside the conversation, with a fullscreen toggle, in clients that support it. It also accepts hand-composed GeoJSON directly, so you can draw your own polygons and markers without calling any other Mapbox tool. For clients without MCP Apps support, static_map_image_tool returns a base64 PNG or JPEG that every client can display.

Two tools — search_and_geocode_tool and directions_tool — use MCP elicitations to ask the user which result or route they meant, and degrade gracefully where the client cannot ask.

Setup

A Mapbox access token is required; the free tier is enough to try it. Use the hosted endpoint at https://mcp.mapbox.com/mcp, or run locally with npx -y @mapbox/mcp-server. Setup guides ship for Claude Desktop, Cursor, VS Code, Goose and smolagents, and the tools can be imported directly into your own application without running the server at all. MIT licensed.

Related MCP Servers

MCP: Meilisearch MCP Server

by Meilisearch

New

Official MCP server for Meilisearch — create and configure indexes, add documents, run hybrid and semantic searches, and manage API keys and tasks through conversation.

Web & SearchDatabases & Data