mapbox/mcp-server

Node.js server implementing Model Context Protocol (MCP) for Mapbox APIs.
Unlock Geospatial Intelligence for Your AI Applications
The Mapbox MCP Server transforms any AI agent or application into a geospatially-aware system by providing seamless access to Mapbox's comprehensive location intelligence platform. With this server, your AI can understand and reason about places, navigate the physical world, and access rich geospatial data including:
- **Global geocoding** to convert addresses and place names to coordinates and vice versa
- **Points of interest (POI) search** across millions of businesses, landmarks, and places worldwide
- **Multi-modal routing** for driving, walking, and cycling with real-time traffic
- **Travel time matrices** to analyze accessibility and optimize logistics
- **Route optimization** to find the optimal visiting order for multiple stops (traveling salesman problem)
- **Map matching** to snap GPS traces to the road network for clean route visualization
- **Isochrone generation** to visualize areas reachable within specific time or distance constraints
- **Live, interactive map rendering** (render_map_tool) to display routes, search results, and your own custom GeoJSON on a real Mapbox GL JS map directly inside the chat
- **Static map images** to create visual representations of locations, routes, and geographic data
- **Offline geospatial calculations** for distance, area, bearing, buffers, and spatial analysis without requiring API calls
Whether you're building an AI travel assistant, logistics optimizer, location-based recommender, or any application that needs to understand "where", the Mapbox MCP Server provides the spatial intelligence to make it possible. You can also enable it on popular clients like Claude Desktop and VS Code. See below for details
Usage
**A Mapbox access token is required to use this MCP server.**
Hosted MCP Endpoint
For quick access, you can use our hosted MCP endpoint:
**Endpoint**: https://mcp.mapbox.com/mcp
For detailed setup instructions for different clients and API usage, see the Hosted MCP Server Guide.
To get a Mapbox access token:
1. Sign up for a free Mapbox account at mapbox.com/signup
2. Navigate to your Account page
3. Create a new token or use the default public token
For more information about Mapbox access tokens, see the Mapbox documentation on access tokens.
Integration Guides
For detailed setup instructions for different integrations, refer to the following guides:
- Claude Desktop Setup - Instructions for configuring Claude Desktop to work with this MCP server
- Goose Setup - Setting up Goose AI agent framework
- VS Code Setup - Setting up a development environment in Visual Studio Code
- Cursor AI IDE Setup - Setting up a development environment in Cursor AI IDE
- Smolagents Integration - Example showing how to connect Smolagents AI agents to Mapbox's tools
- **Importing Tools Directly** - Use Mapbox tools in your own applications without running the MCP server
- **render_map_tool Guide** - The map visualization primitive: full payload schema and how to render your own data standalone, without any other Mapbox tool
- **Elicitations** - How search_and_geocode_tool and directions_tool ask the user to disambiguate results or pick a route, and how they fall back gracefully when the client doesn't support it
Example Prompts
Try these prompts with Claude Desktop or other MCP clients after setup:
Location Grounding
For coordinate-first queries — _"what's near me"_, _"what neighborhood is this"_, _"what's reachable in N minutes"_ — use ground_location_tool. It composes reverse geocoding, category search, and isochrone in a single call, adaptively choosing the right strategy based on the query, and returns typed records (names, addresses, coordinates, distances, reachability polygons) with citations.
Each of the four prompts below exercises a different strategy in one tool call:
- **Neighborhood** — _"What neighborhood is 47.6097, -122.3408, and what's around me?"_
- **POI** — _"Coffee shops within a 10-minute walk of 40.7580, -73.9855"_
- **Region** — _"What can I reach in a 15-minute walk from 37.7749, -122.4194?"_
- **Routing** — _"Closest routable point to drop someone off at 34.0522, -118.2437"_
Location Discovery
- "Find coffee shops within walking distance of the Empire State Building"
- "I want to go from Seattle to Portland, is there a Starbucks along the way?"
- "Show me gas stations along the route from Boston to New York"