# TomTom MCP for AI Agents AI Agent Connect

> TomTom. Access global mapping, geocoding, and routing services through your AI client. Search for addresses, calculate optimal routes for different vehicle types, and retrieve map tiles directly. It's the professional way to add spatial intelligence to your agent's capabilities.

## Overview
- **Category:** geocoding-maps
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Xrxr5LIZlRKrkiD0O6cEhbmSru3ATCKUFkDx7PiL/ai-agent-connect
- **Tags:** maps, routing, geocoding, navigation, location-services

## Description

TomTom brings professional-grade location intelligence to your AI client. You can ask your agent to figure out the best path for a fleet of delivery trucks or find the exact coordinates for a list of hundreds of retail spots. It handles the heavy lifting of spatial data, whether you're trying to visualize a specific area with map tiles or need to know which roads are currently backed up. Because it's hosted on the Vinkius catalog, you get a reliable way to bridge the gap between raw map data and actionable navigation. It's about moving from 'where is this' to 'how do I get there' without the manual clicking. You can get real-time traffic updates to avoid jams or use smart routing to plan complex journeys that account for vehicle size and specific road restrictions. It turns vague location queries into precise data points, making it a core tool for anyone managing physical movements or geographic data.

## Tools

### geocode
Convert addresses into geographic coordinates. Use this to turn text locations into precise map points.

### get_map_tile
Returns the URL to the tile image. This lets your agent provide a visual map for a specific location.

### fuzzy_search
Single-line fuzzy search for addresses and POIs. Use this to find places even when the user provides imperfect text.

### calculate_advanced_route
Plan complex trips with supporting points or avoid specific vignettes. This is useful for multi-stop logistics and avoiding restricted areas.

### calculate_route
Calculate a route between origin and destination. It provides the best path based on current travel conditions.

### get_traffic_incidents
Get real-time traffic incidents and flow information. This helps you see current road closures and heavy congestion.

## Prompt Examples

**Prompt:** 
```
Find the best way for a delivery van to get from downtown Chicago to O'Hare, avoiding the main highway.
```

**Response:** 
```
### Route Options for Delivery Van

I've calculated the best path from **Downtown Chicago** to **O'Hare International Airport** while avoiding the main highway as requested.

*   **Fastest Route:** 32 minutes | 18.4 miles
*   **Traffic Conditions:** Light to moderate
*   **Road Details:** This route uses secondary roads to bypass the main congestion points.

Would you like me to provide turn-by-turn directions for this route?
```

**Prompt:** 
```
I have a list of 5 coffee shops in Brooklyn. Give me their coordinates.
```

**Response:** 
```
I've found the coordinates for 5 popular coffee shops in the Brooklyn area:

| Coffee Shop | Address | Latitude | Longitude |
| :--- | :--- | :--- | :--- |
| **Sey Coffee** | 135 N 7th St | 40.7049 | -73.9910 |
| **Devoción** | 102 Greene St | 40.6937 | -73.9882 |
| **Blue Bottle** | 250 Court St | 40.7018 | -73.9953 |
| **Variety Coffee** | 210 Wyckoff Ave | 40.7351 | -73.9211 |
| **Toby's Coffee** | 402 Smith St | 40.6982 | -73.9825 |
```

**Prompt:** 
```
Is there any traffic on the I-95 right now?
```

**Response:** 
```
### Current Traffic Report: I-95

Here is the current status for the I-95 corridor:

*   **Status:** 🟠 Moderate Congestion
*   **Incidents:** 
    *   *Lane Closure:* Near Exit 24 due to construction.
    *   *Slowdown:* Heavy traffic reported near the merge point with I-495.
*   **Travel Time Impact:** Expect an additional 12-15 minutes of delay in the affected zones.

Do you want me to find an alternate route for you?
```

## Capabilities

### Find addresses with messy text
Search for locations using fuzzy queries that account for typos and partial names.

### Turn street names into coordinates
Convert a list of physical addresses into precise latitude and longitude points.

### Plan routes for different vehicles
Calculate paths based on specific vehicle profiles like trucks, cars, or bicycles.

### See real-time traffic jams
Get current traffic flow information and incident reports for specific roads.

### Grab map tile URLs
Fetch specific map image URLs based on zoom level and geographic coordinates.

## Use Cases

### Route a delivery fleet
A logistics lead asks the agent to plan a 10-stop route for a heavy truck avoiding specific tunnels. The agent uses `calculate_advanced_route` to provide the path.

### Bulk geocoding
A developer needs to turn a list of 500 stores into coordinates. The agent uses `geocode` to process the list.

### Traffic alerts
A driver wants to know if the main highway is clear. The agent uses `get_traffic_incidents` to check current flow.

### Fuzzy POI search
A user types 'Eifell Tower' and the agent uses `fuzzy_search` to find the correct location and coordinates.

## Benefits

- Get precise coordinates for any address using `geocode` to ensure your data is accurate.
- Avoid traffic jams by checking real-time road conditions with `get_traffic_incidents`.
- Plan truck-specific paths using `calculate_route` to avoid roads with weight limits.
- Handle complex multi-stop journeys with `calculate_advanced_route` for better logistics.
- Find locations quickly even with typos using `fuzzy_search` for a better user experience.
- Pull specific map images with `get_map_tile` to show users exactly where they are.

## How It Works

The bottom line is that you get professional navigation data without having to write any custom API code.

1. Get your TomTom API key from the developer portal.
2. Add this Connector to your AI client and enter your API key.
3. Ask your agent to find a route, geocode an address, or check traffic.

## Frequently Asked Questions

**Can TomTom MCP find specific businesses?**
Yes, the Connector can search for points of interest and specific businesses using flexible text queries that handle typos and partial names.

**Does it support routing for heavy trucks?**
Yes, it includes vehicle-specific routing. You can specify vehicle types like trucks to ensure the AI agent avoids roads with weight or height restrictions.

**Can I get map images for my app?**
Yes, it can provide URLs for specific map tiles. This allows your agent to fetch visual map data for specific zoom levels and locations.

**How accurate is the geocoding?**
It provides high-precision geocoding, converting physical street addresses into exact latitude and longitude coordinates for professional use.

**Does it provide real-time traffic?**
Yes, the Connector retrieves real-time traffic incidents and flow information to help you identify current road closures and heavy congestion.

**Can I use it to avoid specific roads?**
Yes, it supports advanced routing. You can ask your agent to plan a path that avoids specific vignettes or restricted areas.

**Can I search for a place using just a name like 'Coffee Shop'?**
Yes! Use the `fuzzy_search` tool. It allows you to search for points of interest, streets, and addresses using free-text queries.

**Does the routing tool take real-time traffic into account?**
Yes, by default the `calculate_route` tool uses real-time traffic data to provide the most accurate travel times and paths.

**How can I get the latitude and longitude for a specific address?**
You can use the `geocode` tool. Simply provide the address string, and it will return the geographic coordinates.