TomTom LogoDocs
Products
Resources
Pricing
Sign in
TomTom MCP Server

Quick Setup

Quick Setup

The TomTom Remote MCP Server is in public preview .

Get started with TomTom’s location services in your AI workflows using our Remote MCP Server. No installation required!

Prerequisites

Before you begin, ensure you have:

  • A valid TomTom API key - Sign up for a free account to get your API key
  • Ensure that your key has access to the MCP product and different APIs available through the MCP.
    • Inspect your API key’s configuration at API & SDK Keys
    • Tick “All” under “Edit key”, or enable “MCP Server”, “Map Display API”, “Routing API”, “Search API”, “Geocoding API”, “Reverse Geocoding API” and “Traffic API”.
  • An MCP-compatible AI client (VS Code with GitHub Copilot, OpenAI Agents, Claude Desktop, etc.) — see Integration Guides for client-specific setup

Step 1: Get Your Endpoint

The TomTom Remote MCP Server is available at:

https://mcp.tomtom.com/maps

No installation is required - the server is ready to use with your API key.

Step 2: Configure Your MCP Client

Configure your AI client to connect to the TomTom Remote MCP Server using your API key in the request headers.

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

Replace "your_api_key_here" with your actual TomTom API key from developer.tomtom.com .

Selecting a Map Backend

To connect to a specific map backend, add the tomtom-maps-backend header to your configuration:

Using TomTom Maps (default):

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

Using TomTom Orbis Maps :

{
  "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"
      }
    }
  }
}

If the tomtom-maps-backend header is omitted, the server defaults to TomTom Maps.

For specific client integration instructions, see our Integration Guides .

Step 3: Test the Connection

Once configured, test that your AI assistant can access TomTom’s services by asking a simple location-based question:

What's at the coordinates 52.3676, 4.9041?

Your AI assistant should be able to use the TomTom MCP Server to retrieve the address and other location details from the TomTom APIs.

Authentication & Charging

All requests to the TomTom MCP Server use your API key for authentication. API usage is tracked and charged according to TomTom’s standard pricing.

Learn more: For detailed pricing information, visit https://developer.tomtom.com/pricing

Next Steps