# Mapbox MCP

> Mapbox (Maps & Geospatial) gives your AI agent world-class control over location data. Use it to find coordinates from addresses, plot multi-stop delivery routes, calculate reachable areas by walking time, and analyze elevation at any point on Earth.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** geospatial-intelligence, routing, reverse-geocoding, location-data, mapping, gps-coordinates

## Description

Need to work with geography? This MCP connects advanced mapping intelligence directly into your AI client. You stop manually opening GIS software or struggling with messy spreadsheets of GPS points. Instead, you talk to your agent—your agent handles the complex math behind location data.

For example, instead of figuring out the best path for a delivery team visiting ten sites, you simply ask the system what the optimal sequence is and how long it'll take. You can calculate all-to-all travel times between dozens of points or determine exactly which areas are reachable within a 15-minute bike ride. It’s like having a professional logistics planner available instantly through natural conversation. If you use Vinkius for your catalog, this MCP provides the precise tools to build location-aware applications without ever touching API documentation.

## Tools

### get_directions
Calculates driving, walking, or cycling directions between any two points.

### get_elevation
Retrieves the elevation data for a specific geographical coordinate point.

### search_places
Finds locations, addresses, or points of interest using Mapbox's search functionality.

### get_isochrones
Calculates polygons that show all areas reachable within a set amount of travel time.

### snap_to_road
Cleans up noisy GPS data tracks by aligning them perfectly to the official road network.

### get_distance_matrix
Calculates a comprehensive table of travel times and distances between multiple origins and destinations.

### solve_optimization
Determines the most efficient order to visit a set of locations, minimizing overall travel time for multi-stop trips.

### reverse_geocode
Identifies specific place names or addresses based on given coordinates.

### geocoding_session
Performs autocomplete searches for addresses while maintaining a continuous session context.

### generate_static_map
Creates a static image URL of a map centered on specific coordinates.

## Prompt Examples

**Prompt:** 
```
Find the coordinates for 'Golden Gate Bridge' in San Francisco
```

**Response:** 
```
Resolving place… I've found the Golden Gate Bridge at latitude 37.8199 and longitude -122.4783. It is classified as a POI (Point of Interest). Would you like me to find driving directions to this location?
```

**Prompt:** 
```
Get driving directions from New York to Philadelphia with traffic-aware ETA
```

**Response:** 
```
Calculating route… The optimal path via I-95 S is approximately 152 km. With current traffic conditions, the estimated travel time is 1 hour and 45 minutes. I can provide the detailed turn-by-turn navigation data if you'd like.
```

**Prompt:** 
```
What areas are within a 5-minute walk from '-73.9857,40.7484'?
```

**Response:** 
```
Computing isochrone… I've generated a 5-minute walking polygon centered near the Empire State Building. This area covers approximately 0.8 square kilometers. Would you like me to provide the GeoJSON coordinates for this reachable zone?
```

## Capabilities

### Find Coordinates from Text
The system converts text addresses or place names into exact latitude and longitude coordinates.

### Calculate Optimal Routes
It figures out the best paths for driving, walking, or cycling between multiple points, factoring in real-time traffic.

### Optimize Multi-Stop Trips
The system solves complex routing puzzles (like the Traveling Salesperson Problem) to give you the most time-efficient visit order for a group of locations.

### Analyze Reachable Areas
It draws polygons showing what area is reachable from a point within a set travel time, whether by foot or car.

### Clean GPS Data Tracks
The system corrects noisy or inaccurate GPS tracking data so it aligns perfectly with actual road networks.

### Determine Altitude and Elevation
You can query the precise elevation data for any specific coordinate point on the map.

## Use Cases

### Optimizing Field Service Calls
A service company needs to schedule five technicians across three different cities. Instead of building complex Excel models, the user asks their agent to solve_optimization using get_distance_matrix to find the minimum travel time sequence for all appointments.

### Defining Service Zones
A retailer needs to know its service area radius. The analyst uses get_isochrones, asking what areas are within a 10-minute drive from their main warehouse coordinates, helping them define profitable expansion zones.

### Validating GPS Data
A researcher collects raw GPS data from a drone flight. They use snap_to_road to clean the noisy coordinate set, ensuring that every recorded point accurately matches an existing road segment for analysis.

### Identifying Key Points of Interest
An agent is given coordinates but doesn't know what they are. The user prompts reverse_geocode, and the system correctly identifies the location as 'Corner Street Diner,' providing instant context.

## Benefits

- Stop guessing the best route. Use get_distance_matrix to instantly calculate travel times between dozens of locations, giving you a complete logistics matrix for fleet management.
- Need to know coverage? Run get_isochrones to draw precise polygons showing exactly what areas are within a 15-minute walk or drive from your office location.
- Clean up messy data. If your GPS tracks are noisy, snap_to_road aligns them perfectly to the actual road network, giving you accurate tracking records for field teams.
- Solve trip planning instantly. The solve_optimization tool figures out the absolute best order to visit multiple stops, saving hours of manual calculation time.
- Understand location context. Instead of just having numbers, use reverse_geocode to take coordinates and get the real address or point of interest name attached.
- Visualize data quickly. generate_static_map lets you create a visual map image right from your agent's response for immediate client review.

## How It Works

The bottom line is that it turns complicated mapping tasks into simple conversational commands.

1. First, subscribe to this MCP and input your Mapbox Access Token.
2. Next, you direct your AI client to perform a geospatial task using natural language prompts.
3. Finally, the system returns precise coordinates, calculated routes, or visual map data for immediate use.

## Frequently Asked Questions

**How do I find the coordinates for an address using Mapbox (Maps & Geospatial)?**
You use search_places. Simply ask your agent to find the location name or address, and it returns precise latitude and longitude coordinates.

**Can I calculate travel time between multiple stops with Mapbox (Maps & Geospatial)?**
Yes, you should use get_distance_matrix. This tool computes a full matrix of travel times and distances for all origins and destinations simultaneously.

**What is the best way to optimize a delivery route using Mapbox (Maps & Geospatial)?**
For finding the absolute most efficient visiting order, use solve_optimization. It solves the complex Traveling Salesperson Problem for you.

**How does get_isochrones work with Mapbox (Maps & Geospatial)?**
It calculates reachable areas by time. For example, it draws a polygon showing every place accessible within a 15-minute walk from your starting point.

**Does Mapbox (Maps & Geospatial) help me clean my own GPS data?**
Yes, use snap_to_road. This tool cleans up noisy or inaccurate GPS traces by forcing them to align perfectly onto the actual road network.