# OpenWeatherMap MCP for AI Agents AI Agent Connect

> OpenWeatherMap gives your AI agent real-time access to global weather, 5-day forecasts, and air quality metrics. It handles geocoding so your agent can turn city names into coordinates or vice versa instantly. Use it to build weather-aware apps, plan logistics, or monitor environmental conditions across the globe without manual data fetching.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_YcT1KfzZHhhhd7qMcoeqye83Rc0vL4WCzMhLIs7K/ai-agent-connect
- **Tags:** meteorology, weather-forecast, air-quality, real-time-data, geospatial, environmental-data

## Description

OpenWeatherMap lets your AI agent pull live meteorological data from around the world without you having to switch tabs or copy-paste figures. If you need to know the current temperature, humidity, or wind speed in a specific city, your agent can grab those numbers in seconds. It also handles 5-day forecasts and deep-dive hourly projections, which is a huge win for anyone planning travel or coordinating outdoor events. Beyond just the weather, it pulls air quality metrics like PM2.5 and CO levels, making it useful for environmental monitoring. It even takes care of the geocoding heavy lifting, turning city names into coordinates and vice versa so your agent always knows exactly where a location is. This Connector is a staple in the Vinkius catalog for anyone who needs reliable, real-time environmental context in their workflows. You get a direct line to global data, allowing your agent to make better decisions based on what's actually happening outside.

## Tools

### get_air_pollution
Get current air pollution data including PM2.5 and CO levels. This helps you check air safety in specific cities.

### get_current_weather
Fetch live temperature, humidity, and wind speed. It gives your agent an instant snapshot of current conditions.

### direct_geocoding
Turn city names or zip codes into coordinates. This is perfect for mapping out locations in a list.

### get_forecast
Pull a 5-day, 3-hour forecast for any location. Use it to plan upcoming events or travel schedules.

### get_onecall
Access One Call API 3.0 for 48-hour hourly and 8-day daily data. It is the best choice for deep meteorological planning.

### reverse_geocoding
Convert coordinates back into city names. Use this to identify locations from raw GPS data.

## Prompt Examples

**Prompt:** 
```
What's the weather like in New York right now?
```

**Response:** 
```
Here is the current weather for New York City:

| Metric | Value |
| :--- | :--- |
| **Temperature** | 72°F |
| **Humidity** | 45% |
| **Wind Speed** | 10 mph |
| **Conditions** | Partly Cloudy |

The air feels comfortable right now with a light breeze.
```

**Prompt:** 
```
Give me a 5-day forecast for Paris.
```

**Response:** 
```
Here is the 5-day outlook for Paris:

* **Monday:** High 78°F, Low 65°F (Sunny)
* **Tuesday:** High 76°F, Low 64°F (Cloudy)
* **Wednesday:** High 74°F, Low 63°F (Light Rain)
* **Thursday:** High 75°F, Low 62°F (Partly Cloudy)
* **Friday:** High 77°F, Low 64°F (Sunny)

It looks like Wednesday will be the wettest day of the week.
```

**Prompt:** 
```
Is the air quality okay in Beijing?
```

**Response:** 
```
I checked the current air quality for Beijing:

* **Air Quality Index:** 152 (Unhealthy for Sensitive Groups)
* **PM2.5:** 120.5 μg/m³
* **CO:** 350.2 μg/m³
* **Ozone:** 45.0 μg/m³

It is recommended to limit outdoor activities today if you have respiratory sensitivities.
```

## Capabilities

### Get live temperature and humidity
Your agent pulls current weather stats for any city or coordinate instantly.

### Pull 5-day weather forecasts
Access a 3-hour interval forecast spanning five days for better planning.

### Access hourly weather data
Get 48-hour hourly and 8-day daily projections via the One Call API.

### Check local air pollution levels
Retrieve real-time data on PM2.5, PM10, and CO for environmental monitoring.

### Convert city names to coordinates
Turn names or zip codes into precise latitude and longitude points.

### Turn coordinates into city names
Identify the city or region associated with a specific set of coordinates.

## Use Cases

### Avoiding storm delays in trucking
A logistics manager asks the agent to check for storms on a specific route. The agent uses get_current_weather to find hazards and suggests a detour.

### Scheduling outdoor photoshoots
A travel blogger asks for a 5-day forecast in Tokyo. The agent uses get_forecast to identify the clearest days for their itinerary.

### Mapping pollution hotspots
A researcher asks for the air quality at several GPS points. The agent uses get_air_pollution to compile a list of high-risk areas.

### Building weather-aware home apps
A developer builds a script that adjusts a home's AC based on local conditions. The agent uses get_current_weather to provide the data.

## Benefits

- Stop manual lookups with get_current_weather to get live conditions instantly.
- Plan long-term travel with get_forecast to see the 5-day outlook.
- Track environmental safety using get_air_pollution for PM2.5 and CO levels.
- Map out locations accurately using direct_geocoding to turn names into coordinates.
- Handle precise GPS data with reverse_geocoding to identify cities from coordinates.
- Get hyper-local data with get_onecall for 48-hour hourly projections.

## How It Works

The bottom line is your agent gets instant access to global weather and geocoding data without any manual searching.

1. Subscribe to the Connector and get your OpenWeatherMap API key.
2. Paste your API key into your AI client settings.
3. Ask your agent about the weather or air quality in any location.

## Frequently Asked Questions

**Can OpenWeatherMap MCP give me live weather?**
Yes, it provides real-time weather data including temperature, humidity, and wind speed for any location worldwide.

**How do I get air quality data with OpenWeatherMap MCP?**
The Connector can pull current pollution levels like PM2.5 and CO, which helps you monitor environmental conditions instantly.

**Can OpenWeatherMap MCP turn city names into coordinates?**
Yes, it includes geocoding tools that let your agent convert city names or zip codes into precise latitude and longitude points.

**Does OpenWeatherMap MCP support 5-day forecasts?**
It provides a 5-day forecast with 3-hour intervals, making it easy to plan for upcoming weather changes.

**Can I use OpenWeatherMap MCP for my logistics app?**
Absolutely. It is perfect for logistics by providing real-time weather updates and geocoding for route planning.

**How does OpenWeatherMap MCP handle different countries?**
It provides global coverage, allowing you to fetch weather and air quality data for almost any country or coordinate on earth.

**How do I get a comprehensive weather report including hourly and daily forecasts?**
Use the `get_onecall` tool with latitude and longitude. It provides current data, 48-hour hourly forecasts, and 8-day daily forecasts in a single request.

**Can I check the air quality for a specific location?**
Yes, the `get_air_pollution` tool returns real-time data for pollutants including CO, NO2, O3, and particulate matter (PM2.5/PM10) for any coordinates.

**How do I find coordinates for a city name to use with the weather tools?**
Use the `direct_geocoding` tool. Simply provide the city name (and optionally state/country), and it will return the latitude and longitude needed for tools like `get_onecall`.