Developer

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 that supports header-based API key auth (VS Code with GitHub Copilot, OpenAI Agents, etc.)

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.

Local Setup Option

If you need to run the MCP server locally (for customization, offline development, or specific deployment requirements), refer to the GitHub repository for installation instructions.

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.

1{
2  "mcpServers": {
3    "tomtom-mcp": {
4      "type": "http",
5      "url": "https://mcp.tomtom.com/maps",
6      "headers": {
7        "tomtom-api-key": "your_api_key_here"
8      }
9    }
10  }
11}

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

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