How to Use the Navitia MCP in Windsurf

Q: How does Cascade use Navitia to map transit coverage?

Cascade calls getcoverage to check which European cities are active in Navitia. It then maps specific transit networks using getnetworks to match your local development requirements.

Q: Can I test Navitia transit timetables inside Windsurf?

Yes, you can ask Cascade to run getstopschedule to pull Navitia timetables inside Windsurf. The agent pulls the complete timetable for any French or European station and formats the JSON output for your active files.

Q: Does the Navitia MCP Server support real-time departure boards in Windsurf?

Yes, Cascade invokes getdepartures to pull live Navitia platform info inside Windsurf. The agent then writes the code to parse these delay indicators directly into your interface.

Q: How do I feed coordinates to the search tool?

You feed coordinates to Windsurf, and Cascade uses searchplaces to find Navitia place IDs. The agent then feeds those resolved values into your routing or stop-finding functions.

Let Cascade plan transit routes, monitor delays, and map coverage across Europe directly inside your Windsurf IDE with this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Navitia MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous European Route Planning in Windsurf

The `plan_journey` tool lets Cascade calculate multimodal trips across Europe without waiting for your manual prompts. When you task the agent with building a travel app or verifying transit times, Cascade chains this tool with `search_places` to resolve stop IDs and fetch coordinates in one go. Cascade reads your current workspace context to extract destination addresses, runs the routing query, and outputs the complete itinerary directly into your code. This means Windsurf injects real-time walking, biking, and rail transfers right where your application logic needs them.

Live Delay Tracking with This MCP Server

The `get_disruptions` tool exposes active European service alerts to your Windsurf editor. Cascade queries this Navitia endpoint to check line status and automatically flags transit delays before they break your logistics simulation. By combining this with `get_departures`, your Windsurf agent monitors real-time platform changes and displays active detour recommendations. You get instant updates because Cascade handles the multi-step verification of Navitia schedules.

Geographic Transit Analysis in Your IDE

The `get_isochrone` tool generates GeoJSON polygons showing reachable travel areas for Windsurf within a set time limit. Cascade uses these boundary coordinates to map out urban transit accessibility right inside your Windsurf workspace using this MCP. You can instruct Cascade to run `get_nearby_stops` to index all Navitia stations within a thirty-minute commute. Spatial queries are handled entirely by Cascade, giving you structured JSON datasets to build local transit dashboards.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "navitia-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 Navitia. 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 Navitia 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 Navitia MCP in Windsurf

Cascade calls `get_coverage` to check which European cities are active in Navitia. It then maps specific transit networks using `get_networks` to match your local development requirements.

Yes, you can ask Cascade to run `get_stop_schedule` to pull Navitia timetables inside Windsurf. The agent pulls the complete timetable for any French or European station and formats the JSON output for your active files.

Yes, Cascade invokes `get_departures` to pull live Navitia platform info inside Windsurf. The agent then writes the code to parse these delay indicators directly into your interface.

You feed coordinates to Windsurf, and Cascade uses `search_places` to find Navitia place IDs. The agent then feeds those resolved values into your routing or stop-finding functions.

Your geographic coordinates and Navitia search queries are processed locally within Windsurf's secure sandbox. No routing history or location coordinates are stored or shared with external parties.

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