# Weatherbit MCP

> Weatherbit provides real-time, hyper-local environmental intelligence for your agent. You can pull 16-day forecasts, current air quality metrics, active severe weather alerts, and pinpoint lightning strikes anywhere in the world. It gives your AI client the full context—from temperature to pollution levels—needed to make location-based decisions.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** weather-forecast, air-quality, weather-alerts, meteorology, lightning-data

## Description

This MCP lets you get deep, real-time environmental data directly into your workflow. Need to know if a delivery route will be flooded or choked by poor air quality? You'll ask your agent, and it pulls the current weather observations, checks for active severe alerts, and confirms the pollution levels—all from one place. If your application needs to combine weather context with other services, like scheduling or logistics management, you can chain this MCP with others in the Vinkius catalog to build complex automations. Because all these calls run through Vinkius, every step generates a cryptographically signed audit trail; that means you always have a tamper-proof record of what data was pulled and when. It’s environmental intelligence without the manual API hopping.

## Tools

### get_airquality_forecast
Predict the air quality metrics for an area up to three days into the future, hour by hour.

### get_alerts
Check local authorities for active severe weather warnings using a city, postal code, or coordinates.

### get_current_airquality
Fetch the immediate air quality readings and AQI index for a given location.

### get_current_lightning
Find the coordinates of the nearest lightning strikes happening right now.

### get_current_weather
Get real-time observations like temperature, wind, and rain for a location.

### get_daily_forecast
Retrieve the full 16-day weather outlook for an area on a daily basis.

### get_daily_history
Pull all historical daily weather data between two specific dates.

### get_geocode
Convert names like cities or postal codes into usable latitude and longitude coordinates.

### get_hourly_forecast
Get detailed weather predictions, hour by hour, for up to ten days.

### get_hourly_history
Download historical weather data that is tracked hourly between two specific dates and times.

### get_minutely_forecast
Predict precipitation amounts for the next hour, minute by minute.

### get_normals
Look up long-term climate averages (1991-2020) for a specific date range.

### get_subhourly_history
Retrieve detailed historical weather measurements that track changes between standard hours and days.

### get_subscription_usage
Check how much of your subscription quota you've used so far.

## Prompt Examples

**Prompt:** 
```
What's the current weather and air quality in Tokyo?
```

**Response:** 
```
In Tokyo, it's currently 18°C with clear skies. The Air Quality Index (AQI) is 42, which is considered Good.
```

**Prompt:** 
```
Check for any severe weather alerts in Paris.
```

**Response:** 
```
I've checked the local agencies for Paris. There is currently a Yellow Alert for heavy rainfall expected this evening.
```

**Prompt:** 
```
Give me a 16-day daily forecast for Berlin.
```

**Response:** 
```
Fetching the 16-day outlook for Berlin... Temperatures will range from 10°C to 15°C over the next week with intermittent showers starting Wednesday.
```

## Capabilities

### Get real-time conditions
Fetch current observations, including temperature, wind speed, and precipitation, for any location.

### Predict weather over time
Access detailed forecasts ranging from 16-day daily outlooks to minute-by-minute precipitation predictions.

### Monitor air quality
Check current and forecasted air pollution metrics (like PM2.5 and AQI) for specific areas.

### Track dangerous weather events
Retrieve active severe weather warnings or locate the nearest lightning strikes by coordinates.

### Analyze historical climate data
Pull past weather records, including daily, hourly, and sub-hourly measurements for deep analysis.

## Use Cases

### Planning an outdoor festival
The operations team asks their agent: 'What's the risk profile for our event next week?' The agent checks `get_daily_forecast` to see temperature swings, runs `get_alerts` to check for severe weather warnings, and calls `get_airquality_forecast` to ensure air quality is safe. It gives a single, comprehensive risk report.

### Designing a shipping schedule
A supply chain manager asks: 'When should we ship the parts to Miami?' The agent runs `get_current_weather` and checks for active severe weather alerts in that region. If there's a storm warning, it advises delaying until conditions improve.

### Health monitoring app
The developer needs to warn users about pollution spikes. They combine `get_current_airquality` with `get_minutely_forecast` to give real-time warnings that account for both current smog and incoming poor air quality.

### Forecasting seasonal changes
A climate scientist needs to compare this year's data to the norm. They use `get_daily_history` for the last 30 days, then run that against `get_normals` to calculate a deviation score.

## Benefits

- Need to plan a multi-day event? Instead of checking 16 separate forecast pages, you can call `get_daily_forecast` once and get the entire outlook. You save hours of manual data gathering.
- Your agent instantly knows if it's safe for outdoor work. It combines `get_current_weather` with `get_alerts` to tell you about simultaneous rain and severe warnings.
- Tracking pollution is simple. Use `get_current_airquality` to check the immediate AQI, or use `get_airquality_forecast` if you need to warn people about upcoming poor air quality days.
- Analyzing trends is powerful. Instead of guessing historical patterns, you can pull data from `get_daily_history` and compare it against long-term averages using `get_normals`.
- You don't have to worry about how your agent calls the tools. Vinkius handles the security and tracking; every single call is auditable via its secure proxy.

## How It Works

The bottom line is you get actionable environmental context without writing complex API code.

1. Subscribe to this MCP on Vinkius and provide your unique Weatherbit API Key.
2. Your agent sends a natural language query asking for weather data (e.g., 'What's the forecast in Denver?').
3. The system executes the necessary tool calls, returning structured data that your client uses immediately.

## Frequently Asked Questions

**How do I find out if there are active warnings using get_alerts?**
You pass a location identifier (city, postal code, or lat/lon) to `get_alerts`. The tool returns any live severe weather alerts issued by local agencies for that area.

**Do I have to use get_geocode before getting current weather?**
Not always. You can pass a city name, but if you need precision, it's safer to first run `get_geocode` with the location and then feed those coordinates into `get_current_weather`.

**What is the difference between get_hourly_forecast and get_minutely_forecast?**
`get_hourly_forecast` gives predictions for weather variables (like rain probability) hour by hour. Use `get_minutely_forecast` when you need precise, minute-by-minute precipitation amounts.

**Can I check historical data before getting daily history?**
You don't. You simply call `get_daily_history` and provide the start and end dates (YYYY-MM-DD) to pull all required weather metrics for that period.

**What exactly does the `get_normals` tool provide for long-term climate context?**
It delivers historical climate normals based on a 1991-2020 dataset. This means you get average conditions across those decades, not what happened during any single year.

**When running `get_current_weather`, how are my location credentials handled by Vinkius?**
Vinkius handles your keys through a zero-trust proxy. Your actual API key is only used in transit and never stored on disk, keeping your connection secure.

**If my agent hits a rate limit while calling `get_airquality_forecast`, what should I do?**
You'll receive an explicit error message indicating the rate limit. You must implement exponential backoff and retry the call after a short delay, or check your usage via `get_subscription_usage`.

**How can I use `get_daily_forecast` to build out a detailed planning report?**
This tool gives you the 16-day outlook for broad planning. For deeper detail on specific days, chain it with tools like `get_hourly_forecast` or `get_minutely_forecast`.

**Can I get a detailed hourly forecast for the next few days?**
Yes, use the `get_hourly_forecast` tool with lat/lon coordinates to get up to 240 hours of detailed weather data.

**How do I check for severe weather warnings in my city?**
Use the `get_alerts` tool with your city name or postal code to retrieve active alerts from local meteorological agencies.

**Can the agent monitor air quality levels?**
Absolutely. Use `get_current_airquality` for real-time data or `get_airquality_forecast` for a 3-day hourly outlook on pollutants like PM2.5 and Ozone.