# Tomtom — how to use (mcp.ai)

Connect your Tomtom account and use 82 tools for developer tools straight from your AI agent. Connect with your own API key. TomTom provides a suite of location-based services and APIs, including mapping, routing, traffic information, and geofencing, enabling developers to integrate advanced navigation and location functionalities into their applications.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_tomtom?ms=1787293380000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `tomtom_assets_list_fonts`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/tomtom`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/tomtom/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/tomtom/assets/list/fonts` — Tool to list available font asset versions for map rendering. Call after confirming the API key is valid.
- `POST https://api.mcp.ai/api/tomtom/assets/list/sprites` — Tool to list available sprites for a given asset version. Use after determining the assetVersion.
  - body: { key: string, apiVersion?: string, assetVersion: string, assetCategories?: string[] }
- `POST https://api.mcp.ai/api/tomtom/assets/list/styles` — Tool to list available map styles. Use after selecting an asset version to retrieve style options.
  - body: { apiVersion: string, assetVersion: string, assetCategories?: string[] }
- `POST https://api.mcp.ai/api/tomtom/calculate/long/distance/ev/route` — Tool to calculate long-distance electric vehicle routes with optimal charging stops. Use when planning EV trips that require charging along the route.
  - body: { traffic?: boolean, locations: string, routeType?: string, travelMode?: string, maxChargeInkWh?: number, vehicleEngineType?: string, chargingParameters?: object, currentChargeInkWh: number, minChargeAtDestinationInkWh: number, minChargeAtChargingStopsInkWh: number, constantSpeedConsumptionInkWhPerHundredkm: string }
- `POST https://api.mcp.ai/api/tomtom/calculate/matrix/routing/sync` — Tool to calculate route matrix synchronously for multiple origins and destinations (up to 200 cells). Use when you need travel times and distances between multiple location pairs with support for traf
  - body: { options?: object, origins: object[], destinations: object[] }
- `POST https://api.mcp.ai/api/tomtom/calculate/reachable/range` — Tool to calculate the reachable range from a starting point given time, fuel, or energy constraints. Use when you need to determine how far a vehicle can travel from an origin within specified budgets
  - body: { avoid?: string, origin: string, report?: string, traffic?: boolean, callback?: string, arrive_at?: string, depart_at?: string, hilliness?: string, route_type?: string, travel_mode?: string, windingness?: string, content_type?: string, request_body?: object, vehicle_width?: number, vehicle_height?: number, vehicle_length?: number, vehicle_weight?: integer, uphill_efficiency?: number, vehicle_load_type?: string, vehicle_max_speed?: integer, time_budget_in_sec?: number, vehicle_commercial?: boolean, downhill_efficiency?: number, vehicle_axle_weight?: integer, vehicle_engine_type?: string, energy_budget_in_kwh?: number, fuel_budget_in_liters?: number, current_fuel_in_liters?: number, acceleration_efficiency?: number, deceleration_efficiency?: number, auxiliary_power_in_liters_per_hour?: number, fuel_energy_density_in_mjoules_per_liter?: number, constant_speed_consumption_in_kwh_per_hundredkm?: string, constant_speed_consumption_in_liters_per_hundredkm?: string }
- `POST https://api.mcp.ai/api/tomtom/calculate/route` — Tool to calculate driving routes. Use when you need directions with optional waypoints and traffic consideration.
  - body: { end: string, avoid?: string, start: string, report?: string, traffic?: boolean, language?: string, arrive_at?: string, depart_at?: string, waypoints?: string, route_type?: string, travel_mode?: string, section_type?: string, instructions_type?: string }
- `POST https://api.mcp.ai/api/tomtom/calculate/route/with/body` — Tool to calculate routes with advanced options via POST request. Use when you need to specify supporting points, avoid specific geographic areas, or configure vignette preferences.
  - body: { avoid?: string, report?: string, traffic?: boolean, arriveAt?: string, callback?: string, departAt?: string, language?: string, hilliness?: string, locations: string, routeType?: string, travelMode?: string, contentType?: string, requestBody?: object, sectionType?: string, windingness?: string, vehicleWidth?: number, vehicleHeight?: number, vehicleLength?: number, vehicleWeight?: integer, versionNumber?: integer, vehicleHeading?: integer, alternativeType?: string, maxAlternatives?: integer, vehicleLoadType?: string, vehicleMaxSpeed?: integer, computeBestOrder?: boolean, instructionsType?: string, minDeviationTime?: integer, uphillEfficiency?: number, vehicleAxleWeight?: integer, vehicleCommercial?: boolean, vehicleEngineType?: string, downhillEfficiency?: number, currentFuelInLiters?: number, routeRepresentation?: string, computeTravelTimeFor?: string, minDeviationDistance?: integer, accelerationEfficiency?: number, decelerationEfficiency?: number, auxiliaryPowerInLitersPerHour?: number, fuelEnergyDensityInMJoulesPerLiter?: number, constantSpeedConsumptionInkWhPerHundredkm?: string, constantSpeedConsumptionInLitersPerHundredkm?: string }
