How to Use the NOAA Tides & Currents API MCP in Windsurf

Q: How do I configure this NOAA Tides & Currents API server inside Windsurf?

You add the server configuration to your local mcpconfig.json file. Cascade immediately discovers the tools and calls them during your active chat sessions.

Q: What happens if the NOAA Tides & Currents API goes offline during a Windsurf session?

The agent runs checkapistatus to diagnose the issue immediately. If the NOAA service is down, Cascade alerts you in the chat panel instead of failing silently.

Let Windsurf autonomously chain NOAA Tides & Currents API calls to track water levels without your manual input.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect NOAA Tides & Currents API MCP to Windsurf

Create your Vinkius account to connect NOAA Tides & Currents API 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 NOAA Tides & Currents API with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-step tidal audits with Windsurf Cascade

The `get_water_levels` tool pulls real-time water levels from specific NOAA stations directly into your active editor. Cascade reads your local vessel draft configurations and determines if the current depth allows safe passage. You do not need to prompt it for each step because this MCP Server lets the agent handle the sequence on its own. When you set a goal to check harbor safety, Cascade triggers `check_api_status` first to ensure the NOAA endpoints are up. It then fetches water levels and analyzes the margin of safety without waiting for your permission.

Automated marine temperature analysis

The `get_water_temperature` tool retrieves real-time thermal data from coastal sensors to help calibrate your hydrodynamic models. Cold water changes density, which directly impacts how deep a hull sits in a channel. Cascade uses this tool alongside `get_air_temperature` to calculate exact local draft adjustments instantly. Instead of jumping between browser tabs, you let your agent run these calculations inside your workspace. The agent pulls the numbers, writes the correction factors, and updates your project files in one go.

Predictive tide planning in your workspace

The `get_tide_predictions` tool delivers high and low water forecasts directly to your Windsurf environment. Cascade parses this predictive data to map out optimal transit windows for heavy cargo vessels. It matches these predictions against your local shipping schedules automatically. You get a clean schedule of safe departure times written directly to your markdown logs. This MCP setup eliminates manual scheduling errors by letting the agent cross-reference raw NOAA data points in real-time.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "noaa-tides-currents-api-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 NOAA Tides & Currents. 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 NOAA Tides & Currents API 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 NOAA Tides & Currents API MCP in Windsurf

You add the server configuration to your local `mcp_config.json` file. Cascade immediately discovers the tools and calls them during your active chat sessions.

Yes, that is Cascade's main strength. When you ask to analyze a specific harbor, it connects predictions with live depths to build a complete transit window report without requiring step-by-step prompts.

The agent runs `check_api_status` to diagnose the issue immediately. If the NOAA service is down, Cascade alerts you in the chat panel instead of failing silently.

You provide the standard 7-digit NOAA station ID in your prompt. The agent uses this ID to query tools like `get_air_temperature` or water levels for that specific geographic point.

Your queries for station IDs, water levels, and tidal predictions remain entirely local to your Windsurf environment. Vinkius runs the MCP server in a secure sandbox, meaning your operational telemetry never leaks to third 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