TomTom through One
TomTom is a maps and location technology platform that provides APIs, SDKs, navigation, traffic analytics, and customizable map data, enabling carmakers, fleets, public sector teams, and developers to build routing, mobility, and automated driving solutions.
One exposes TomTom through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.
How to run an action
- Find the action in the table below, or call
search_one_platform_actions with platform tomtom if it is not listed.
- Call
get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
- Call
execute_one_action with parameters copied from that knowledge.
Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.
Before you start
Call list_one_integrations once and confirm TomTom is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.
Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.
Before a write
Creates, updates, deletes and sends land on a real TomTom account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.
Actions
Search
| Action |
Method |
Path |
Action id |
| Fuzzy Search |
GET |
/search/{{versionNumber}}/search/{{query}}.{{ext}} |
conn_mod_def::GMcXUr9b3yA::DpgJ1PZISRqT74zjQq8E4Q |
| Geometry Filter Using Search |
GET |
/search/{{versionNumber}}/geometryFilter.{{ext}} |
conn_mod_def::GMcXRagWRP0::M84d24wsSKyM1kFgDz9Wsw |
| Geometry Search |
GET |
/search/{{versionNumber}}/geometrySearch/{{query}}.{{ext}} |
conn_mod_def::GMcXUsBG2s0::YovlKq6jQQ6W03Po1D1jlw |
| Nearby Search |
GET |
/search/{{versionNumber}}/nearbySearch/.{{ext}} |
conn_mod_def::GMcXUsd3wJg::uULv-mVaQLeW7RzcVTe1Wg |
Feedback
| Action |
Method |
Path |
Action id |
| Get Feedback by ID |
GET |
/api/v1/feedback/feedback-id/{{feedbackId}} |
conn_mod_def::GMcXRIt5Ulg::aOW94DySQAyT-apSxq7ZPg |
| Get Feedback by Reference ID |
GET |
/api/v1/feedback/reference-id/{{referenceId}} |
conn_mod_def::GMcXRHJf7y4::tjmgEPa7RTu4OhjRUvDy1A |
| Create Feedback |
POST |
/api/v1/feedback |
conn_mod_def::GMcXRNr9zwc::ML0BvkCDTGuBcf5BwX-R-w |
Places
| Action |
Method |
Path |
Action id |
| Reverse Geocode Using Maps Orbis Places |
GET |
/maps/orbis/places/reverseGeocode |
conn_mod_def::GMcXUQX5wfo::UCBDjdn1RC-JWKWHwsg2tQ |
| Structured Geocode |
GET |
/maps/orbis/places/structuredGeocode |
conn_mod_def::GMcXR6jcYOc::o_qi7tGQSWOhmpeP8ygKkA |
| Discover a Location Using Maps Orbis Places |
POST |
/maps/orbis/places/discover |
conn_mod_def::GMcXTCNC6dY::j4ggfZo5TJSM3zNpjiy4vw |
Routing
| Action |
Method |
Path |
Action id |
| Calculate Route |
GET |
/routing/{{versionNumber}}/calculateRoute/{{locations}}/{{contentType}} |
conn_mod_def::GMcXUhiL0o8::jE60qqLXT-et4M_AgJMBmw |
| Calculate Long Distance EV Route |
POST |
/routing/{{versionNumber}}/calculateLongDistanceEVRoute/{{locations}}/{{contentType}} |
conn_mod_def::GMcXSI-VndI::rg1TObACTNynsRYJU5JZ3Q |
| Calculate Route |
POST |
/routing/{{versionNumber}}/calculateRoute/{{locations}}/{{contentType}} |
conn_mod_def::GMcXUgqw6_I::whruBsERSPmqJM3H-FeOfw |
FeedbackStatus
| Action |
Method |
Path |
Action id |
| Get Feedback Status by ID |
GET |
/api/v1/feedback/feedback-id/{{feedbackId}}/status |
conn_mod_def::GMcXRFT_UnM::94Gt9LeQRFCBBryBeVvC1w |
| Get Feedback Status by Reference ID |
GET |
/api/v1/feedback/reference-id/{{referenceId}}/status |
conn_mod_def::GMcXRZN3RMQ::__I25trAQr6eG0LntzJsPg |
TrafficIncidentDetails
| Action |
Method |
Path |
Action id |
| Get Traffic Incident Details |
GET |
/maps/orbis/traffic/incidents/details |
conn_mod_def::GMcXRxqZNU8::u8IkOT3uRACrF3SN4UzbDA |
| Get Traffic Incident Details Using Maps Orbis Traffic Incidents |
POST |
/maps/orbis/traffic/incidents/details |
conn_mod_def::GMcXRyKRIsA::hTNEUuuuQC6O9JOzpqcH2w |
HillshadeTile
| Action |
Method |
Path |
Action id |
| Get a Hillshade Tile |
GET |
/map/1/tile/{{layer}}/{{type}}/{{zoom}}/{{x}}/{{y}}.{{format}} |
conn_mod_def::GMcXTJi7OQ0::nQsEaoGQRjys56YvepkArA |
| Get Hillshade Tile Using Maps Orbis Display |
GET |
/maps/orbis/display/hillshade/tile/{{zoom}}/{{x}}/{{y}} |
conn_mod_def::GMcXURT-2y8::72yGmwjOTTa_k9ZwgJgcdw |
ReachableRange
| Action |
Method |
Path |
Action id |
| Calculate Reachable Range |
GET |
/routing/{{versionNumber}}/calculateReachableRange/{{origin}}/{{contentType}} |
conn_mod_def::GMcXUgL50LA::5T82T_RuTuC78Vr466f-nA |
| Calculate Reachable Range |
POST |
/routing/{{versionNumber}}/calculateReachableRange/{{origin}}/{{contentType}} |
conn_mod_def::GMcXUftrlL0::0Pk_AKjjQ4i0pf9UtEtzEw |
SnapToRoads
| Action |
Method |
Path |
Action id |
| Synchronous Snap to Roads |
GET |
/snapToRoads/{{versionNumber}} |
conn_mod_def::GMcXU2J2x-s::jquwvub3Qhy9rWlB1QSQRQ |
| Synchronous Snap to Roads |
POST |
/snapToRoads/{{versionNumber}} |
conn_mod_def::GMcXU5YUMI4::miffLXF6QiaERYVRXorSDw |
VectorTile
| Action |
Method |
Path |
Action id |
| Get a Vector Tile |
GET |
/map/2/tile/{{layer}}/{{zoom}}/{{x}}/{{y}}.pbf |
conn_mod_def::GMcXWKnKXmU::gIgTntUdTwiZdum0uf5fSQ |
| Get a Vector Tile from TomTom Map Display API V1 |
GET |
/map/1/tile/{{layer}}/{{style}}/{{zoom}}/{{x}}/{{y}}.pbf |
conn_mod_def::GMcXV9TyoBY::jxeqi8s_REa7doM34Zlmfg |
AsynchronousSnapToRoadsBatchStatus
| Action |
Method |
Path |
Action id |
| Get Asynchronous Snap to Roads Batch Status |
GET |
/snapToRoads/batch/{{versionNumber}}/{{batchId}}/status |
conn_mod_def::GMcXQc_VtN8::b_sjA6F_SeW_rykYRk50Uw |
SnapToRoadsResults
| Action |
Method |
Path |
Action id |
| Download Asynchronous Snap to Roads Results |
GET |
/snapToRoads/batch/{{versionNumber}}/{{batchId}} |
conn_mod_def::GMcXQe2Yuys::R7Rk6N5VSfiNUGyRb_ZiRA |
AdditionalData
| Action |
Method |
Path |
Action id |
| Get Additional Data |
GET |
/search/{{versionNumber}}/additionalData.{{ext}} |
conn_mod_def::GMcXQgij10s::qIE2lihhTk2mtgaFUYCtng |
LandmarksTile
| Action |
Method |
Path |
Action id |
| Get a 3D Landmarks Tile |
GET |
/maps/orbis/display/3d/landmarks/tile/{{zoom}}/{{x}}/{{y}} |
conn_mod_def::GMcXQg6K9VU::QX1-2LzgRs-InKQO1oka-g |
LandmarksHeatmap
| Action |
Method |
Path |
Action id |
| Get 3D Landmarks Heatmap |
GET |
/maps/orbis/display/3d/landmarks/heatmap/{{zoom}}/{{x}}/{{y}}/{{landmarkZoom}} |
conn_mod_def::GMcXQiQSq0U::bagAmUsFS9yTS7_7zo0xkw |
BatchSearch
| Action |
Method |
Path |
Action id |
| Submit a Synchronous Search Batch |
POST |
/search/2/batch/sync.{{outputFormat}} |
conn_mod_def::GMcXQqDK_Vw::Ty1jgrhaRAu0TgIbxokCIQ |
AsynchronousBatchResults
| Action |
Method |
Path |
Action id |
| Download Asynchronous Batch Results |
GET |
/search/2/batch/{{batchId}} |
conn_mod_def::GMcXQrEwOpw::wmAGLCgIQouM-ZzBA7qM4g |
SearchBatch
| Action |
Method |
Path |
Action id |
| Submit an Asynchronous Search Batch |
POST |
/search/2/batch.{{outputFormat}} |
conn_mod_def::GMcXQrNFiyQ::IO7dzsxYQ6GxswH7IXOAhw |
SnapToRoadsBatch
| Action |
Method |
Path |
Action id |
| Submit Asynchronous Snap to Roads Batch |
POST |
/snapToRoads/batch/{{versionNumber}} |
conn_mod_def::GMcXQxq7Pps::3TLhPZO3TqC3atveOoQB_w |
CopyrightInformation
| Action |
Method |
Path |
Action id |
| Get Copyright Information for a Map |
GET |
/maps/orbis/copyrights |
conn_mod_def::GMcXQy9GuK4::1iG4JHPMTE-n37R0mV2Skw |
MapServiceCopyrightCaptions
| Action |
Method |
Path |
Action id |
| Get Map Service Copyright Captions |
GET |
/map/2/copyrights/caption.json |
conn_mod_def::GMcXQ5TISs0::gXySC5DrTIqLx3DiQ7-ahw |
MapCopyrights
| Action |
Method |
Path |
Action id |
| Get Map Copyrights |
GET |
/map/2/copyrights |
conn_mod_def::GMcXQ5vlHN8::Gw6QRvNcQ8Ota8W5xRGH9w |
CopyrightsCaption
| Action |
Method |
Path |
Action id |
| Get Copyrights Caption Using Maps Orbis Copyrights |
GET |
/maps/orbis/copyrights/caption |
conn_mod_def::GMcXQ8zuTd0::LBqpGlS4T8eDjhxnlETF_Q |
EvSearch
| Action |
Method |
Path |
Action id |
| EV Search by Id |
GET |
/search/{{versionNumber}}/evbyid |
conn_mod_def::GMcXQ9BACv0::kn1AMUqLQgWtgVfVO1TX8g |
EvSearchAlongTheRoute
| Action |
Method |
Path |
Action id |
| EV Search Along the Route |
POST |
/search/{{versionNumber}}/alongRoute |
conn_mod_def::GMcXQ-maPV4::FBMD6w2xR16Mr5EQQbgFEA |
EvChargingStations
| Action |
Method |
Path |
Action id |
| Search Nearby EV Charging Stations |
GET |
/search/{{versionNumber}}/evsearch |
conn_mod_def::GMcXRKgjTMo::Wm2dfKfTSjecZ-_7UUUBEA |
GeometryFilter
| Action |
Method |
Path |
Action id |
| Geometry Filter |
POST |
/search/{{versionNumber}}/geometryFilter.{{ext}} |
conn_mod_def::GMcXRT3599Q::gD5FY-R7Sj6gUMRjppXMVg |
FuelPrices
| Action |
Method |
Path |
Action id |
| Get Fuel Prices |
GET |
/search/2/fuelPrice.{{ext}} |
conn_mod_def::GMcXRV_5Zxw::sIburKZeQXyv_uEaV1B_RA |
MapsOrbisPlaces
| Action |
Method |
Path |
Action id |
| Geocode Using Maps Orbis Places |
GET |
/maps/orbis/places/geocode |
conn_mod_def::GMcXRmRD0_U::yEWp3uJrRtCpwQT9L8nr4A |
IntermediateTrafficFlowData
| Action |
Method |
Path |
Action id |
| Get Intermediate Traffic Flow Data for a City |
GET |
/maps/orbis/intermediate-traffic/flow-detailed/{{cityName}}/content.proto |
conn_mod_def::GMcXRwBG2d8::-bpsW1QvRAWHKHidDxZj9w |
TrafficIncidents
| Action |
Method |
Path |
Action id |
| Get Traffic Incidents for a City |
GET |
/maps/orbis/intermediate-traffic/incidents/{{cityName}}/content.xml |
conn_mod_def::GMcXR2aMvTM::1P1osTFMREiUPsorlqUYeA |
TrafficFlowProtobufFeed
| Action |
Method |
Path |
Action id |
| Get Traffic Flow Protobuf Feed |
GET |
/tsq/hdf-detailed/{{productName}}/{{TOMTOM_API_KEY}}/content.proto |
conn_mod_def::GMcXSDS9y1w::Mw4Z9be2SS6Uz_N0kQefUA |
AsynchronousMatrixJobResult
| Action |
Method |
Path |
Action id |
| Download an Asynchronous Matrix Job Result |
GET |
/routing/matrix/2/async/{{matrixJobId}}/result |
conn_mod_def::GMcXSDmE8Ks::izRmnzzhSIWwsrtcsWPNyw |
AsynchronousMatrixJobStatus
| Action |
Method |
Path |
Action id |
| Get Asynchronous Matrix Job Status |
GET |
/routing/matrix/2/async/{{matrixJobId}} |
conn_mod_def::GMcXSD0yCFI::cVb5y-a7RqaBsjqnS72EzA |
TrafficIncidentsDatexIiFeed
| Action |
Method |
Path |
Action id |
| Get Traffic Incidents DATEX II Feed |
GET |
/tsq/hdt/{{productName}}/{{TOMTOM_API_KEY}}/content.xml |
conn_mod_def::GMcXSVkoHT4::lhktY_wwQpef8kATtOqz8w |
ParkingLocations
| Action |
Method |
Path |
Action id |
| Get Parking Locations |
GET |
/parking/services/1/locations |
conn_mod_def::GMcXSd_J2II::SkRQ8LxsTCmb_DrOWGnUEA |
ParkingAvailability
| Action |
Method |
Path |
Action id |
| Parking Availability Using Search v2 |
GET |
/search/2/parkingAvailability.{{ext}} |
conn_mod_def::GMcXSfNwKRA::CicyGTyJRPe4c952pVt1ZQ |
ParkingPrices
| Action |
Method |
Path |
Action id |
| Get Parking Prices |
GET |
/search/2/parkingPrices.{{ext}} |
conn_mod_def::GMcXSgnd_Ww::_0tvEv6FQ7a1KPkqrrBpoQ |
MatrixRoutingJob
| Action |
Method |
Path |
Action id |
| Submit a Synchronous Matrix Routing Job |
POST |
/routing/matrix/2 |
conn_mod_def::GMcXSti_L-o::lQLC3rXgQauzFxgL6NhFlw |
MatrixJobs
| Action |
Method |
Path |
Action id |
| Submit an Asynchronous Matrix Job |
POST |
/routing/matrix/2/async |
conn_mod_def::GMcXS2Ie4EU::G8fRr61CQiqk1Swhn1T20g |
ParkingVectorTiles
| Action |
Method |
Path |
Action id |
| Get Parking Vector Tiles |
GET |
/parking/map/1/tile/{{zoom}}/{{x}}/{{y}}.{{format}} |
conn_mod_def::GMcXS92QRLk::9nxPtzznTRqEqLHO3yJHaQ |
PoiCategories
| Action |
Method |
Path |
Action id |
| Get POI Categories |
GET |
/search/{{versionNumber}}/poiCategories.{{ext}} |
conn_mod_def::GMcXS-p2Q-8::mKG5N8uwRBioiYPyL90XtA |
PlacesSuggest
| Action |
Method |
Path |
Action id |
| Suggest a Location Using Maps Orbis Places |
POST |
/maps/orbis/places/suggest |
conn_mod_def::GMcXS_wZvQc::_Q7zxMHsR-iTsRXrEZMLyQ |
PlacesDetails
| Action |
Method |
Path |
Action id |
| Get Place Details Using Maps Orbis Places |
GET |
/maps/orbis/places/details/{{type}}/{{id}} |
conn_mod_def::GMcXTAqeUtg::7OTcJ6SrT9aObAe568eCQQ |
SatelliteTile
| Action |
Method |
Path |
Action id |
| Get a Satellite Tile |
GET |
/map/1/tile/{{layer}}/{{style}}/{{zoom}}/{{x}}/{{y}}.{{format}} |
conn_mod_def::GMcXTJXfa6Q::NurNheNETlGGwifAHxGKnA |
PoiPhotos
| Action |
Method |
Path |
Action id |
| Get POI Photos |
GET |
/search/2/poiPhoto |
conn_mod_def::GMcXTLcmEis::HEk7dLOQSIGf7YYtnWrOSQ |
MapTile
| Action |
Method |
Path |
Action id |
| Get a Map Tile |
GET |
/map/{{versionNumber}}/tile/{{layer}}/{{style}}/{{zoom}}/{{x}}/{{y}}.{{format}} |
conn_mod_def::GMcXTL69Ccg::3s3UIAmKRROqjW7JevlOOg |
PointsOfInterestDetails
| Action |
Method |
Path |
Action id |
| Get Points of Interest Details |
GET |
/search/2/poiDetails.{{ext}} |
conn_mod_def::GMcXUCCZbTM::QGxjRKl6TGCW2vzevMP-OQ |
StaticImage
| Action |
Method |
Path |
Action id |
| Get a Static Image |
GET |
/map/{{versionNumber}}/staticimage |
conn_mod_def::GMcXUKfI-mc::Q8u_P6T5SBywRt9BLbaaHA |
DisplayRasterTile
| Action |
Method |
Path |
Action id |
| Get Display Raster Tile Using Maps Orbis |
GET |
/maps/orbis/display/raster/tile/{{zoom}}/{{x}}/{{y}} |
conn_mod_def::GMcXUM25Jb4::6I_24aMISCym9-ZflpwoiA |
SatelliteRasterTiles
| Action |
Method |
Path |
Action id |
| Get Satellite Raster Tiles Using Maps Orbis Display |
GET |
/maps/orbis/display/satellite/tile/{{zoom}}/{{x}}/{{y}} |
conn_mod_def::GMcXUP12Vcc::rvyXo47QRpmwKkr6aoBbUg |
SearchAlongRoute
| Action |
Method |
Path |
Action id |
| Search Along Route |
POST |
/search/{{versionNumber}}/searchAlongRoute/{{query}}.{{ext}} |
conn_mod_def::GMcXUeE-vnM::MfXiNWBjSEiP56pVxdLXiA |
CategorySearch
| Action |
Method |
Path |
Action id |
| Category Search |
GET |
/search/{{versionNumber}}/categorySearch/{{query}}.{{ext}} |
conn_mod_def::GMcXUsYZCDU::W9LJdJRCROi2KWHheluf8g |
GeometrySearch
| Action |
Method |
Path |
Action id |
| Geometry Search Using Search v2 |
POST |
/search/{{versionNumber}}/geometrySearch/{{query}}.{{ext}} |
conn_mod_def::GMcXUsr2b7c::DDzivJoQS0ebT_LwKHboWQ |
TrafficFlowRasterTile
| Action |
Method |
Path |
Action id |
| Get a Traffic Flow Raster Tile |
GET |
/maps/orbis/traffic/flow/raster/tile/{{zoomLevel}}/{{x}}/{{y}} |
conn_mod_def::GMcXU1IDdlU::ssDq18fFS0GV83LkGN7Mfw |
TrafficFlowVectorTile
| Action |
Method |
Path |
Action id |
| Get a Traffic Flow Vector Tile |
GET |
/maps/orbis/traffic/flow/vector/tile/{{zoomLevel}}/{{x}}/{{y}} |
conn_mod_def::GMcXU1LYNTs::-jtfGCEvSsemNzzIcOTJHw |
PointsOfInterest
| Action |
Method |
Path |
Action id |
| Search Points of Interest |
GET |
/search/{{versionNumber}}/poiSearch/{{query}}.{{ext}} |
conn_mod_def::GMcXVyWZF0A::PMoVWNPIQcusgiV-VRj-ag |
MapStylesMetadata
| Action |
Method |
Path |
Action id |
| Get Map Styles Metadata |
GET |
/map/{{versionNumber}}/{{resourceType}}/{{resourceVersion}}/{{resourceVariant}}/metadata.{{format}} |
conn_mod_def::GMcXV6PKpEo::T4oHk0thRny66Ohoxu-NIQ |
MapStyleResource
| Action |
Method |
Path |
Action id |
| Get a Map Style Resource |
GET |
/map/{{versionNumber}}/{{resourceType}}/{{resourceVersion}}/{{resourceVariant}}/{{resourceName}} |
conn_mod_def::GMcXV6d_8ZY::Bj86_5BhQdO_RC0rfsBTwA |
TrafficIncidentRasterTile
| Action |
Method |
Path |
Action id |
| Get a Traffic Incident Raster Tile Using Maps Orbis |
GET |
/maps/orbis/traffic/incidents/raster/tile/{{zoomLevel}}/{{x}}/{{y}} |
conn_mod_def::GMcXV7zeawY::hc1oiveaT6aSvfV-qlivjA |
TrafficIncidentVectorTile
| Action |
Method |
Path |
Action id |
| Get a Traffic Incident Vector Tile |
GET |
/maps/orbis/traffic/incidents/vector/tile/{{zoomLevel}}/{{x}}/{{y}} |
conn_mod_def::GMcXV8GI3AU::IfRdiBLSRdeM4jdptDM0-Q |
WmtsCapabilities
| Action |
Method |
Path |
Action id |
| Get WMTS Capabilities |
GET |
/map/{{versionNumber}}/wmts/{{key}}/{{wmtsVersion}}/WMTSCapabilities.xml |
conn_mod_def::GMcXWEF-K5o::Mm5Rw2wQRn-jYBzRdKyo2g |
Map
| Action |
Method |
Path |
Action id |
| Get Map Using TomTom Raster Map WMS |
GET |
/map/{{versionNumber}}/wms/ |
conn_mod_def::GMcXWFRNKk4::F3Q9OzrwSvC90Aqtn7U0qA |
Capabilities
| Action |
Method |
Path |
Action id |
| Get Capabilities Using Map WMS |
GET |
/map/{{versionNumber}}/wms/ |
conn_mod_def::GMcXWFz4L90::AAkqVwGYR_mBYQNVCfE0qg |
MapDisplayVectorTiles
| Action |
Method |
Path |
Action id |
| Get a Map Display Vector Tile Using Maps Orbis Display Vector Tile |
GET |
/maps/orbis/display/vector/tile/{{zoom}}/{{x}}/{{y}} |
conn_mod_def::GMcXWLR0B5g::OrBvIaozSgqOB03RZWnjxQ |
When a call fails
The error comes from TomTom, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.
Full catalog: https://www.withone.ai/knowledge/tomtom
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.
withoneai