# OpenWeather MCP for AI Agents AI Agent Connect

> OpenWeather provides real-time weather data, 16-day forecasts, and air quality metrics directly to your AI agent. Get precise conditions, severe weather alerts, and historical climate data for any location worldwide. It's the go-to tool for travel planning, outdoor event logistics, and environmental research.

## Overview
- **Category:** iot-hardware
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_fd4Ucr3pC3i2w7oVZ4mB9tPgNJUJVy6c6Lp7SZiH/ai-agent-connect
- **Tags:** weather-forecast, air-quality, real-time-data, meteorology, climate-data

## Description

Imagine you're planning a multi-city tour or organizing an outdoor festival. Instead of toggling between different weather websites and copying data into your notes, you can just ask your agent for the latest conditions. This Connector bridges that gap, pulling live data from OpenWeather so you can get immediate answers about temperature, humidity, and precipitation. If you need to know the air quality in a specific city for a health-conscious trip, or if you're looking for the exact sunrise time for a photography shoot, it handles those requests in seconds. It even handles the heavy lifting of geocoding, turning city names into the coordinates needed for precise readings. Being part of the Vinkius catalog makes it easy to plug into your existing setup, letting you focus on the logistics while your agent handles the meteorological details. You get a clear picture of the environment, from 48-hour hourly forecasts down to historical trends from years ago, all through a natural conversation.

## Tools

### get_sun_times
Returns the exact sunrise and sunset times along with the sun's elevation angle. Great for photography and solar planning.

### geocode
Converts a city name into the top 5 matching locations with coordinates and country codes. Use this to get precise locations first.

### get_current_weather
Returns real-time temperature, humidity, wind, and visibility for a city or set of coordinates. Get instant updates.

### get_daily_forecast
Provides daily weather descriptions and min/max temperatures for up to 16 days. Perfect for long-term trip planning.

### get_hourly_forecast
Delivers an hourly forecast including precipitation probability and UV index for the next 48 hours. Use this for precise timing.

### get_weather_alerts
Fetches active severe weather warnings, including severity and start/end times. Stay informed about dangerous conditions.

### reverse_geocode
Converts a set of coordinates back into a city name, state, and country. Use this to identify locations from raw data.

### get_air_quality
Retrieves the current AQI and pollutant levels like PM2.5 and O3 for a specific location. It's useful for health monitoring.

### get_air_quality_forecast
Provides a 4-day air quality forecast including AQI levels and specific pollutant concentrations. Plan ahead for air quality.

### get_forecast
Gets a 5-day/3-hour weather forecast including temperature, humidity, and wind pressure. Good for short-term planning.

### get_historical_weather
Fetches temperature, humidity, and conditions for a specific past date in YYYY-MM-DD format. Use this for climate research.

## Prompt Examples

**Prompt:** 
```
What's the weather like in Tokyo for my trip next week?
```

**Response:** 
```
Here is the 7-day forecast for Tokyo:

| Day | Temp (High/Low) | Condition | Rain % |
| :--- | :--- | :--- | :--- |
| Mon | 22°C / 15°C | Rain | 80% |
| Tue | 19°C / 14°C | Cloudy | 20% |
| Wed | 21°C / 16°C | Partly Cloudy | 10% |
| Thu | 23°C / 17°C | Sunny | 0% |
| Fri | 24°C / 18°C | Sunny | 0% |

**Summary:** Expect some rain early in the week, clearing up by Thursday for some great sunshine.
```

**Prompt:** 
```
Is the air quality safe for a run in Beijing right now?
```

**Response:** 
```
Beijing's current air quality is **Poor**.

*   **AQI Level:** 4
*   **PM2.5:** 75 μg/m³ (3x WHO guideline)
*   **PM10:** 120 μg/m³
*   **Ozone & NO2:** Moderate

**Recommendation:** Sensitive groups should reduce outdoor exposure today.
```

**Prompt:** 
```
When is the best time for a sunset photo in Santorini?
```

**Response:** 
```
For your photography shoot in Santorini, here are the sun details:

*   **Sunset Time:** 6:45 PM
*   **Elevation Angle:** -12°
*   **Sunrise Time:** 6:12 AM

**Tip:** For the best lighting, aim to arrive about 30 minutes before the 6:45 PM sunset.
```

