# Jawg Maps MCP

> Jawg Maps MCP handles all professional geospatial data needs. Use it with your AI client to search specific addresses, calculate optimal routes for driving, biking, or walking, and compute complex distance matrices between any number of points. You can also determine the exact altitude profile along a path or map out areas reachable within a certain time limit.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** geocoding, routing, mapping, spatial-analysis, logistics, elevation-data, isochrones, gps

## Description

Need to figure out where things are or how long it takes to get there? This MCP lets your AI client take control of professional mapping services and geospatial analytics. Instead of opening multiple tabs or running complex queries in dedicated software, you talk to your agent naturally—and it does the heavy lifting.

For instance, if you're planning a supply run across five different warehouses, you don't have to manually calculate every leg of the journey. You simply ask for the distance matrix. The MCP computes travel times and distances between all origins and destinations simultaneously. Need to know the best walking path through a city? It calculates optimal routes supporting multiple waypoints and profiles. Even if your plan requires altitude data, you can get elevation profiles for specific coordinates or along that calculated route path. Accessing this level of detailed geographic intelligence is now built directly into conversation via Vinkius.

## Tools

### search_autocomplete
Predicts places or addresses as you type a search query, optionally focusing the results on a given GPS location.

### calculate_elevation_routing
Generates a calculated route path that includes detailed elevation profiles for every point along the way.

### get_path_elevation
Retrieves the specific altitude and elevation above sea level for coordinates you provide.

### calculate_distance_isochrone
Figures out the total area (in a polygon) reachable from one spot within a set distance limit, regardless of travel time.

### calculate_reachability_isochrone
Determines the size and shape of an area you can get to from a center point based on a specific maximum travel time.

### calculate_distance_matrix
Computes the total travel times and straight-line distances between multiple specified starting and ending points simultaneously.

### reverse_geocode
Takes raw GPS coordinates and converts them back into a complete, readable physical street address.

### calculate_routing_line
Calculates the optimal travel path between multiple waypoints that you specify in order.

### search_country_filter
Searches for locations and addresses while strictly limiting results to a specific country's borders.

### search_map_places
Finds matching places and addresses across the map using basic text search and returns their coordinates.

## Prompt Examples

**Prompt:** 
```
Find the physical address for coordinates 48.8566, 2.3522
```

**Response:** 
```
Resolving coordinates… That location corresponds to '2 Place de l'Hôtel de Ville, 75004 Paris, France'. It's categorized as a City Hall. Would you like to see nearby points of interest?
```

**Prompt:** 
```
Calculate a driving route from Paris to Lyon via Dijon
```

**Response:** 
```
Calculating route… The optimal path via A6 is approximately 465 km and will take about 4 hours and 20 minutes with standard traffic. I've included the waypoints for Dijon in the calculation. Would you like the turn-by-turn summary?
```

**Prompt:** 
```
Show me the elevation for these coordinates: 45.8326, 6.8651
```

**Response:** 
```
Retrieving elevation data… Those coordinates (near Mont Blanc) have an altitude of approximately 4,807 meters above sea level. Would you like to check the elevation profile for a path around this area?
```

## Capabilities

### Find addresses and points of interest
The MCP searches for places and addresses by text, allowing you to pinpoint exact locations or resolve GPS coordinates back to a physical address.

### Calculate optimal travel paths
It determines the best driving, biking, or walking routes between multiple coordinates while supporting intermediate waypoints.

### Analyze distance and time networks
You can compute massive tables showing travel times and distances between any set of starting points and ending points.

### Map out reachable zones
The MCP draws polygons to visualize areas you can reach, either by driving within a certain time limit or covering a specific distance.

### Retrieve altitude data for paths
It pulls the elevation above sea level for precise coordinates or along an entire planned route path.

## Use Cases

### Optimizing last-mile delivery routes
A logistics manager needs to calculate the total driving time and distance from a central depot to 15 different drop-off points. Instead of entering coordinates one by one, they ask the agent to use calculate_distance_matrix, getting an instant matrix showing the travel metrics for every pair.

### Analyzing city accessibility for new real estate
An urban researcher needs to know which neighborhoods are reachable within a 30-minute drive from a proposed commercial center. They prompt the agent to calculate_reachability_isochrone, getting a precise polygon map of viable areas.

### Troubleshooting GPS coordinates
A developer receives raw GPS coordinates (48.8566, 2.3522) and needs to know the actual street address for client billing. They use reverse_geocode and instantly get '2 Place de l'Hôtel de Ville, 75004 Paris, France'.

### Planning a multi-stage hiking trip
A field engineer needs to know the elevation changes along a proposed trail path. They prompt the agent using calculate_elevation_routing, which provides an entire altitude profile for accurate planning.

## Benefits

- You get accurate location data without manual lookups. Use search_map_places or reverse_geocode to immediately verify any physical address using simple text prompts.
- Stop estimating travel times. calculate_distance_matrix computes the full travel time and distance network between dozens of stops instantly, saving hours in spreadsheet work.
- Plan complex journeys with confidence. calculate_routing_line finds the single best path through multiple waypoints, supporting different modes like driving or biking.
- Analyze logistics coverage easily. The calculate_reachability_isochrone tool maps out exactly where your drivers can get by based on time constraints.
- Understand terrain changes before starting a route. Use get_path_elevation to see the altitude profile for coordinates, which is critical for mountaineering or civil engineering projects.

## How It Works

The bottom line is you get powerful mapping and logistics tools accessible via natural conversation, without needing to write boilerplate code or manage multiple APIs.

1. First, subscribe to this MCP and enter your Jawg Access Token credentials.
2. Next, connect your AI client (like Claude or Cursor) through the Vinkius platform.
3. Finally, ask your agent for a location-aware task—for example, 'What is the total travel time from Point A to Point Z?'—and the MCP executes the calculation.

## Frequently Asked Questions

**How does Jawg Maps calculate the optimal route using calculate_routing_line?**
calculate_routing_line determines the best path between multiple specified points. It handles the sequence and calculates the most efficient way to pass through all your given intermediate waypoints.

**Can I use Jawg Maps MCP for finding an address from coordinates?**
Yes, you can run reverse_geocode on any GPS coordinate pair. This tool takes raw numbers and converts them into a complete, readable physical street address.

**Does the MCP only calculate driving routes?**
No, it supports different transportation profiles. You can ask for optimal paths using biking or walking modes, not just vehicles.

**What is the difference between distance and reachability in Jawg Maps?**
Distance matrices calculate travel times and straight-line distances between points. Reachability calculates an area (isochrone) based on a maximum time or distance limit from one central point.

**How do I find places using search_map_places?**
You use the tool by providing text describing what you're looking for. It returns matching locations and their precise coordinates, letting you verify where exactly the place is.