How to Use the HERE Mobility MCP in Windsurf

Q: Can Cascade chain multiple HERE Mobility tools together inside Windsurf?

Yes, Cascade handles this natively. It will call getstationsbyname to find a hub, grab its ID, and immediately feed that into getschedule to show you upcoming departures.

Q: How do I find transit options near my current location with HERE Mobility and Windsurf?

Give Cascade your GPS coordinates. It triggers getnearbystations with a set radius to list every bus stop, subway entrance, and train platform around you.

Get real-time transit routes and schedules directly in Windsurf so Cascade can plan complex urban trips on its own.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HERE Mobility MCP to Windsurf

Create your Vinkius account to connect HERE Mobility 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 HERE Mobility with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multimodal routing with Cascade

`search_multimodal_trips` handles the heavy lifting when you need to mix walking, biking, and subway routes into a single trip. Cascade uses this tool to calculate travel times across different transit systems without waiting for you to prompt each step. You feed the agent your origin and destination coordinates. It runs the numbers, combines the modes, and maps out the entire journey before you even open your maps app.

Real-time station schedule monitoring

`get_schedule` pulls live arrival and departure boards for any transit hub you specify. Windsurf monitors these feeds automatically, letting your agent flag delays or missed connections while you write code. This MCP integration keeps your terminal clean. Combined with `get_nearby_stations`, this setup lets your agent map out every transit option within a specific radius of your office. You get raw, unfiltered schedule data directly in your workspace.

Deep route inspection in this MCP Server

`get_route_details` gets you the exact itinerary details for any trip ID generated by your search. The tool breaks down every single leg, transfer, and walking segment so your agent can verify the plan. By using `get_station_details` alongside it, Windsurf inspects station layouts and available lines before finalizing your route. This prevents your agent from recommending closed platforms or impossible transfers.

Setup guide

Set up HERE Mobility 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 HERE Mobility 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 HERE Mobility payment history." If connected, Cascade will call the HERE Mobility tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "here-mobility-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 HERE Mobility. 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 HERE Mobility 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 HERE Mobility MCP in Windsurf

You add the server configuration to your local config file. Windsurf automatically registers all eight transit tools, allowing Cascade to execute complex multi-step routing queries on your behalf.

Yes, Cascade handles this natively. It will call `get_stations_by_name` to find a hub, grab its ID, and immediately feed that into `get_schedule` to show you upcoming departures.

Give Cascade your GPS coordinates. It triggers `get_nearby_stations` with a set radius to list every bus stop, subway entrance, and train platform around you.

You can specify directions like "northbound" or "downtown" directly in your query. The agent passes this parameter to `get_schedule` to clean up the output and show only relevant trains.

Your GPS coordinates and transit queries go directly to the HERE API via our managed MCP Server. We run this in a zero-trust sandbox, meaning your raw location inputs are never stored or logged on our infrastructure.

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