Mapbox

Exposes Mapbox routing, matrix, and geocoding as MCP endpoints for easy client integration.

typescript

2

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-aidenyangx_mapbox-mcp-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/mapbox-mcp-server/build/index.js"
      ],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "your-api-key"
      }
    }
  }
}

You can run the Mapbox MCP Server to expose Mapbox routing, matrix, and geocoding capabilities as MCP endpoints. This server lets you perform directions, place-based routing, travel time and distance matrices, and geocoding through a unified MCP interface, making Mapbox data easily consumable by MCP clients.

How to use

To use this MCP server, you run it locally and connect to it with an MCP client. The server exposes tools for directions, matrix calculations, and geocoding. You can call each tool by name through the MCP protocol and supply the required inputs such as coordinates or place names. The server handles input validation, API interactions with Mapbox, and returns route steps, distances, durations, and any relevant errors.

How to install

Prerequisites: you need Node.js 16 or higher and TypeScript 4.5 or higher. You also need a valid Mapbox API key.

Set up the environment and start the server: create a Mapbox API key and export it as an environment variable.

Run the server in your environment using the runtime command shown in the configuration snippet.

export MAPBOX_ACCESS_TOKEN=your_api_key_here

# Start the Mapbox MCP Server using the provided runtime command
node /absolute/path/to/mapbox-mcp-server/build/index.js

Configuration and runtime details

The server supports several tools and is designed to validate inputs, handle API request failures gracefully, and respect rate limits per API category.

{
  "mcpServers": {
    "mapbox_mcp": {
      "command": "node",
      "args": ["/absolute/path/to/mapbox-mcp-server/build/index.js"],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "your-api-key"
      }
    }
  }
}

Available tools

mapbox_directions

Get directions between coordinates with optional profiles driving-traffic, driving, walking, and cycling. Returns route details including steps, distance, and duration.

mapbox_directions_by_places

Get directions between named places. Returns geocoding results for each place and route details with steps, distance, and duration.

mapbox_matrix

Compute travel time and distance matrices between coordinates with optional sources and destinations and profile options.

mapbox_matrix_by_places

Compute travel time and distance matrices between named places including geocoding results and matrix values.

mapbox_geocoding

Search for places or addresses and convert them to coordinates with optional limit, type filtering, and language.