MCP Server logo

MCP Server

by mapbox

Mapbox APIs for geocoding, place search, routing, isochrones, maps, and offline geospatial calculations over MCP.

Install MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-server-139": {
      "command": "npx",
      "args": [
        "-y",
        "@mapbox/mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @mapbox/mcp-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 2d ago.

Overview

The mapbox/mcp-server MCP server connects AI applications to Mapbox APIs for geocoding, place discovery, routing, travel-time analysis, map rendering, and spatial calculations. It runs as a Node.js MCP server or through Mapbox's hosted endpoint and requires a Mapbox access token. Reach for it when an agent needs to interpret locations, plan journeys, analyze reachability, or produce map visuals. MCP resources also provide read-only Mapbox category data for search filters.

Use cases

  • Find nearby businesses and landmarks
  • Plan routes between addresses with travel times
  • Analyze reachable areas with isochrones
  • Optimize multi-stop delivery or travel plans
  • Render routes and custom GeoJSON on maps

Key features

  • Global geocoding and reverse geocoding
  • POI and category search
  • Driving, walking, and cycling directions
  • Travel-time matrices and route optimization
  • Interactive and static map rendering
  • Offline geospatial calculations

Tools1

What MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~21 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/7 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · @mapbox/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars363Stargazers on the source repository.
npm downloads8.7kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed1Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server works

What mapbox/mcp-server MCP server does

The mapbox/mcp-server MCP server gives MCP-compatible agents access to Mapbox location services. Its capabilities cover address and coordinate lookup, points-of-interest discovery, route planning, travel-time comparisons, route ordering, GPS trace matching, reachable-area analysis, and map output.

This fits applications that need location context rather than general-purpose geographic data access. Examples include travel assistants, delivery planning, location-based recommendations, and agents that need to answer questions about nearby places or estimated journey times. The server also includes local calculations for common geometry tasks, so some operations can run without an API request.

The project belongs to the 🗺️ Location Services category and exposes Mapbox functionality through MCP tools and resources.

How it works

A client sends natural-language requests to the MCP server, which invokes the relevant Mapbox capability and returns structured results. Supported workflows include converting place names to coordinates, searching for businesses or landmarks, calculating driving, walking, or cycling routes, and finding locations along a route. Directions can account for current traffic where the selected Mapbox operation provides it.

The server includes a render_map_tool for interactive Mapbox GL JS previews. It can display routes, search results, and supplied GeoJSON. Static map images are also available for visual representations of locations and geographic data. For coordinate-first requests, ground_location_tool combines location grounding operations such as reverse geocoding, category search, and isochrone analysis.

MCP resources provide read-only category reference data. The mapbox://categories URI returns the default category list, while mapbox://categories/{language} supports localized category names such as Japanese or Spanish. Clients with native resource support can read these URIs directly; other clients can use resource_reader_tool.

Setup and configuration

The mapbox/mcp-server MCP server requires a Mapbox access token. Create or retrieve one from a Mapbox account before connecting a client. The repository documents a hosted MCP endpoint at https://mcp.mapbox.com/mcp, as well as setup guides for Claude Desktop, Goose, Visual Studio Code, and Cursor.

The repository is a Node.js implementation and also documents importing the Mapbox tools directly into an application without running the MCP server. Client-specific configuration details are provided in the project’s integration guides.

Tools and capabilities

The mapbox/mcp-server MCP server supports the following workflows:

  • Geocode addresses and place names, and reverse geocode coordinates.
  • Search for POIs such as restaurants, hotels, gas stations, and other categories.
  • Calculate driving, walking, and cycling directions, including traffic-aware requests.
  • Build travel-time matrices between multiple locations.
  • Optimize the order of multiple stops.
  • Match GPS traces to the road network.
  • Generate isochrones based on time or distance limits.
  • Render interactive maps, static map images, routes, markers, and custom GeoJSON.
  • Perform offline distance, area, bearing, buffer, midpoint, centroid, bounding-box, point-in-polygon, and geometry-simplification calculations.

Limitations and notes

A valid Mapbox access token is required. API-backed operations depend on Mapbox services, while the project separately documents offline calculations that do not require API calls. Results and available behavior can vary by travel mode, location, request details, and the Mapbox API being used.

The server can ask users to disambiguate search results or choose a route through MCP elicitations. If a client does not support elicitation, the documented tools fall back to alternate behavior. Clients also differ in their support for MCP resources, so category data may need to be read through resource_reader_tool instead of resources/read.

The repository documents Claude Desktop, Visual Studio Code, and Cursor integrations. It also includes guidance for Goose and Smolagents, although those names are not represented in the standard client-slug list used here.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server

mapbox/mcp-server is an MCP server that connects AI applications to Mapbox APIs and provides tools for geocoding, POI search, directions, travel-time matrices, route optimization, isochrones, map matching, map rendering, and offline geospatial calculations. It requires a Mapbox access token and can run through a hosted MCP endpoint.

Use the repository’s client-specific setup instructions or connect to the hosted endpoint at https://mcp.mapbox.com/mcp. A Mapbox access token is required, and the project includes guides for Claude Desktop, Goose, VS Code, and Cursor.

Yes, mapbox/mcp-server documents setup guides for both Claude Desktop and Cursor. It also includes integration instructions for Visual Studio Code, Goose, and Smolagents.

Read the MCP resource at mapbox://categories for the default category list or use mapbox://categories/{language} for localized names. These category IDs can filter category searches, and clients without native resource support can use resource_reader_tool.

Yes, mapbox/mcp-server includes render_map_tool for interactive Mapbox GL JS map previews. It can display routes, search results, markers, and custom GeoJSON, and the server also supports static map images.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-server-139?style=directory)](https://allmcps.com/mcp/mcp-server-139)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-server-139"><img src="https://allmcps.com/api/badge/mcp-server-139?style=directory" alt="MCP Server on AllMCPs" /></a>