Mapbox MCP Server

MCP Server for the Mapbox API.

Features

Navigation Tools

1. mapbox_directions

   • Get directions between coordinates
   • Inputs:
     • coordinates ({latitude: number, longitude: number}[])
     • profile (optional): “driving-traffic”, “driving”, “walking”, “cycling”
   • Returns: route details with steps, distance, duration

2. mapbox_directions_by_places

   • Get directions between places using their names
   • Inputs:
     • places (string[]): Array of place names
     • profile (optional): “driving-traffic”, “driving”, “walking”, “cycling”
     • language (optional): Two-letter language code (e.g., “zh”, “en”)
   • Returns:
     • Geocoding results for each place
     • Route details with steps, distance, duration
     • Any errors that occurred during processing

3. mapbox_matrix

   • Calculate travel time and distance matrices between coordinates
   • Inputs:
     • coordinates ({latitude: number, longitude: number}[])
     • profile (optional): “driving”, “walking”, “cycling”
     • annotations (optional): “duration”, “distance”, “duration,distance”
     • sources (optional): Indices of source coordinates
     • destinations (optional): Indices of destination coordinates
   • Returns: Matrix of durations and/or distances between points

4. mapbox_matrix_by_places

   • Calculate travel time and distance matrices between places using their names
   • Inputs:
     • places (string[]): Array of place names (2-25 places)
     • profile (optional): “driving”, “walking”, “cycling”
     • annotations (optional): “duration”, “distance”, “duration,distance”
     • language (optional): Two-letter language code
     • sources (optional): Indices of source places
     • destinations (optional): Indices of destination places
   • Returns:
     • Geocoding results for each place
     • Matrix of durations and/or distances
     • Any errors that occurred during processing

Search Tools

1. mapbox_geocoding
   • Search for places and convert addresses into coordinates
   • Inputs:
     • searchText (string): The place or address to search for
     • limit (optional): Maximum number of results (1-10)
     • types (optional): Filter by place types (country, region, place, etc.)
     • language (optional): Two-letter language code
     • fuzzyMatch (optional): Enable/disable fuzzy matching
   • Returns: Detailed location information including coordinates and properties

Claude Desktop Integration

Add this configuration to your Claude Desktop config file (typically located at ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mapbox-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/mapbox-mcp-server/build/index.js"],
      "env": {