WinSurf Integration Guide

This guide explains how to configure WinSurf to use the TomTom MCP Server for location-based queries.

Prerequisites

• WinSurf installed
• Node.js 22+
• A valid TomTom API key

Setup

1. Add the below configuration to your ~/.codeium/windsurf/mcp_config.json file in the WindSurf directory:

   Copy{ "mcpServers": { "tomtom-mcp": { "command": "npx", "args": ["-y","@tomtom-org/tomtom-mcp@latest"], "env": { "TOMTOM_API_KEY": "<your_API_KEY>" } } } }

   1{
   2  "mcpServers": {
   3     "tomtom-mcp": {
   4        "command": "npx",
   5        "args": ["-y","@tomtom-org/tomtom-mcp@latest"],
   6        "env": {
   7         "TOMTOM_API_KEY": "<your_API_KEY>"
   8        }
   9     }
   10  }
   11}

Test It

Use WinSurf's integration features to query the MCP server for map, routing, or search data.

Troubleshooting

• Ensure TOMTOM_API_KEY is valid and active
• Check that the MCP server is running
• Review WinSurf logs for connection issues