How to Use the GraphHopper MCP in Windsurf

Q: Does Windsurf support advanced GraphHopper routing features?

Yes, Cascade handles all 10 tools natively. You can call calculateheavyroute to get truck-specific paths that avoid restricted roads.

Q: Can I use GraphHopper with Windsurf to optimize my delivery fleet?

Absolutely. By using submitvrpoptimizer, the agent creates complex routing schedules based on your specific fleet capacity and time window constraints.

Use GraphHopper in Windsurf to map routes and solve logistics problems with Cascade handling the heavy lifting.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GraphHopper MCP to Windsurf

Create your Vinkius account to connect GraphHopper to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup GraphHopper with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous route planning

Cascade reads your requirements and triggers `calculate_routing_matrix` to generate precise travel data. It handles the complex math tables automatically so you get the distance results without manual parsing. Once the matrix is set, you can chain these outputs into larger workflows. Windsurf takes the raw JSON response and turns it into actionable path data for your specific fleet constraints.

VRP optimization sequences

You define the delivery windows, and the agent executes `submit_vrp_optimizer` to find the most efficient stops. It manages the entire jsprit solve process without you needing to write a single line of orchestration code. After the job runs, the agent uses `poll_vrp_solution` to pull the final routing plan. It connects the dots between your raw delivery data and the actual navigation paths needed for your drivers.

Spatial data analysis

Visualize your delivery zones using `calculate_distance_isochrone` to see where your trucks can actually reach within a specific timeframe. The agent generates these polygons and maps them directly into your codebase. Need to verify coordinates? The agent uses `reverse_geocode` and `search_geocode` to translate addresses into exact map markers. It keeps your location data clean and ready for immediate use.

Setup guide

Set up GraphHopper MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the GraphHopper MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my GraphHopper payment history." If connected, Cascade will call the GraphHopper tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "graphhopper-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by GraphHopper. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect GraphHopper now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about GraphHopper MCP in Windsurf

Open your settings and navigate to the Cascade MCP panel. You can add the server configuration directly or use the built-in marketplace for a one-click install.

Yes, Cascade handles all 10 tools natively. You can call `calculate_heavy_route` to get truck-specific paths that avoid restricted roads.

Absolutely. By using `submit_vrp_optimizer`, the agent creates complex routing schedules based on your specific fleet capacity and time window constraints.

The server processes these arrays in the background and returns structured JSON. Windsurf then parses this data to update your project files.

Your location data stays within your local environment and the secure connection to the server. The MCP server only processes the specific coordinates you send for geocoding or routing.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript