How to Use the NavAPI MCP in Windsurf

Connect the NavAPI MCP Server to Windsurf and let Cascade autonomously map maritime shipping routes and analyze port traffic.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect NavAPI MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous Route Plotting

`search_maritime_routes` lets Windsurf plot shipping lanes across global waters. Cascade reads your prompt to find a path from Rotterdam to Singapore, pulls the coordinates, and instantly chains a request to `get_port_distance` to calculate the exact nautical miles required for the journey. Instead of prompting for each step, you just ask for the fastest maritime path. Your agent grabs the routing data, checks the distance, and returns a complete trip breakdown right in your editor.

Maritime Data MCP Server Integration

`get_nautical_ports` pulls active maritime hubs based on country filters directly into your workflow. If you need to map out the supply chain infrastructure in Brazil, Cascade fetches the port list and immediately cross-references it with `list_nautical_charts` to ensure you have the right geographic mapping data. You never have to look up chart availability manually. Windsurf sees the ports, knows it needs the charts, and runs the query before you even ask.

Port Traffic Analysis

`get_port_vessel_traffic` grabs live statistics on ship movements inside specific harbors. If you are building a dashboard to track congestion, you point Cascade at the target port and it pulls the current vessel count. It pairs perfectly with `check_api_status` to ensure the maritime data feed is active before running heavy queries. You get the traffic numbers injected straight into your local environment so you can test your code against real logistics data.

Setup guide

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

mcp_config.json

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

Use the built-in MCP Marketplace for a one-click install. You can also edit your `~/.codeium/windsurf/mcp_config.json` file to add the server manually.

Yes. Cascade will automatically pull a port list and then loop through it to check traffic stats. You just ask for the final report.

Check the MCP panel and hit Refresh. If it still fails, run the status tool to confirm the upstream service is responding.

You need a single endpoint token from Vinkius. That handles all the authentication for the underlying maritime databases.

NavAPI processes geographic coordinates, port names, and vessel traffic statistics. Vinkius runs this endpoint in a zero-trust V8 Isolate Sandbox, meaning the data passes through ephemerally and is never stored on disk.

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