# Mapbox MCP for AI Agents AI Agent Connect > Mapbox MCP gives your AI agent the ability to understand and interact with the physical world. It handles things like turning addresses into coordinates, calculating travel times between multiple points, and finding nearby points of interest. Instead of manual lookups, your agent can handle the heavy lifting of spatial data. ## Overview - **Category:** cloud-infrastructure - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_znXoExoBtQ0oul4gKnIo9Zrl1E5NxISlrMn5Yhah/ai-agent-connect - **Tags:** geocoding, routing, spatial-data, mapping, location-services, navigation ## Description This connector gives your agent the ability to understand and interact with the physical world. It handles things like turning addresses into coordinates, calculating travel times between multiple points, and finding nearby points of interest. Instead of manual lookups, your agent can handle the heavy lifting of spatial data. If you need to know what's around a specific spot, it can scan for nearby restaurants or gas stations instantly. It even handles the visual side of things, providing direct links to map images that you can drop straight into your own applications or reports. This means you no longer have to manually copy-paste coordinates or build your own routing engine. Whether you're trying to map out a delivery route for a logistics fleet or just want to know the elevation of a hiking trail, this connection gives your agent eyes on the world. You can get this set up quickly through the Vinkius catalog, which makes managing your various connections a lot less of a headache. It's about getting spatial intelligence into your workflow without having to write a single line of routing logic yourself. This connection turns complex coordinate math into simple, actionable data for any project involving physical locations. ## Tools ### geocode geocode converts a place name into coordinates and structured address components. This helps you find exact locations for routing. ### get_directions get_directions provides step-by-step instructions and travel times for driving, walking, or cycling. It is great for planning specific trips. ### get_distance_matrix get_distance_matrix calculates travel durations and distances between multiple source and destination pairs. Use this for complex logistics. ### reverse_geocode reverse_geocode turns GPS coordinates back into a human-readable street address or city name. It is the best way to identify a location from a pin. ### search_nearby search_nearby finds nearby places like restaurants or gas stations based on a category and location. Use this to discover local points of interest. ### get_elevation get_elevation returns the height of a specific coordinate for geographic research or hiking. It gives you the vertical data for any spot. ### get_isochrone get_isochrone generates a polygon showing the area reachable within a set time or distance. This is perfect for defining service areas. ### get_static_map get_static_map creates a direct link for a map based on your desired zoom and dimensions. You can use these links directly in your UI. ## Prompt Examples **Prompt:** ``` How long does it take to drive from JFK to Manhattan? ``` **Response:** ``` ### Travel Estimate: JFK to Manhattan | Mode | Estimated Duration | Distance | | :--- | :--- | :--- | | **Driving** | 45-60 minutes | ~20 miles | | **Walking** | 14 hours | ~20 miles | | **Cycling** | 3 hours | ~20 miles | *Note: Driving times vary based on current traffic conditions.* ``` **Prompt:** ``` Find 3 coffee shops near the Empire State Building. ``` **Response:** ``` I found a few highly-rated coffee spots near the Empire State Building: * **Blue Bottle Coffee** - 0.2 miles away * **Stumptown Coffee** - 0.4 miles away * **Joe Coffee** - 0.6 miles away Would you like me to get directions to one of these for you? ``` **Prompt:** ``` What's the elevation at the top of Mount Whitney? ``` **Response:** ``` ### Elevation Data: Mount Whitney * **Peak Elevation:** 14,505 feet (4,421 meters) * **Location:** Sierra Nevada mountains, California * **Notes:** This is the highest point in the contiguous United States. ``` ## Capabilities ### Convert addresses to coordinates This tool turns human-readable addresses into the precise coordinates your agent needs for routing. ### Calculate multi-stop travel times This tool calculates the travel durations and distances between multiple source and destination pairs. ### Identify reachable areas This tool generates polygons showing the area reachable within a set time or distance. ### Search for nearby shops and landmarks This tool finds nearby places like restaurants or gas stations based on a category and location. ### Generate map images This tool creates a direct link for a map based on your desired zoom and dimensions. ### Get elevation for specific coordinates This tool returns the height of a specific coordinate for geographic research or hiking. ## Use Cases ### Delivery Route Optimization A logistics lead asks the agent to find the fastest route for 10 stops, and it uses get_distance_matrix to provide the best order. ### Real Estate Mapping A realtor asks to show all available properties within 20 minutes of a specific zip code, using get_isochrone. ### Hiking Trip Planning A traveler asks for the elevation profile of a trail, and the agent uses get_elevation to summarize the difficulty. ### Store Locator A developer wants to show the nearest 5 gas stations to a user's current location using search_nearby. ## Benefits - Automate geocoding: Use geocode to instantly turn thousands of addresses into usable coordinates without manual entry. - Optimize logistics: Use get_distance_matrix to calculate complex multi-stop delivery routes in seconds. - Visualize reach: Use get_isochrone to see exactly how far a delivery radius extends in different urban settings. - Simplify map display: Use get_static_map to get map images for your UI without needing to host your own tiles. - Instant local discovery: Use search_nearby to let your agent find nearby amenities for your users automatically. - Accurate travel data: Use get_directions to get real-world travel times for walking, cycling, and driving. ## How It Works The bottom line is that you get a full spatial engine that lets your agent understand and interact with the physical world. 1. Subscribe to the Mapbox MCP and enter your Mapbox Access Token. 2. Connect the Connector to your AI client like Claude or Cursor. 3. Ask your agent to perform tasks like geocoding or route planning. ## Frequently Asked Questions **Can the Mapbox MCP find addresses for me?** Yes, it can convert human-readable place names or street addresses into precise coordinates and structured data. **How does Mapbox MCP help with delivery routes?** It uses a distance matrix to calculate travel times and distances between multiple points, helping you find the most efficient route. **Can I use Mapbox MCP to see how far I can drive in 10 minutes?** Yes, the isochrone tool allows your agent to show you the reachable area within a specific time or distance. **Does Mapbox MCP provide images of maps?** It can generate direct links to static map images based on your specific zoom levels and dimensions. **Can Mapbox MCP find nearby gas stations?** Yes, your agent can search for specific categories like gas stations, hotels, or restaurants near any given location. **Is Mapbox MCP good for hiking?** It is excellent for hiking because it can provide elevation data for specific coordinates to help you plan your route. **How do I get a Mapbox Access Token?** Sign up for a free account at [**account.mapbox.com**](https://account.mapbox.com/access-tokens/), go to **Access Tokens** and create a new token. Copy the token — it starts with `pk.`. **Can I get driving directions?** Yes! Use get_directions with coordinates and the 'driving' profile. Returns route distance, duration, step-by-step instructions and geometry. Also supports 'walking' and 'cycling' profiles. **What are isochrones used for?** Isochrones show the area reachable within a specific time or distance from a location. Useful for delivery zones, commute analysis, real estate proximity and accessibility planning. **Can I calculate distances between multiple locations?** Yes! Use get_distance_matrix with multiple coordinate pairs. Returns a matrix of durations (seconds) and distances (meters) between all source-destination pairs. Supports driving, walking and cycling profiles.