# LocationIQ MCP for AI Agents AI Agent Connect

> LocationIQ (Geocoding & Maps) lets you turn messy addresses into exact coordinates and plan complex routes using natural language. It handles geocoding, reverse geocoding, and distance matrices to help you build location-aware apps without the headache of complex GIS tools.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_guvJJkDc8PrT9hGQJetyuZhi2wlRTWf0DhaRoJ1x/ai-agent-connect
- **Tags:** geocoding, routing, reverse-geocoding, location-intelligence, maps-api

## Description

This Connector lets you manage affordable geocoding and geospatial intelligence through natural conversation. Instead of wrestling with complex GIS software or writing dozens of lines of boilerplate code to handle map data, you can just ask your AI client to do the work. It turns messy address strings into precise GPS coordinates and handles the calculation of optimal driving, walking, or cycling paths between multiple stops. It's built for people who need to know where things are and how to get there. You can use it to convert latitude and longitude back into human-readable addresses, snap shaky GPS signals to the nearest street network, or filter search results to specific countries and geographic boxes. If you're building a delivery app, a logistics dashboard, or a real estate platform, this connection gives your agent the ability to reason about physical locations. You can even check your remaining request balance directly through the chat, keeping your operations running smoothly without leaving your current workspace. It brings production-ready location data into your AI workflow, whether you're cleaning a dataset or building a live navigation tool. By connecting this to your workflow through the Vinkius catalog, you get a way to turn your AI into a geospatial expert that can handle logistics, mapping, and location intelligence on the fly.

## Tools

### calculate_directions
Find the best driving, walking, or cycling path between two points. It provides clear navigation instructions.

### search_autocomplete
Get a list of suggested locations from partial text queries. This helps users find addresses faster.

### check_account_balance
See how many OpenStreetMap queries you have left in your account. This keeps your operations running smoothly.

### calculate_distance_matrix
Create a table of travel times and distances for multiple origins and destinations. This is great for logistics.

### snap_nearest_roads
Force a coordinate to align perfectly with the nearest street network. It fixes shaky GPS data for better tracking.

### reverse_geocode
Turn a latitude and longitude into a human-readable street address. It's perfect for identifying locations from coordinates.

### reverse_language_bias
Convert coordinates into addresses using specific local language tags. This helps with international data.

### search_geocode
Convert a specific address string into precise GPS coordinates. It's the core tool for turning text into map data.

### search_bounding_box
Find locations that fall within a specific rectangular map area. Use this to limit searches to a specific city or region.

### search_country_filter
Restrict location searches to specific country codes. This ensures your agent only returns relevant regional data.

## Prompt Examples

**Prompt:** 
```
Find the coordinates for the 'Eiffel Tower' in Paris
```

**Response:** 
```
**Location Found:**

*   **Name:** Eiffel Tower
*   **Coordinates:** Latitude 48.8584, Longitude 2.2945
*   **Address:** 5 Avenue Anatole France, 75007 Paris, France

Would you like me to find nearby hotels?
```

**Prompt:** 
```
What's the best driving route from Lisbon to Porto?
```

**Response:** 
```
**Route Details:**

*   **Optimal Route:** Via A1
*   **Distance:** ~312 km
*   **Estimated Time:** 2 hours and 55 minutes (current traffic)

I can provide the detailed turn-by-turn instructions if you'd like.
```

**Prompt:** 
```
Check my remaining LocationIQ request balance
```

**Response:** 
```
**Account Status:**

| Metric | Value |
| :--- | :--- |
| **Remaining Requests** | 4,850 |
| **Daily Limit** | 5,000 |
| **Status** | Good Standing |

Would you like me to perform any more geocoding lookups?
```

## Capabilities

### Convert addresses to GPS coordinates
Turn a text address into precise latitude and longitude points.

### Turn coordinates into street addresses
Convert GPS points back into human-readable street names and postal data.

### Plan multi-stop routes
Calculate the best driving, walking, or cycling paths between several locations.

### Build travel time tables
Generate distance and duration matrices for multiple origins and destinations.

### Snap GPS signals to roads
Align messy coordinate data to the actual street network for accurate tracking.

### Filter results by region
Restrict location searches to specific countries or geographic bounding boxes.

## Use Cases

### Delivery Route Optimization
A logistics manager asks the agent to find the fastest route for 10 stops. The agent uses calculate_directions to provide the best path.

### Real Estate Mapping
A developer wants to find all properties within a specific city. They use search_bounding_box to filter results to a map rectangle.

### Ride-Share Pickup
A user types a partial address. The agent uses search_autocomplete to show a list of suggestions for the user to pick from.

### Fleet Tracking Correction
A manager sees a truck off-road on a map. They ask the agent to snap the coordinates to the nearest roads using snap_nearest_roads.

## Benefits

- Get precise coordinates instantly using search_geocode to eliminate manual data entry for your datasets.
- Build multi-stop delivery schedules by calculating travel times with calculate_distance_matrix.
- Improve fleet tracking accuracy by using snap_nearest_roads to fix shaky GPS data from mobile devices.
- Handle international shipping easily with reverse_language_bias for localized addresses in different regions.
- Save on development time by using search_autocomplete for real-time search suggestions in your custom apps.
- Stay within budget by monitoring your request limits with check_account_balance directly through your agent.

## How It Works

The bottom line is you get production-ready geospatial data through a simple conversation with your agent.

1. Connect your LocationIQ API key to the Connector.
2. Ask your AI client to perform a location task like geocoding or routing.
3. Get back precise coordinates, route instructions, or distance tables.

## Frequently Asked Questions

**How can I use LocationIQ to find coordinates for addresses?**
You can simply ask your agent to find the coordinates for any street address. It will use the geocoding tools to return the exact latitude and longitude for you.

**Can LocationIQ help with delivery route planning?**
Yes. It can calculate the best driving, walking, or cycling paths between multiple stops and even provide travel time tables for entire fleets.

**How do I get street addresses from GPS coordinates?**
You can use the reverse geocoding feature. Just give your agent a set of coordinates, and it will return the human-readable street address and postal data.

**Can I filter location searches by country?**
Yes, the Connector supports country filters. This ensures that your agent only returns results from specific countries when you are performing a search.

**How does LocationIQ handle road snapping for fleet tracking?**
It aligns shaky GPS pings to the actual street network. This makes it much easier to see exactly which road a vehicle is on for more accurate tracking.

**Can I check my API balance using an AI agent?**
Yes, you can ask your agent to check your remaining request balance at any time. It will pull the latest data from your account so you can monitor your usage.

**Can I convert GPS coordinates back to a physical address using my agent?**
Yes. Use the `reverse_geocode` tool by providing the latitude and longitude. Your agent will return the human-readable address, including the house number, street, city, and postal code.

**How do I calculate the travel time between multiple points?**
The `calculate_distance_matrix` tool allows you to submit a list of coordinates. Your agent will return a duration table for the specified profile (driving or walking), helping you optimize multi-stop routes.

**Can my agent check how many API requests I have remaining?**
Absolutely. Use the `check_account_balance` tool to retrieve your current credit status. Your agent will report exactly how many OpenStreetMap queries remain for your API key during the current period.