How to Use the Weatherbit MCP in Windsurf

Q: What is the scope of historical data from Weatherbit in Windsurf?

The gethistoricalweather tool pulls data covering temperature, wind, and precipitation metrics for dates going back 30 years. You just need to specify the coordinates and time range.

Q: Does Weatherbit provide alerts when using Windsurf?

Yes. It runs getweatheralerts by coordinates, returning alert type, severity, descriptions, and effective/expiry times. This keeps you immediately updated on local hazards.

Get real-time and historical weather data right inside your IDE using Windsurf's built-in MCP Server access.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Weatherbit MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Environmental Data Gathering

Cascade handles the complexity of environmental checks. You just set a goal—like 'check air quality in Downtown.' It runs `get_air_quality` and gives you the AQI score, PM2.5, and health recommendations instantly. It even knows to check for severe conditions if they exist nearby. Running `get_weather_alerts` alongside the air quality report means your whole environment is covered in one go.

Build Multi-Step Weather Forecasts

Need a full picture of next week's weather? Windsurf can chain these calls. First, it pulls the big picture using `get_forecast_daily_by_city` for up to 16 days. Then, if you need more detail for tomorrow, it pivots and runs `get_forecast_hourly_by_city`. This means your agent handles both high-level planning and granular execution without you having to prompt each step.

Deep Dive into Historical Records

Don't just look at today’s temperature. You can ask for historical trends, letting Cascade call `get_historical_weather`. This tool returns metrics like wind speed and precipitation for dates stretching back 30 years. It lets you compare current conditions against decades of data simply by specifying coordinates.

Setup guide

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

mcp_config.json

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

You prompt Cascade to check air quality at specific coordinates. It runs `get_air_quality` and provides a detailed report including the AQI score, PM2.5 concentrations, and any health guidance you need.

Absolutely. You can ask for the daily forecast by city or coordinates using `get_forecast_daily`. This gives you high/low temperatures, precipitation probability, and sunrise/sunset times for up to 16 days out.

The `get_historical_weather` tool pulls data covering temperature, wind, and precipitation metrics for dates going back 30 years. You just need to specify the coordinates and time range.

Yes. It runs `get_weather_alerts` by coordinates, returning alert type, severity, descriptions, and effective/expiry times. This keeps you immediately updated on local hazards.

The server handles public weather metrics, including temperature, precipitation probability, humidity, wind speed, and air quality index (AQI) scores derived from coordinates or city names.

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