Skip to main content
Use TomTom through Corsair: one client, typed API calls. Create an API key in the TomTom developer portal at my.tomtom.com. The key travels as the key query parameter on every request, and it must have the Search, Routing or Traffic product enabled for the endpoints you call. Things to know:
  • Paging is offset based. limit caps at 100 and offset skips within the result set; summary.totalResults is the total available; summary.numResults is the size of this page.
  • A search with no matches is a success. TomTom answers 200 with an empty results array, so check the array rather than the status.
  • radius needs a point. A radius without lat and lon is rejected before the request, because the API ignores it otherwise.
  • Routes take coordinates, not addresses. Geocode first, then pass the resulting positions. origins and destinations each accept several waypoints, joined with colons in the path.
  • Traffic needs a bounding box. traffic.incidents takes minLon,minLat,maxLon,maxLat covering at most 10,000 km², such as 4.88,52.36,4.92,52.39 for central Amsterdam. An inverted box is rejected here rather than at the provider.
  • Tiles are images, not JSON. traffic.tile returns { content_type, base64 }: the PNG bytes base64-encoded. Both layers take a style in the path (style for flow, incident_style for incidents).
  • A 403 is a plan limit. The key is valid but does not cover the product or the region, so the plugin does not retry it.
What you get:
  • 7 typed API operations

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

Search for a place with a geo bias
Calculate a route between two points
See the full list on the API page.

What’s next

API reference

Every tomtom.api.* operation with input and output types.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.