# Weatherbit MCP

> Weatherbit provides global, real-time weather data directly to your AI client. Get current conditions, 16-day forecasts, hourly predictions, and historical climate metrics for any location worldwide. It also tracks air quality indexes (AQI) and active severe storm warnings.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** weather-forecast, meteorological-data, air-quality, real-time-weather, climate-data

## Description

Need reliable environmental data? This MCP connects you to global weather information so your agent can analyze it through natural conversation. You can check current conditions—temperature, wind, humidity—either by coordinates or a city name. Planning a trip? Use the daily forecast tool to see high/low temperatures and precipitation probability up to 16 days out. For deep dives, pull historical data spanning over 30 years. The system also tracks air quality metrics like PM2.5 and Ozone levels in addition to providing active severe weather alerts. All this global data is managed and cataloged on Vinkius, making it accessible instantly from any MCP-compatible client.

## Tools

### get_air_quality
Retrieves the Air Quality Index (AQI) score and concentrations for key pollutants like PM2.5 or Ozone at given coordinates.

### get_current_weather
Provides immediate weather details, including temperature, wind speed/direction, and visibility, using geographical coordinates.

### get_current_weather_by_city
Returns current conditions like humidity and UV index when you only know the city name.

### get_forecast_daily
Generates a daily forecast showing high/low temperatures, weather type, and precipitation probability by coordinates.

### get_forecast_daily_by_city
Gets a 16-day outlook covering temperature ranges and general conditions using just the city name.

### get_forecast_hourly
Delivers hour-by-hour data on temperature, wind, and cloud cover for detailed short-term planning by coordinates.

### get_forecast_hourly_by_city
Provides an hourly prediction of conditions, including precipitation and wind, using a city name lookup.

### get_historical_weather
Pulls historical weather data for specific metrics spanning the last 30 years by coordinates.

### get_severe_weather
Queries reports detailing recent severe weather activity, such as documented hailstorms or flooding events in a region.

### get_weather_alerts
Retrieves active official warnings and watches regarding dangerous weather conditions affecting specific coordinates.

## Prompt Examples

**Prompt:** 
```
What's the weather in London today?
```

**Response:** 
```
London: 15°C (feels 13°C), light rain, 78% humidity, wind 12 km/h NE. Cloud cover 85%. UV index 2 (low). Sunrise 06:42, Sunset 18:15.
```

**Prompt:** 
```
Give me the 5-day forecast for Tokyo.
```

**Response:** 
```
Tokyo 5-day forecast: Mon 22°C/14°C ☀️, Tue 20°C/13°C ⛅, Wed 18°C/12°C 🌧️, Thu 21°C/14°C ⛅, Fri 23°C/15°C ☀️.
```

**Prompt:** 
```
What's the air quality in São Paulo?
```

**Response:** 
```
São Paulo AQI: 65 (Moderate). PM2.5: 19 μg/m³, PM10: 38 μg/m³, O3: 42 ppb. Sensitive groups should limit outdoor activity.
```

## Capabilities

### Get current conditions
Retrieve real-time details including temperature, wind speed/direction, humidity, and precipitation for a specific location.

### Generate multi-day forecasts
Fetch daily predictions showing high and low temperatures, weather type, and chance of rain over the next two weeks.

### Analyze hourly trends
Obtain detailed hour-by-hour data on temperature, wind, and cloud cover for immediate planning.

### Check historical climate records
Access past weather measurements, including temperature and rainfall, dating back decades for research purposes.

### Monitor air pollution levels
Read detailed readings on common pollutants like PM2.5, Ozone (O3), and Carbon Monoxide (CO) to assess local air health.

### Track severe weather events
Query active alerts or recent reports for dangerous conditions like tornadoes, floods, or high winds.

## Use Cases

### Planning a remote construction site visit
An ops manager asks their agent: 'What's the forecast for Site X next week, and is the air quality okay?' The agent uses `get_forecast_daily_by_city` to check temperatures and then runs `get_air_quality` to ensure workers can safely operate outdoors.

### Analyzing long-term agricultural trends
A researcher needs to prove a correlation between drought severity and crop yield. They ask the agent to pull 30 years of data using `get_historical_weather` for that specific region, allowing them to build a solid dataset.

### Responding to an immediate storm threat
A dispatcher asks: 'Is there any severe weather impacting Sector Beta right now?' The agent immediately runs `get_weather_alerts` and uses `get_severe_weather` to provide actionable, current safety information.

### Optimizing a local outdoor event
A festival organizer needs hourly details. They ask the agent for `get_forecast_hourly_by_city` to track potential wind shifts and rain probability throughout the day, letting them make real-time decisions on setup.

## Benefits

- Stop checking separate sites for pollution and weather. This MCP bundles air quality readings (PM2.5, Ozone) right alongside real-time conditions using the `get_air_quality` tool.
- Need to plan beyond a few days? The daily forecast tools give you up to 16 full days of predictions, letting you see temperature ranges and rain chances for an entire trip.
- Climate researchers can pull deep metrics. Use `get_historical_weather` to access accurate data spanning thirty years, making longitudinal studies simple.
- You don't need coordinates every time. Both current weather tools let your agent get conditions just by knowing the city name, saving you a step.
- Safety planning is easier. Instead of guessing, use `get_weather_alerts` to pull official warnings and watches for dangerous severe weather in an area.

## How It Works

The bottom line is that you just talk to your AI client and it pulls complex environmental data from the cloud for you.

1. Subscribe to this MCP and input your Weatherbit API Key.
2. Your agent calls the desired function, passing coordinates or a city name as required.
3. The data returns specific metrics, like current temperature or 16-day forecasts, directly into your chat window.

## Frequently Asked Questions

**Can Weatherbit MCP give me air quality data for my location?**
Yes. Use the `get_air_quality` tool to pull specific pollutant metrics like PM2.5, Ozone (O3), and CO concentrations based on coordinates.

**How far into the future can I use get_forecast_daily_by_city?**
The `get_forecast_daily_by_city` tool provides daily forecasts for up to 16 days, giving you a full two-week outlook.

**What kind of historical data does get_historical_weather provide?**
This function accesses decades of weather records. You can retrieve metrics like temperature, wind speed, and precipitation for dates spanning the last 30 years by coordinates.

**Does Weatherbit MCP warn me about storms?**
Yes. Use `get_weather_alerts` to get active official warnings for severe conditions, or use `get_severe_weather` to query reports on recent events like floods or tornadoes.

**Can I check the weather using just a city name?**
Absolutely. You can use both `get_current_weather_by_city` and `get_forecast_daily_by_city` to get conditions without needing precise coordinates.