TomTom Maps MCP Server

The TomTom Maps MCP Server is the official Model Context Protocol implementation from TomTom International. It gives AI agents structured access to TomTom's geospatial APIs, including forward and reverse geocoding, fuzzy and POI search, point-to-point and multi-waypoint routing, reachable range (isochrone) calculations, real-time traffic incidents, and static or dynamic map image generation. The server is published as the @tomtom-org/tomtom-mcp npm package and as a prebuilt Docker image, and TomTom also operates a hosted remote endpoint at https://mcp.tomtom.com/maps so clients can connect over HTTP without any local install.

The server supports two backends via the tomtom-maps-backend header. The default tomtom-maps backend exposes the core toolset. Setting the backend to tomtom-orbis-maps enables additional Orbis-only tools such as EV routing with charging stop optimization, search along a route corridor, area search, EV charging station search, and GeoJSON data visualization. All tools require a TomTom API key, which can be created from the TomTom Developer Portal.

Because TomTom publishes the repo under its own GitHub organization (tomtom-international), this is the canonical implementation rather than a community port. It documents integrations for Claude Desktop, VS Code, Cursor, Windsurf, and Smolagents.

Tools

Prerequisites

• A TomTom API key from the TomTom Developer Portal
• The key must have MCP Server access enabled
• For local install: Node.js 22.x

Option 1: Connect to the hosted server (recommended)

No install needed. Point your MCP client at TomTom's hosted endpoint and pass the API key as a header.

{
  "mcpServers": {
    "tomtom-mcp": {
      "type": "http",
      "url": "https://mcp.tomtom.com/maps",
      "headers": {
        "tomtom-api-key": "your_api_key_here"
      }
    }
  }
}

To enable the Orbis backend (EV routing, search along route, EV search, data viz, area search), add the backend header:

{
  "mcpServers": {
    "tomtom-mcp": {
      "type": "http",
      "url": "https://mcp.tomtom.com/maps",
      "headers": {
        "tomtom-api-key": "your_api_key_here",
        "tomtom-maps-backend": "tomtom-orbis-maps"
      }
    }
  }
}

Option 2: Run locally via npm

npm install @tomtom-org/tomtom-mcp@latest
# or run directly
npx @tomtom-org/tomtom-mcp@latest

Set TOMTOM_API_KEY in your environment.

Option 3: Docker

docker run -p 3000:3000 ghcr.io/tomtom-international/tomtom-maps-mcp:latest

Option 4: Build from source

git clone https://github.com/tomtom-international/tomtom-maps-mcp.git
cd tomtom-maps-mcp
npm install
npm run build
node ./bin/tomtom-mcp.js

Setup guides for Claude Desktop, VS Code, Cursor, Windsurf, and Smolagents are in the repo's docs/ directory.

• Build a travel planning agent that geocodes a list of destinations, calculates multi-waypoint routes, and surfaces real-time traffic incidents along the path.
• Power a logistics or field service assistant that computes reachable range (isochrones) from a depot to determine which jobs are feasible within a driver shift.
• Add location intelligence to a sales tool: find POIs of a given category near a prospect's address using fuzzy and nearby search.
• Plan EV road trips with charging stop optimization using the Orbis tomtom-ev-routing and tomtom-ev-search tools.
• Generate static or dynamic map images for embedding in reports, dashboards, or chat replies without writing client-side map code.

• "Geocode '1600 Amphitheatre Parkway, Mountain View, CA' and find coffee shops within 1 km."
• "Plan a route from Amsterdam to Berlin with a stop in Hannover, and show current traffic incidents along the way."
• "I have an EV with 60 kWh and 30% charge. Plan a route from Munich to Milan with optimal charging stops."
• "Show me all the gas stations within a 20-minute drive of these coordinates."
• "Generate a static map image centered on Times Square with markers for these 5 restaurants."

• Official, maintained by TomTom under the tomtom-international GitHub org.
• Offers a hosted HTTP endpoint so users can skip local setup entirely.
• Broad tool coverage across geocoding, routing, traffic, EV, and map rendering.
• Multiple distribution options: hosted URL, npm package, Docker image, and source build.

• Requires a TomTom API key with MCP Server access enabled; usage is subject to TomTom API quotas and pricing.
• EV and advanced search tools require the Orbis Maps backend, which is a separate entitlement.
• Hosted server is described as public preview, so behavior and availability may change.

• Google Maps MCP server (community implementations of Google Maps Platform tools)
• Mapbox MCP for similar geocoding, directions, and map rendering capabilities
• OpenStreetMap-based community MCP servers (e.g. Nominatim/Overpass wrappers) for non-commercial geocoding and POI queries