# TomTom MCP for AI Agents AI Agent Connect > TomTom MCP gives your AI agent access to real-time traffic, precise geocoding, and route calculations. It connects your TomTom API account to your agent so you can query global mapping data, find points of interest, and analyze travel boundaries instantly. It's the quickest way to put enterprise-grade logistics data into your AI workflow. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_7vjdJOFrnN4TPRCBWqQyqMye9zt0MZBTZ3BqQjLC/ai-agent-connect - **Tags:** mapping, routing, geocoding, traffic-data, location-services, logistics ## Description The TomTom MCP connects your API account directly to your AI agent to give it enterprise-grade geospatial and logistical capabilities. Usually, figuring out the best way to move goods or people requires jumping between multiple maps and traffic reports. This Connector lets your agent handle those tasks in one go. You can ask it to turn messy street addresses into exact coordinates or find every gas station along a specific highway. It identifies live accidents and construction zones to help avoid delays. When you need to know how far a vehicle goes within a strict time window, the agent calculates those boundaries for you. It handles the heavy lifting of data processing so you can focus on the bigger picture. Instead of manually checking various apps, your agent provides instant answers about travel times, road conditions, and local points of interest. It works across the globe, making it a reliable source for any logistics or mapping project. The data is high-quality and updated in real-time, which is a huge win for anyone managing a fleet or building location-aware software. You can find this in the Vinkius catalog to get your agent up and running in minutes. ## Tools ### calculate_reachable_range Provide center coordinates and a time budget in seconds. This tells you the exact area reachable within that timeframe. ### calculate_route Provide two points to get a route summary and polyline. This shows the exact travel time and distance for a trip. ### search_poi_by_category Provide a category and a center coordinate to find nearby points of interest. This helps you find gas stations or hospitals in a specific area. ### fuzzy_geocoding Convert a physical address into coordinates using fuzzy matching. This handles typos and messy input from users. ### get_poi_details Provide a point of interest ID to retrieve rich metadata. This gives you contact info and opening hours for specific locations. ### get_traffic_incidents Provide min and max coordinates to find real-time traffic incidents. This helps you see accidents and construction in a specific area. ### get_traffic_flow_segment Provide center coordinates to see the traffic flow for a specific road. This shows you the current speed and quality of a street segment. ### reverse_geocoding Convert geographic coordinates into a physical address. This is useful for finding a street name when you only have a location. ### autocomplete_place_search Provide a partial string to get predictive location suggestions. This makes it easier for users to find addresses as they type. ### structured_geocoding Provide specific address components like zip codes and countries. This gives you high-precision geocoding for structured data. ## Prompt Examples **Prompt:** ``` Are there any accidents on the 405 freeway near downtown right now? ``` **Response:** ``` ### Real-Time Traffic Report I've scanned the 405 freeway area near downtown. Here is what I found: | Incident Type | Severity | Location | | :--- | :--- | :--- | | **Accident** | Major Delay | Near Downtown Exit | **Construction** | Moderate | 2 miles North **Summary:** Expect significant delays near the downtown exit due to a multi-vehicle collision. Construction is also slowing traffic 2 miles north. ``` **Prompt:** ``` How far can a truck get in 3 hours starting from the Port of Long Beach? ``` **Response:** ``` ### Reachable Range Calculation Based on a 3-hour travel budget from the Port of Long Beach, your vehicle can reach the following area: * **Estimated Distance:** ~180 miles * **Primary Coverage:** Covers most of the Los Angeles basin and parts of the Inland Empire. * **Boundary:** The reachable limit extends roughly to the Riverside area, depending on current traffic flow. ``` **Prompt:** ``` Find the nearest gas stations near 123 Main St, Austin, TX. ``` **Response:** ``` ### Nearby Fuel Stations I found the following gas stations near 123 Main St, Austin, TX: 1. **Shell Station** * Distance: 0.4 miles * Status: Open Now 2. **ExxonGo** * Distance: 0.8 miles * Status: Open Now 3. **Costco Gas** * Distance: 1.2 miles * Status: Open Now ``` ## Capabilities ### Convert addresses to coordinates Turn physical street addresses into exact latitude and longitude points. ### Calculate travel times Get precise distances and travel times for specific trips between two points. ### Identify real-time traffic See active accidents, road closures, and construction zones in a specific area. ### Find nearby points of interest Locate local services like gas stations, hospitals, or shops by category. ### Calculate reachable areas Determine the exact area a vehicle can reach within a specific time budget. ## Use Cases ### Real-time accident monitoring A dispatcher asks the agent to find any accidents on the I-95 within the last hour using `get_traffic_incidents`. ### Dynamic delivery window planning A manager asks how far a van can drive in 90 minutes from a specific warehouse using `calculate_route`. ### Automated store locator A developer wants to find all nearby hospitals for a new health app using `search_poi_by_category`. ### Mass address normalization A team provides a list of messy addresses for the agent to turn into coordinates. ## Benefits - Set realistic delivery windows by seeing how far a vehicle can travel in a set time with `calculate_reachable_range`. - Pull contact info and opening hours for specific locations using `get_poi_details`. - Check the current speed and quality of a specific road using `get_traffic_flow_segment`. - Get location suggestions as you start typing a partial address with `autocomplete_place_search`. - Get precise distance and travel time data for any trip without manual calculation. - Access real-time traffic data to avoid delays and road closures. ## How It Works The bottom line is your AI gets immediate access to global mapping and live traffic data. 1. Add the TomTom MCP to your AI client. 2. Get an API token from the TomTom Developer Portal. 3. Paste the key and start asking questions about maps and traffic. ## Frequently Asked Questions **Can the TomTom MCP find traffic accidents?** Yes, it pulls live traffic data to identify accidents, construction, and road closures in real-time. This helps you avoid delays automatically. **How does the TomTom MCP handle typos in addresses?** It uses fuzzy geocoding to understand messy input. Even if a user makes a small spelling mistake, the agent can still find the correct coordinates. **Can I use TomTom MCP to calculate delivery routes?** Yes, it provides precise travel times and distances between points. You can use this to plan efficient routes for any logistics operation. **Does the TomTom MCP work for international addresses?** It provides global mapping coverage. You can query coordinates and addresses for locations across the globe. **Can the TomTom MCP find nearby hospitals?** Yes, it can search for points of interest by category. You can ask it to find nearby hospitals, fuel stations, or other essential services. **How do I get my TomTom API key for this Connector?** You can get your key by signing up for a developer account on the TomTom Developer Portal. Once you have it, just paste it into your connection settings. **Where and how do I extract my TomTom API Key?** Log into your account at the `developer.tomtom.com` portal. Go to the dashboard console and select **Keys** (or My Dashboard). Either use your default developer API Key or click **Add new Key** for this specific agent usage. Copy the entire cryptographic string and insert it below securely. **Can the agent interact with or update the maps itself?** No. The integration exclusively lists and pulls read-only endpoints (timelines, distances, addresses). The AI agent leverages TomTom merely to process geographic conversions securely; it lacks parameters capable of feeding corruptions or modifying raw data maps. **Should I secure my TomTom API Key?** Yes. It is highly recommended to set a Domain Whitelist in your key management settings on the TomTom developer portal. This restricts the use of your key to specific domains, preventing unauthorized use or rate limit exhaustion.