- `POST https://api.mcp.ai/api/tomtom/category/search` — Tool to search for Points of Interest by category. Use when you need to find POIs within a specific category around a location or area.
  - body: { ext?: string, lat?: number, lon?: number, ofs?: integer, bbox?: string, view?: string, limit?: integer, idxSet?: string, radius?: integer, category: string, language?: string, countrySet?: string }
- `POST https://api.mcp.ai/api/tomtom/create/notifications/groups` — Tool to create a contact group for TomTom notifications. Use when you need to set up a group of webhooks or emails to receive notification alerts.
  - body: { name?: string, emails?: string[], webhookUrls?: string[] }
- `POST https://api.mcp.ai/api/tomtom/create/routing/batch` — Tool to submit asynchronous batch routing requests to TomTom API. Use when you need to calculate multiple routes efficiently in a single batch operation. The API returns a batch ID that can be used to
  - body: { batchItems: object[], redirectMode?: string, waitTimeSeconds?: integer }
- `POST https://api.mcp.ai/api/tomtom/create/routing/batch/sync` — Tool to execute synchronous batch routing requests for multiple routes or reachable ranges. Use when you need to calculate multiple routes or reachable ranges in a single API call (max 100 items).
  - body: { batchItems: object[] }
- `POST https://api.mcp.ai/api/tomtom/create/routing/matrix/async` — Tool to submit asynchronous matrix routing calculation between multiple origins and destinations. Use when you need to calculate travel times and distances for large matrices (returns immediately with
  - body: { options?: object, origins: object[], destinations: object[] }
- `POST https://api.mcp.ai/api/tomtom/create/routing/waypointoptimization` — Tool to optimize the sequence of waypoints to find the fastest route. Use when you need to find the optimal order to visit multiple locations (2-12 waypoints) with optional time windows and service ti
  - body: { options?: object, waypoints: object[] }
- `POST https://api.mcp.ai/api/tomtom/create/search/geometryfilter` — Tool to filter POIs by geometric boundaries (circles or polygons). Use when you need to check which POIs from a list fall within specific geographic areas. Supports up to 50 POIs per request.
  - body: { ext?: string, poiList: object[], geometryList: object[] }
- `POST https://api.mcp.ai/api/tomtom/create/snap/to/roads` — Tool to snap GPS track points to the road network, correcting for GPS inaccuracies. Use when you need to match raw GPS coordinates to actual roads for route reconstruction or map matching.
  - body: { points: object[], versionNumber?: string }
- `POST https://api.mcp.ai/api/tomtom/create/snap/to/roads/batch` — Tool to submit asynchronous batch snap to roads requests to TomTom API. Use when you need to snap multiple GPS traces to the road network efficiently. The API returns a batch ID that can be used to re
  - body: { batchItems: object[] }
- `POST https://api.mcp.ai/api/tomtom/delete/notifications/history` — Tool to clear the entire notifications history for the account. Use when you need to delete all historical notification records. This is an asynchronous operation that returns a PROCESSING status imme
- `POST https://api.mcp.ai/api/tomtom/download/batch/search/async` — Tool to download results of an asynchronous batch search job. Use when you have a batch ID from a previous batch submission and need to retrieve the search results. Returns HTTP 202 if still processin
  - body: { batchId: string, waitTimeSeconds?: integer }
- `POST https://api.mcp.ai/api/tomtom/download/matrix/routing/async/result` — Tool to download results of asynchronous matrix routing job. Use when you need to retrieve completed matrix routing results using the job ID from a previous async matrix submission.
  - body: { jobId: string }
- `POST https://api.mcp.ai/api/tomtom/download/snap/to/roads/async/result` — Tool to download results of asynchronous snap to roads batch job. Use when you need to retrieve completed snap to roads results using the job ID from a previous async batch submission. Returns batch i
  - body: { jobId: string }
- `POST https://api.mcp.ai/api/tomtom/ev/charging/stations/available` — Tool to retrieve EV charging station availability info. Use when you have the chargingAvailability ID (from POI search dataSources) to get live availability.
  - body: { maxPowerKW?: number, minPowerKW?: number, connectorSet?: string, chargingAvailability: string }
- `POST https://api.mcp.ai/api/tomtom/flow/segment/data` — Tool to retrieve traffic flow data for a specific road segment. Use when you need current and free flow speeds for given coordinates.
  - body: { unit?: string, zoom: integer, point: string, style: string, format: string, openLr?: boolean }
- `POST https://api.mcp.ai/api/tomtom/fuzzy/search` — Tool to perform a fuzzy search for addresses and points of interest. Use when you need flexible matching on free-form location queries.
  - body: { lat?: number, lon?: number, ofs?: integer, view?: string, limit?: integer, query: string, idxSet?: string, radius?: integer, geobias?: string, brandSet?: string, language?: string, countrySet?: string, minPowerKW?: integer, boundingBox?: string, categorySet?: string, relatedPois?: string, categoryType?: string, connectorSet?: string, openingHours?: string, entityTypeSet?: string, politicalView?: string }
- `POST https://api.mcp.ai/api/tomtom/geocode/query` — Tool to convert a free-form address query into geographic coordinates. Use when you need to geocode an address string without structured fields.
  - body: { ext?: string, lat?: number, lon?: number, ofs?: integer, view?: string, limit?: integer, query: string, radius?: integer, topLeft?: string, btmRight?: string, language?: string, typeahead?: boolean, countrySet?: string, storeResult?: boolean, extendedPostalCodesFor?: string }
- `POST https://api.mcp.ai/api/tomtom/get/autocomplete` — Tool to get search suggestions as user types a query. Use when you need autocomplete suggestions for partial search input based on recognized entities like brands, categories, or locations.
  - body: { lat?: number, lon?: number, limit?: integer, query: string, radius?: integer, language: string, resultSet?: string, countrySet?: string }
- `POST https://api.mcp.ai/api/tomtom/get/copyrights` — Tool to retrieve copyright information for TomTom map tiles. Use when you need to display attribution or copyright notices for map content.
- `POST https://api.mcp.ai/api/tomtom/get/geometry/search` — Tool to search for POIs and locations within specified geometric areas (circles or polygons). Use when you need to find places within custom-defined boundaries.
  - body: { limit?: integer, query: string, idxSet?: string, language?: string, geometryList?: string, extendedPostalCodesFor?: string }
- `POST https://api.mcp.ai/api/tomtom/get/hillshade/tile` — Tool to retrieve hillshade terrain map tiles for specified coordinates and zoom. Use when you need terrain elevation shading overlays for map visualization.
  - body: { x: integer, y: integer, z: integer, style?: string }
- `POST https://api.mcp.ai/api/tomtom/get/incident/viewport` — Tool to retrieve incident viewport information including Traffic Model ID. Use when you need the current traffic model ID for a map viewport to make subsequent traffic API calls.
  - body: { copyright: boolean, bounding_box: string, content_type: string, overview_box: string, bounding_zoom: integer, overview_zoom: integer }
- `POST https://api.mcp.ai/api/tomtom/get/map/copyrights/bounding/box` — Tool to retrieve copyright information for a geographic bounding box. Use when you need attribution for a specific map area defined by coordinates.
  - body: { format?: string, max_lat: number, max_lon: number, min_lat: number, min_lon: number, callback?: string }
- `POST https://api.mcp.ai/api/tomtom/get/map/copyrights/caption` — Tool to retrieve the copyright caption text for TomTom maps. Use when you need to display attribution or copyright notices on map displays.
  - body: { format?: string, callback?: string, versionNumber?: integer }
- `POST https://api.mcp.ai/api/tomtom/get/map/copyrights/format` — Tool to retrieve copyright information for the whole world in the Maps API Raster Tile Service. Use when you need global copyright data for map display attribution.
  - body: { format?: string, callback?: string, version_number?: integer }
- `POST https://api.mcp.ai/api/tomtom/get/map/style/metadata` — Tool to retrieve map style metadata. Use to get a list of available map style resources. Returns available style files like flow styles and incident styles.
  - body: { resourceVariant?: string, resourceVersion?: string }
- `POST https://api.mcp.ai/api/tomtom/get/map/styles` — Tool to retrieve map style metadata as a Mapbox Style Specification JSON. Use to get a merged style definition combining map, traffic, and POI components for vector map rendering.
  - body: { map?: string, poi?: string, version: string, traffic_flow?: string, traffic_incidents?: string }
- `POST https://api.mcp.ai/api/tomtom/get/maps/orbis/map/tile` — Tool to retrieve Orbis map tiles at specified zoom level and coordinates. Use when you need high-quality map tiles for custom map rendering. Supports both raster (PNG) and vector (PBF) tile formats.
  - body: { x: integer, y: integer, z: integer, view?: string, style?: string, format?: string, language?: string, tileSize?: integer, apiVersion?: integer }
- `POST https://api.mcp.ai/api/tomtom/get/maps/orbis/traffic/tile` — Tool to retrieve Orbis Traffic Incident Tiles containing traffic incident data in Protocol Buffer format. Use when you need detailed traffic incident information for a specific tile coordinate at a gi
  - body: { x: integer, y: integer, z: integer, tags?: string[], language?: string, apiVersion?: string, categoryFilter?: string, trafficModelId?: string, roadCategoryFilter?: string, timeValidityFilter?: string }
- `POST https://api.mcp.ai/api/tomtom/get/notifications/groups/groupid` — Tool to retrieve details of a specific contact group by its UUID. Use when you need to get the name, webhook URLs, and email addresses associated with a contact group.
  - body: { groupId: string }
- `POST https://api.mcp.ai/api/tomtom/get/notifications/history` — Tool to retrieve notifications history from TomTom. Use when you need to list past notifications sent within a specific time range (must be less than 24 hours).
  - body: { to?: string, from: string, maxResults?: integer, pageNumber?: integer }
- `POST https://api.mcp.ai/api/tomtom/get/notifications/settings` — Tool to retrieve current notification settings. Use when you need to check notification configuration options.
- `POST https://api.mcp.ai/api/tomtom/get/orbis/geocode` — Tool to geocode addresses using TomTom's Orbis Maps API. Use when converting address queries to geographic coordinates.
  - body: { lat?: number, lon?: number, ofs?: integer, limit?: integer, query: string, radius?: integer, language?: string, apiVersion?: string, countrySet?: string }
- `POST https://api.mcp.ai/api/tomtom/get/orbis/places/autocomplete` — Tool to get autocomplete suggestions for place searches using TomTom Orbis Maps. Use when you need to recognize entities (brands, categories, locations) in a query and offer them as structured search 
  - body: { lat?: number, lon?: number, limit?: integer, query: string, radius?: integer, language: string, resultSet?: string, apiVersion?: string, countrySet?: string }
- `POST https://api.mcp.ai/api/tomtom/get/orbis/structured/geocode` — Tool to convert structured address fields into geographic coordinates using TomTom Orbis Maps API. Use when you have structured address components and need precise geocoding.
  - body: { ofs?: integer, view?: string, limit?: integer, language?: string, mapcodes?: string, apiVersion?: string, postalCode?: string, streetName?: string, countryCode: string, crossStreet?: string, municipality?: string, streetNumber?: string, entityTypeSet?: string, countrySubdivision?: string, extendedPostalCodesFor?: string, municipalitySubdivision?: string, countryTertiarySubdivision?: string, countrySecondarySubdivision?: string }
- `POST https://api.mcp.ai/api/tomtom/get/orbis/traffic/flow/tile` — Tool to retrieve Orbis traffic flow tile data in Protocol Buffer format. Use when you need traffic flow information for a specific map tile coordinate.
  - body: { x: integer, y: integer, z: integer, tags?: string, format?: string, apiVersion?: string, roadCategoryFilter?: string }
- `POST https://api.mcp.ai/api/tomtom/get/orbis/traffic/incident/details` — Tool to retrieve detailed Orbis traffic incidents by bounding box or IDs. Use when you need comprehensive incident data including events, delays, and geometry.
  - body: { t?: string, ids?: string, bbox?: string, fields?: string, language?: string, apiVersion?: string, categoryFilter?: string, timeValidityFilter?: string }
- `POST https://api.mcp.ai/api/tomtom/get/routing/batch` — Tool to download asynchronous batch routing results. Use when you need to retrieve the results of a previously submitted batch routing request using its batch ID. Returns HTTP 202 if processing is sti
  - body: { batchId: string, waitTimeSeconds?: integer }
- `POST https://api.mcp.ai/api/tomtom/get/routing/matrix/async/status` — Tool to check the status of an asynchronous matrix routing job. Use when you need to poll the status of a previously submitted matrix routing request to determine if it's still processing, completed s
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/tomtom/get/satellite/tile` — Tool to retrieve satellite imagery map tiles at specified coordinates and zoom. Use when you need high-resolution satellite imagery for mapping applications.
  - body: { x: integer, y: integer, z: integer, style?: string }
- `POST https://api.mcp.ai/api/tomtom/get/snap/to/roads/batch/status` — Tool to check the status of an asynchronous Snap to Roads batch job. Use when you need to poll the status of a previously submitted snap to roads batch request to determine if it's still processing or
  - body: { batch_id: string }
- `POST https://api.mcp.ai/api/tomtom/get/traffic/flow/tiles/raster` — Tool to retrieve raster traffic flow map tiles for visualization. Use when you need to display real-time traffic flow conditions on a map.
  - body: { x: integer, y: integer, z: integer, style: string, tileSize?: integer, thickness?: integer }
- `POST https://api.mcp.ai/api/tomtom/get/traffic/incident/details` — Tool to retrieve traffic incident details within a bounding box at a specified zoom level. Use when you need detailed incident information for map rendering or traffic analysis.
  - body: { zoom: integer, style: string, format?: string, language?: string, geometries?: string, projection?: string, bounding_box: string, expand_cluster?: boolean, traffic_model_id: string, original_position?: boolean }
- `POST https://api.mcp.ai/api/tomtom/get/traffic/incident/tile` — Tool to retrieve raster traffic incident map tiles showing traffic incidents at specified coordinates and zoom. Use when you need visual overlay of traffic incidents for custom map rendering.
  - body: { x: integer, y: integer, z: integer, style: string, format?: string, tileSize?: integer, traffic_model_id?: string }
- `POST https://api.mcp.ai/api/tomtom/get/traffic/incident/viewport` — Tool to retrieve traffic incidents within a viewport defined by bounding box and zoom level. Use when you need incident data for a specific map view with overview context.
  - body: { copyright: boolean, bounding_box: string, content_type: string, overview_box: string, bounding_zoom: integer, overview_zoom: integer }
- `POST https://api.mcp.ai/api/tomtom/list/geofencing/alert/rules` — Tool to list geofencing alert rules with optional filtering. Use when you need to retrieve configured alert rules for projects, fences, or objects.
  - body: { fence?: string, object?: string, enabled?: string, project?: string, alertType?: string, maxResults?: integer, pageNumber?: integer, notificationGroup?: string }
- `POST https://api.mcp.ai/api/tomtom/list/geofencing/alerts/history` — Tool to retrieve geofencing alert history within a specified time range. Use when you need to query past alerts triggered by geofencing rules.
  - body: { to: string, from: string, alertType?: string, maxResults?: integer, pageNumber?: integer }
- `POST https://api.mcp.ai/api/tomtom/list/geofencing/objects` — Tool to list all tracked objects in the TomTom Geofencing system. Use when you need to retrieve all objects currently being tracked for geofencing operations.
- `POST https://api.mcp.ai/api/tomtom/list/location/history/objects` — Tool to list objects with location history. Use when you need to retrieve all objects being tracked for location history.
- `POST https://api.mcp.ai/api/tomtom/list/notification/groups` — Tool to list notification contact groups. Use when you need to retrieve available contact groups for notifications. Note: This service will be decommissioned on January 31, 2027.
  - body: { maxResults?: integer, pageNumber?: integer }
- `POST https://api.mcp.ai/api/tomtom/list/poi/categories` — Tool to retrieve all POI categories supported by TomTom Search API. Use when you need the complete list of category IDs and names for searching POIs.
  - body: { language?: string }
- `POST https://api.mcp.ai/api/tomtom/list/sprite/versions` — Tool to list available sprite asset versions. Use when you need to know which sprite versions are available after obtaining a valid API key.
- `POST https://api.mcp.ai/api/tomtom/map/display/copyrights` — Tool to retrieve copyright information for a specific map tile. Use when you need to display or verify attribution for a given tile.
  - body: { x: integer, y: integer, zoom: integer }
- `POST https://api.mcp.ai/api/tomtom/map/display/raster/tile` — Tool to retrieve a raster map tile for specified coordinates and zoom. Use when you need direct tile image data for custom map rendering.
  - body: { X: integer, Y: integer, view?: string, zoom: integer, layer?: string, style?: string, format?: string, language?: string, tileSize?: integer }
- `POST https://api.mcp.ai/api/tomtom/map/display/static/image` — Tool to fetch a static map snapshot given center coords and zoom. Use when you need a standalone map image for display.
  - body: { bbox?: string, view?: string, zoom?: integer, layer?: string, style?: string, width?: integer, center?: string, format?: string, height?: integer, markers?: string, language?: string, tileSize?: integer }
- `POST https://api.mcp.ai/api/tomtom/map/display/wms/get/map` — Tool to retrieve a map image via WMS GetMap. Use when you need georeferenced map layers for custom rendering.
  - body: { crs?: string, srs?: string, bbox: string, time?: string, width: integer, format: string, height: integer, layers: string, styles?: string, bgcolor?: string, request: string, service: string, version: string, elevation?: string, exceptions?: string, transparent?: boolean }
- `POST https://api.mcp.ai/api/tomtom/matrix/routing` — Tool to calculate travel time and distance matrix between multiple locations. Use when you require a matrix of travel times and distances between multiple origins and destinations.
  - body: { options?: object, origins: object[], destinations: object[] }
- `POST https://api.mcp.ai/api/tomtom/nearby/search` — Tool to find Points of Interest near a specified location. Use after confirming coordinates to discover nearby POIs.
  - body: { lat: number, lon: number, limit?: integer, radius?: integer, brandSet?: string, countrySet?: string, minPowerKW?: integer, categorySet?: string, connectorSet?: string }
- `POST https://api.mcp.ai/api/tomtom/patch/notifications/groups/groupid` — Tool to partially update a contact group in TomTom Notifications API. Use when you need to edit the name, webhook URLs, or email addresses of an existing contact group.
  - body: { name?: string, emails?: string[], group_id: string, webhook_urls?: string[] }
- `POST https://api.mcp.ai/api/tomtom/points/of/interest/search` — Tool to search for points of interest by query. Use when you need POI suggestions by name or category.
  - body: { lat?: number, lon?: number, ofs?: integer, view?: string, limit?: integer, query: string, idxSet?: string, radius?: integer, fuelSet?: string, brandSet?: string, language?: string, timeZone?: boolean, typeahead?: boolean, countrySet?: string, entityType?: string, categorySet?: string, relatedPois?: string, categoryBias?: string, connectorSet?: string, openingHours?: string, maxFuzzyLevel?: integer, minFuzzyLevel?: integer }
- `POST https://api.mcp.ai/api/tomtom/reverse/geocode` — Tool to convert geographic coordinates into a human-readable address. Use when you need to obtain address information from latitude and longitude values.
  - body: { lat: number, lon: number, number?: string, radius?: integer, language?: string, entityType?: string, returnRoadUse?: boolean, returnSpeedLimit?: boolean, allowFreeformNewline?: boolean }
- `POST https://api.mcp.ai/api/tomtom/reverse/geocode/cross/street` — Tool to find the nearest cross street or intersection for given geographic coordinates. Use when you need to identify street intersections near a specific latitude/longitude position.
  - body: { ext?: string, limit?: integer, radius?: integer, heading?: number, language?: string, position: string, spatialKeys?: boolean }
- `POST https://api.mcp.ai/api/tomtom/reverse/geocode/orbis` — Tool to convert geographic coordinates into a human-readable address using TomTom's Orbis Maps API. Use when you need detailed address information from latitude and longitude values with Orbis data co
  - body: { view?: string, radius?: integer, heading?: number, language?: string, position: string, entityType?: string, returnMatchType?: boolean, returnRoadClass?: string, returnSpeedLimit?: boolean }
- `POST https://api.mcp.ai/api/tomtom/search/along/route` — Tool to search for Points of Interest along a specified route with detour time constraints. Use when you need to find POIs (restaurants, gas stations, hotels) accessible from a planned route.
  - body: { view?: string, limit?: integer, query: string, route: object, sortBy?: string, fuelSet?: string, brandSet?: string, language?: string, mapcodes?: string, timeZone?: string, typeahead?: boolean, apiVersion?: string, maxPowerKW?: number, minPowerKW?: number, categorySet?: string, connectorSet?: string, detourOffset?: boolean, openingHours?: string, maxDetourTime: integer, spreadingMode?: string, vehicleTypeSet?: string }
- `POST https://api.mcp.ai/api/tomtom/search/along/route/v2` — Tool to search for Points of Interest along a specified route using Search API v2. Use when you need to find POIs accessible from a planned route with detour constraints.
  - body: { view?: string, limit?: integer, query: string, route: object, sortBy?: string, fuelSet?: string, brandSet?: string, language?: string, mapcodes?: string, timeZone?: string, maxPowerKW?: number, minPowerKW?: number, categorySet?: string, connectorSet?: string, detourOffset?: boolean, openingHours?: string, maxDetourTime: integer, vehicleTypeSet?: string }
- `POST https://api.mcp.ai/api/tomtom/search/geometry` — Tool to search for POIs within geometric areas (circles or polygons). Use when you need to find points of interest constrained to specific geographic boundaries.
  - body: { limit?: integer, query: string, idxSet?: string, language?: string, geometryList: object[], extendedPostalCodesFor?: string }
- `POST https://api.mcp.ai/api/tomtom/search/orbis/category` — Tool to search for Points of Interest by category using TomTom Orbis Maps API. Use when you need to find POIs within specific categories using the Orbis mapping service.
  - body: { lat?: number, lon?: number, limit?: integer, query: string, radius?: integer, language?: string, typeahead?: boolean, apiVersion?: string, countrySet?: string, categorySet?: string, openingHours?: string }
- `POST https://api.mcp.ai/api/tomtom/search/orbis/places` — Tool to perform fuzzy search for addresses and points of interest using TomTom Orbis Maps API. Use when you need flexible matching on free-form location queries with the Orbis mapping service.
  - body: { lat?: number, lon?: number, ofs?: integer, limit?: integer, query: string, radius?: integer, brandSet?: string, language?: string, apiVersion?: string, countrySet?: string, categorySet?: string, openingHours?: string }
- `POST https://api.mcp.ai/api/tomtom/search/orbis/poi` — Tool to search for points of interest using TomTom Orbis Maps API. Use when you need POI suggestions by name or category from the Orbis dataset.
  - body: { lat?: number, lon?: number, limit?: integer, query: string, radius?: integer, typeahead?: boolean, apiVersion?: string, countrySet?: string, categorySet?: string }
- `POST https://api.mcp.ai/api/tomtom/snap/to/roads/sync` — Tool to snap GPS points to the road network synchronously. Maps raw GPS coordinates to actual road geometry, useful for map matching and route reconstruction.
  - body: { fields?: string, points: string, headings?: string, timestamps?: string, vehicle_type?: string, offroad_margin?: number, measurement_system?: string }
- `POST https://api.mcp.ai/api/tomtom/structured/geocode` — Tool to convert structured address fields into coordinates. Use after collecting street, city, and postal code.
  - body: { key: string, lat?: number, lon?: number, city?: string, view?: string, limit?: integer, radius?: integer, language?: string, postalCode?: string, streetName?: string, countryCode: string, municipality?: string, streetNumber?: string, freeformAddress?: string, countrySubdivision?: string }
- `POST https://api.mcp.ai/api/tomtom/traffic/incidents` — Tool to retrieve detailed traffic incidents within a bounding box. Use when you need incident details for a defined map area.
  - body: { fields?: string, format?: string, max_lat: number, max_lon: number, min_lat: number, min_lon: number, language?: string, projection?: string, original_position?: boolean }
- `POST https://api.mcp.ai/api/tomtom/update/geofencing/secret` — Tool to change the customer secret for TomTom Geofencing API. Use when you need to update or rotate the authentication secret for geofencing operations.
  - body: { secret: string, newSecret: string }
- `POST https://api.mcp.ai/api/tomtom/update/notifications/group` — Tool to update an existing contact group in TomTom Notifications API. Use when you need to modify the name, webhook URLs, or email addresses of a contact group.
  - body: { name?: string, emails?: string[], group_id: string, webhook_urls?: string[] }

## Example prompts
- "What can I do in Tomtom?"
- "Show me a summary of my Tomtom account"

## More
- Page: https://mcp.ai/tomtom
- Agent spec (llms.txt): https://mcp.ai/tomtom/llms.txt
- Postman collection: https://mcp.ai/tomtom/postman.json