mapbox-mcp.md

Mapbox MCP App

MCP App · UI in chatFeatured
from"Mapbox"
366

Mapbox maintains this official hosted and open-source MCP server for its geospatial services. Search, routing and analysis tools return data that render_map_tool displays in a Mapbox GL JS app registered at ui://mapbox/map-app/index.html.

Not for: Inline maps in hosts without MCP Apps support. Those clients can use static_map_image_tool instead of the interactive panel.

Source and setup verified on 2026-11-05

Visualization
MapboxMCP Appsgeocodingrouting

Quick facts

Maintainer
Mapbox (official)
Hosted endpoint
https://mcp.mapbox.com/mcp
npm package
@mapbox/mcp-server 0.16.0
Authentication
Mapbox OAuth or access token
UI evidence
ui://mapbox/map-app/index.html; text/html;profile=mcp-app

What you can do

  • Search, forward geocode and reverse geocode locations
  • Calculate directions, isochrones, matrices and optimized routes
  • Run offline Turf.js distance, area, buffer and polygon operations
  • Render GeoJSON, routes and search results as an interactive Mapbox GL JS map
  • Generate static map images for clients without MCP Apps

Requirements

  • A Mapbox account
  • OAuth-capable MCP client or a Mapbox access token
  • MCP Apps support for the live map; otherwise use static images
setup.md
# 1. Use the hosted endpoint

Connect the client to https://mcp.mapbox.com/mcp. No local server installation is required.

# 2. Authenticate

Complete Mapbox OAuth when prompted, or use a bearer access token in clients that support custom headers.

# 3. Render a map

Ask the agent to call render_map_tool with the mapboxRender payload returned by a geospatial tool.

# Claude Desktop → claude_desktop_config.json
{
  "mcpServers": {
    "mapbox-mcp": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.mapbox.com/mcp"]
    }
  }
}

The hosted guide says Claude Desktop currently uses mcp-remote for remote endpoints, then opens the Mapbox OAuth flow.

Always confirm the latest setup instructions with the maintainer before installing.

>Questions

Is the Mapbox MCP server official?

Yes. Mapbox owns the repository, npm package and hosted endpoint.

Does it render a real interactive map inside the chat?

Yes, in MCP Apps hosts. render_map_tool targets ui://mapbox/map-app/index.html and serves text/html;profile=mcp-app.

What happens if the client does not support MCP Apps?

Use static_map_image_tool for a map image. The interactive Mapbox GL JS panel requires MCP Apps support.