Mapbox MCP Server

MCP server for Mapbox Geocoding API v6. Provides forward geocoding (address to coordinates) functionality through the Model Context Protocol.

Installation

Local Installation

npm install
npm run build

Global Installation (for npm package)

npm install -g @solosync/mapbox-mcp-server

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mapbox-geocoding": {
      "command": "node",
      "args": [
        "/path/to/mapbox-mcp-server/dist/mcp-server.js"
      ],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "your-mapbox-token-here"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "mapbox-geocoding": {
      "command": "mapbox-mcp-server",
      "env": {
        "MAPBOX_ACCESS_TOKEN": "your-mapbox-token-here"
      }
    }
  }
}

Tools

mapbox_geocode_forward

Convert address or place name to coordinates using Mapbox Geocoding API.

Parameters:

• q (required): The address or place name to geocode (e.g., "10121 dewey drive" or "San Francisco, CA")
• access_token (optional): Mapbox API access token (uses MAPBOX_ACCESS_TOKEN env var if not provided)
• permanent (optional): Whether you intend to store the results (default: false)

Example:

{
  "q": "425 W Randolph St, Chicago, IL",
  "permanent": false
}

Environment Variables

• MAPBOX_ACCESS_TOKEN: Your Mapbox API access token (required)

License

MIT