## Capabilities

### Get live weather conditions
Pull temperature, humidity, and wind speeds for any spot in the world.

### Check air quality levels
See current AQI and pollutant concentrations like PM2.5 and O3.

### View long-range forecasts
Access daily weather predictions for up to 16 days.

### Track severe weather alerts
Receive active warnings for dangerous weather conditions.

### Fetch historical climate data
Look up weather conditions from specific past dates.

### Find sunrise and sunset times
Get exact sun elevation and timing for any location.

### Convert locations to coordinates
Turn city names into precise lat/lon data for accurate readings.

## Use Cases

### Safety checks for travel itineraries
A travel agent needs to check if a client's destination has active severe weather alerts before booking a tour. They use get_weather_alerts to stay informed.

### Outdoor event risk management
A wedding planner asks for a 16-day daily forecast to see if the outdoor ceremony will be impacted by rain. They use get_daily_forecast for the full outlook.

### Public health advisory monitoring
A city official wants to know the current air quality and pollutant levels to issue a public health advisory. They use get_air_quality for live data.

### Climate trend analysis
A researcher needs to know the average temperature and humidity in a specific region for a date three years ago. They use get_historical_weather for the data.

## Benefits

- Stop manual tab-switching by getting live weather and alerts directly in your chat using get_current_weather.
- Plan outdoor events with confidence by checking precipitation and UV indices using get_daily_forecast.
- Monitor environmental health for specific regions with get_air_quality and get_air_quality_forecast.
- Analyze past climate patterns for research projects by pulling data with get_historical_weather.
- Simplify location lookups by automatically converting names to coordinates with geocode.
- Perfect your photography timing by getting exact sun angles and times via get_sun_times.

## How It Works

The bottom line is you get real-time meteorological data without leaving your chat interface.

1. Subscribe to the OpenWeather MCP and add your API key to your settings.
2. Connect your preferred AI client to the Vinkius platform to enable the tool.
3. Ask your agent for weather data or forecasts in plain English.

## Frequently Asked Questions

**Can I use OpenWeather MCP to check for severe weather alerts?**
Yes, the OpenWeather MCP pulls active severe weather warnings for any location. It provides the alert type, severity, and start/end times so you can stay informed about dangerous conditions.

**Does the OpenWeather MCP provide air quality data?**
Yes, it provides both current air quality indices (AQI) and 4-day forecasts. You can see specific pollutant concentrations like PM2.5, PM10, and Ozone.

**Can I get historical weather with OpenWeather MCP?**
Yes, you can fetch historical weather data for specific past dates. It returns temperature, humidity, wind, and general weather descriptions for your research.

**Does OpenWeather MCP work for any city?**
Yes, it provides global coverage. You can search for weather in almost any city or use coordinates to get precise data for specific rural locations.

**Can I get a 16-day forecast using OpenWeather MCP?**
Yes, it provides a daily forecast for up to 16 days. This is perfect for long-term planning when you need to see the general weather trend over several weeks.

**How does OpenWeather MCP handle city names?**
It uses geocoding to automatically convert city names into the coordinates required for weather data. You don't need to know the latitude or longitude yourself.

**How do I get an OpenWeather API key?**
Visit [**openweathermap.org/api**](https://openweathermap.org/api), click **Sign Up** for a free account, go to **API Keys** in your account settings, and create a new key. Copy it — it's a 32-character hex string. Free tier includes 60 calls/minute.

**Can I get weather alerts for my location?**
Yes! Use `get_weather_alerts` with lat/lon coordinates. Returns active alerts with sender name, event type, severity, description and start/end times. Useful for monitoring severe weather, floods, heat waves and other dangerous conditions.

**Can I get historical weather data?**
Yes! Use `get_historical_weather` with lat/lon and a date in YYYY-MM-DD format. Returns the weather conditions for that specific day including temperature, humidity, wind and pressure.

**How do I find coordinates for a city?**
Use `geocode` with the city name (e.g. 'London', 'São Paulo', 'Tokyo'). Returns the top 5 matching locations with their latitude, longitude, country code and state. Use these coordinates with other weather tools.