# Open-Meteo MCP

> Open-Meteo provides global weather forecasts and environmental metrics directly through your AI client, requiring zero API keys. Get real-time temperature, multi-day predictions, historical climate data dating back to 1940, comprehensive air quality reports (PM2.5, Ozone), elevation details, and location coordinates—all in one conversation.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** weather-forecast, historical-weather, air-quality, meteorology, environmental-data, open-source

## Description

Need reliable environmental data without the hassle of managing API keys or complex authentication? This MCP connects your AI client directly to Open-Meteo, giving you instant access to global weather patterns and atmospheric measurements. Whether you're tracking air pollution indices for a city or pulling historical temperature logs for climate research, you don't get stuck on setup steps. You simply ask your agent what you need, and it handles the complex data retrieval. All this information flows through Vinkius, making world-class weather data available to any compatible AI client in plain conversation. It’s pure, open-source environmental intelligence that gets results fast.

## Tools

### get_air_quality
Retrieves pollutant levels (PM2.5, Ozone, CO) and UV index forecasts for a specific location over up to seven days.

### get_elevation
Calculates the vertical height of any given coordinates, useful for mapping or hiking routes.

### get_forecast
Provides detailed weather predictions, including temperature and wind speed, for a location over multiple days.

### get_geocoding
Translates a readable place name into usable latitude and longitude coordinates needed for all other tools.

### get_historical_weather
Retrieves detailed weather metrics for a location across specific date ranges, going back to 1940.

## Prompt Examples

**Prompt:** 
```
What's the weather forecast for São Paulo this week?
```

**Response:** 
```
São Paulo (23.55°S, 46.63°W): Today 26°C/18°C, partly cloudy with 30% chance of rain. Tomorrow 24°C/17°C, light rain expected. Wednesday 22°C/16°C, overcast. Wind: 10-15 km/h. Humidity: 65-80%. UV index moderate (5-6).
```

**Prompt:** 
```
What was the temperature in Tokyo on July 15, 2024?
```

**Response:** 
```
Tokyo on July 15, 2024: High 32°C, Low 25°C. Hourly data shows temperatures peaked at 2 PM. Humidity 70%, light winds 5 km/h from the southeast. No precipitation recorded.
```

**Prompt:** 
```
What's the air quality in Beijing right now?
```

**Response:** 
```
Beijing air quality: PM2.5 at 85 μg/m³ (unhealthy for sensitive groups), PM10 at 120 μg/m³, NO2 at 45 μg/m³, O3 at 65 μg/m³. Overall AQI: 165 (Unhealthy). Sensitive groups should reduce outdoor exposure.
```

## Capabilities

### Find Coordinates
Use a place name to instantly retrieve the precise latitude and longitude needed for all other weather queries.

### Get Current Conditions
Pull real-time measurements like temperature, wind speed, humidity, and current weather codes for any location.

### Forecast Future Weather
Generate detailed forecasts that span multiple days, providing hourly breakdowns of variables up to 16 days out.

### Analyze Air Quality
Get pollutant levels, including PM2.5, Ozone, and Carbon Monoxide, along with UV index predictions for health planning.

### View Historical Data
Access archived weather records for a specific location spanning decades, going back to 1940.

### Determine Elevation
Calculate the vertical height of any given set of coordinates, useful for terrain analysis or aviation planning.

## Use Cases

### Planning a Long-Distance Hike
A guide needs to know if the trail will be wet, windy, or too hot. They first use get_geocoding to find the trailhead coordinates, then run get_forecast for the next 7 days to check wind speeds and precipitation patterns.

### Analyzing Climate Change Trends
A scientist needs to compare average summer temperatures in Paris across three different decades. They use get_historical_weather, specifying start and end dates for each period to pull the required data points.

### Evaluating Urban Pollution Risk
An urban policy analyst wants a full report on air quality for a major industrial zone. They run get_air_quality to check PM10, NO2, and O3 levels, giving them actionable data on pollution hotspots.

### Developing an Event Dashboard
A developer needs background metrics for their app. Instead of asking the user for coordinates, they run get_geocoding first to validate a city input and then pass those results directly into get_forecast to populate the dashboard.

## Benefits

- Access historical data without limits. You can use get_historical_weather to pull climate metrics for any location dating back decades, perfect for academic research.
- No authentication headaches. Since this MCP requires no API key, you never worry about rate limits or paying excessive fees just to check the daily forecast.
- Comprehensive air quality monitoring. Use get_air_quality to track multiple pollutants—like PM2.5 and Ozone—giving a full picture of local environmental health.
- Smart location prep. If you only know the city name, start with get_geocoding. It gives you the precise coordinates needed before running any other tool, preventing errors.
- Plan for terrain challenges. Need to know how high an event site is? Use get_elevation to find the ground level at specific coordinates.

## How It Works

The bottom line is that you get reliable, complex weather data from open-source sources without ever needing to worry about authentication or API limits.

1. Subscribe to this MCP in Vinkius. No API key is required; you can start asking questions immediately.
2. Tell your AI client what location and date range you need data for (e.g., 'What was the air quality in London last June?').
3. Your agent invokes the necessary tool, fetches the raw environmental metrics, and presents a clear summary back to you.

## Frequently Asked Questions

**Does Open-Meteo MCP require an API key?**
No, this MCP does not require any API keys to function. It connects directly to the open-source data stream, meaning you can start querying global forecasts immediately.

**How far back can I get historical weather using Open-Meteo?**
The tool supports historical records going all the way back to 1940 for most locations. You just need to use get_historical_weather and define your start and end dates.

**What is the difference between get_forecast and get_air_quality?**
get_forecast delivers general weather metrics like temperature, wind speed, and rain chance. get_air_quality focuses specifically on pollutant levels (PM2.5, Ozone) for environmental health reports.

**Can I use Open-Meteo MCP to find coordinates?**
Yes, if you only have a city name but need precise coordinates, use get_geocoding first. It gives you the latitude and longitude required for all other environmental tools.

**Can this MCP handle multi-variable analysis?**
Absolutely. You can combine multiple tool outputs in one request—for instance, running get_air_quality alongside get_forecast to report both pollution levels and temperature trends for a location.