How to Use the Meteostat MCP in Windsurf

Q: How does Windsurf run Meteostat queries?

Windsurf executes tools like pointdaily directly when you ask Cascade to analyze weather trends in your code. You do not need to write API wrappers because Cascade reads the tool schema and runs the queries autonomously.

Q: Can I fetch high-frequency records using Meteostat inside Windsurf?

Yes, you can pull granular metrics using pointhourly and stationshourly. Cascade manages the 30-day limit per request by automatically chunking your queries into sequential calls.

Q: How do I configure the Meteostat MCP Server in my Windsurf settings?

Add the server configuration to your mcpconfig.json file under the mcpServers key. Windsurf instantly discovers all ten weather tools as soon as you save the file and refresh the panel.

Q: What is the limit for historical station data queries?

The stationsdaily tool limits requests to 10 years of data at a time. Cascade simply loops the tool across larger date ranges if you need a longer historical baseline.

Give Cascade the historical weather data it needs to build and test weather-dependent applications in Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Meteostat MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map local weather stations directly in Windsurf

The `stations_nearby` tool finds physical weather stations close to any latitude and longitude coordinates you feed it. Cascade uses these coordinates to locate the nearest hardware, then instantly queries `stations_meta` to verify station operational status and identifiers. Instead of manually searching for station IDs, you tell Cascade to analyze a region. The agent chains these tools to build a local weather grid, pulling exact station histories without you writing a single API query.

Chain historical weather points in Cascade

The `point_daily` and `point_hourly` tools fetch raw temperature, precipitation, and wind records for any coordinate on the globe. Cascade automatically parses these payloads to feed your local data models or backtesting scripts. While other IDEs make you copy-paste JSON payloads, this MCP Server lets your agent pull 30 years of climate history directly into your active workspace. Cascade reads the output, spots the trends, and updates your code files in one run.

Build climate-aware apps with Windsurf

The `point_normals` and `stations_normals` tools deliver thirty-year climate averages to establish baseline weather expectations. Cascade uses these baselines to write comparison logic, automatically checking current trends against historical norms. You get clean, structured climate records without leaving your editor. Connect this MCP Server to your workspace, and Cascade sets up the database schemas, writes the ingestion scripts, and tests the integration using actual historical data points.

Setup guide

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

mcp_config.json

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

Windsurf executes tools like `point_daily` directly when you ask Cascade to analyze weather trends in your code. You do not need to write API wrappers because Cascade reads the tool schema and runs the queries autonomously.

Yes, you can pull granular metrics using `point_hourly` and `stations_hourly`. Cascade manages the 30-day limit per request by automatically chunking your queries into sequential calls.

Add the server configuration to your `mcp_config.json` file under the `mcpServers` key. Windsurf instantly discovers all ten weather tools as soon as you save the file and refresh the panel.

The `stations_daily` tool limits requests to 10 years of data at a time. Cascade simply loops the tool across larger date ranges if you need a longer historical baseline.

No, only the specific latitude, longitude, and date parameters are sent to the weather API. Your workspace files and proprietary logic remain fully contained inside your local Windsurf editor.

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