How to Use the NCDC Climate Data Online MCP in Windsurf

Q: How do I search for specific NOAA datasets using NCDC Climate Data Online in Windsurf?

You ask Cascade to find a dataset, and it runs listdatasets to find options like GSOD or GHCND. It then uses getdataset to check the date ranges and coverage.

Q: Can NCDC Climate Data Online help Windsurf find stations in a specific city?

Yes, this server exposes listlocations and listlocationcategories to narrow down geographic regions. Cascade uses these tools to find the city's location ID and then calls liststations to pinpoint active hardware.

Q: How does Windsurf handle complex data limits with the NCDC Climate Data Online MCP Server?

Cascade handles pagination automatically when calling getclimatedata. It reads the metadata, calculates the offsets, and loops the request until it retrieves the full requested historical range.

Q: Do I need to manually configure NOAA API parameters in Windsurf?

No, Cascade handles the parameters. It queries listdataclasses and listdatatypes to discover the correct parameters for you, then feeds them directly into the data retrieval tools.

Pull historical weather records directly into Cascade and let Windsurf chain multi-step climate analysis without manual steps.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect NCDC Climate Data Online MCP to Windsurf

Create your Vinkius account to connect NCDC Climate Data Online 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 NCDC Climate Data Online with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-step climate data queries in Windsurf

The `get_climate_data` tool retrieves historical weather records directly from NOAA databases. In Windsurf, Cascade uses this tool by first mapping geographic coordinates to specific weather stations before pulling the raw observation data. Cascade reads your context, targets the correct region, and automatically runs the queries in sequence. It executes the entire lookup loop—from finding the station to downloading the records—without waiting for your permission at each step.

Automated weather station discovery

The `list_stations` tool identifies active weather monitoring stations near your target coordinates. Cascade chains this with `list_locations` to map out the exact geographical boundaries of your study area. Instead of making you copy and paste station IDs, this MCP Server lets Cascade resolve IDs on the fly. The agent inspects the metadata, filters out inactive stations, and passes the clean IDs straight to the next analytical step.

Dataset and variable mapping

The `list_datasets` tool exposes the available climate databases like GHCND or GSOD. Cascade queries this alongside `list_data_types` and `list_data_categories` to match your prompt with the exact scientific variables you need. This MCP Server maps your natural language requests to specific scientific keys. You ask for precipitation trends, and Cascade resolves the variable codes, checks the dataset bounds via `get_dataset`, and prepares the data payload.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "ncdc-climate-data-online-1-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 NCDC Climate Data Online. 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 NCDC Climate Data Online 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 NCDC Climate Data Online MCP in Windsurf

You ask Cascade to find a dataset, and it runs `list_datasets` to find options like GSOD or GHCND. It then uses `get_dataset` to check the date ranges and coverage.

Yes, this server exposes `list_locations` and `list_location_categories` to narrow down geographic regions. Cascade uses these tools to find the city's location ID and then calls `list_stations` to pinpoint active hardware.

Cascade handles pagination automatically when calling `get_climate_data`. It reads the metadata, calculates the offsets, and loops the request until it retrieves the full requested historical range.

No, Cascade handles the parameters. It queries `list_data_classes` and `list_data_types` to discover the correct parameters for you, then feeds them directly into the data retrieval tools.

Your historical weather queries and station metadata stay inside Windsurf's local sandbox environment. Vinkius routes the MCP API requests through a secure, isolated endpoint token, keeping your research parameters private.

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