home / mcp / mapbox mcp server

Mapbox MCP Server

Provides geospatial access to Mapbox tools for MCP-based clients and applications.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "mapbox-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mapbox/mcp-server",
        "--disable-mcp-ui"
      ],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

The Mapbox MCP Server gives your AI applications direct access to Mapbox’s geospatial data and tools through a standard MCP interface. It enables you to perform global geocoding, POI search, multi‑modal routing, travel time matrices, isochrones, and static map visuals, so your agents can understand and reason about places, routes, and geographic contexts.

How to use

You connect to the MCP server from your MCP client to perform geospatial queries and tool calls. Use the hosted endpoint for quick access, or run a local MCP server instance to keep all data processing within your environment.

How to install

Prerequisites: you need a working Node.js and npm environment on your machine.

1) Ensure you have a Mapbox access token. You can obtain one by signing up at mapbox.com/signup and creating a token on your Account page.

2) Install and build the MCP server locally if you are working from source. In your project directory, install dependencies and build the server.

3) Start the MCP server. Use the MCP command shown for running the server with UI disabled and provide your Mapbox access token via environment variables.

npx -y @mapbox/mcp-server --disable-mcp-ui

Additional configuration and usage notes

MCP UI support is enabled by default and can be disabled with the command above or via environment/CLI flags. When you configure clients, you will typically provide your Mapbox access token and point the client at the MCP endpoint you are using (hosted or local).

Tools and capabilities described

This MCP server provides a range of location intelligence tools you can leverage from your agents and workflows, including:

Matrix and routing tools

Matrix Tool for travel time and distance calculations across multiple points and profiles (driving, walking, cycling)
Directions Tool for routing with multiple waypoints, traffic, and exclusions
Isochrone Tool for visualizing reachable areas within given times or distances

Geocoding, search, and POI tools

Reverse geocoding and forward geocoding to resolve coordinates and addresses
Category search and POI lookups to find places by type
Static map image tool for generating map visuals with markers and overlays

Visualization and analysis

Static map images for embedding routes and locations in outputs
Isochrone and travel-time analyses for planning and optimization

Available tools

Matrix Tool

Calculates travel times and distances between multiple points with support for driving-traffic, driving, walking, and cycling profiles, including departure timing and route summaries.

Static image tool

Generates static map images with configurable styles, dimensions, zoom, and markers for visualizing routes and locations.

Category List Tool

Provides access to available Mapbox category IDs for POI searches, with language variations and filtering by category.

Category Search tool

Performs category-based POI searches with proximity filtering, result limits, and rich metadata.

Reverse geocoding tool

Converts coordinates to human-readable addresses with controllable detail and language options.

Directions tool

Fetches route directions with multiple waypoints, profile options,及 departure/arrival scheduling, and route annotations.

Isochrone tool

Computes areas reachable within specified times/distances for given travel profiles.

Search and geocode tool

Unified tool for searching POIs and geocoding using the Mapbox Search Box API.