# QWeather MCP

> QWeather / 和风天气 provides professional environmental monitoring and forecasting, giving your AI client instant access to real-time air quality indices, detailed weather forecasts up to 15 days out, and specialized life index data. It lets you run complex location searches and audit severe weather warnings—all through a simple conversation with your agent.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** weather-forecast, environmental-data, air-quality, life-indices, real-time-data, api-integration

## Description

Stop switching between climate websites and environmental dashboards just to check the forecast. This MCP connects your AI client directly to QWeather's commercial platform, turning massive amounts of meteorological data into plain English answers. You can ask your agent for current air quality in Shanghai, or compare the 7-day weather outlook against the predicted UV index—all without knowing an API call. It functions as a unified environmental consultant, giving instant insights into everything from PM2.5 levels to whether you need sunscreen today. By connecting this through Vinkius, your agent gets access to China's leading weather data provider, letting you audit air quality or plan outdoor logistics simply by asking questions.

## Tools

### get_air_now
Retrieves the current air quality index and particulate levels for a specified area.

### get_indices
Gathers specialized daily environmental indices, such as UV radiation or suitability recommendations.

### get_moon_astronomy
Calculates and reports the precise times for moonrise and moonset at a given location.

### get_sun_astronomy
Provides accurate local times for sunrise and sunset, useful for scheduling outdoor work.

### get_warning
Checks for any active severe weather warnings in a defined region to maintain safety awareness.

### get_weather_24h
Fetches a detailed forecast covering the next 24 hours, including temperature changes and conditions.

### get_weather_3d
Retrieves a concise three-day weather overview for quick planning decisions.

### get_weather_7d
Provides a comprehensive seven-day forecast, ideal for weekly operational planning.

### get_weather_now
Gets the most up-to-the-minute weather conditions at a specified coordinate or location.

### lookup_location
Searches for and returns the necessary location ID using descriptive keywords or names.

## Prompt Examples

**Prompt:** 
```
What is the current weather in Beijing (101010100)?
```

**Response:** 
```
The current weather in Beijing is clear with a temperature of 22°C. The humidity is 45% and the air quality is excellent (AQI: 35). Would you like to see the forecast for the next 3 days?
```

**Prompt:** 
```
Check the air quality for Shanghai today.
```

**Response:** 
```
I've retrieved the air quality for Shanghai. The current AQI is 75 (Moderate). PM2.5 levels are at 25 μg/m³. Outdoor activities are generally safe, but sensitive individuals should monitor the situation.
```

**Prompt:** 
```
Find the location ID for 'Hangzhou'.
```

**Response:** 
```
I've found the location ID for Hangzhou. The ID is `101210101`. It is located in Zhejiang, China. I can now use this ID to retrieve detailed weather or air quality data for you.
```

## Capabilities

### Get Current Environmental Status
Retrieve real-time information on current temperature, humidity, and the most up-to-date air quality index for any location.

### Forecast Future Conditions
Pull detailed weather predictions spanning 3 days, 7 days, or even a full 15-day outlook for planning purposes.

### Assess Environmental Impact
Access specialized life indices, including UV radiation levels and recommendations for clothing or outdoor activities.

### Monitor Safety Risks
Check for active severe weather warnings against a specific location to ensure operational safety.

### Determine Celestial Events
Find precise timings for sunrise, sunset, moonrise, and moonset across different geographical points.

### Locate Specific Areas
Search by name or keyword to find a specific location ID required for detailed data retrieval.

## Use Cases

### Auditing a site before construction starts
An HSE manager needs to know if the air quality permits work. They ask their agent, 'What is the current AQI and what's the PM2.5 level in Sector B?' The agent uses `get_air_now` and immediately returns safe operating parameters, eliminating a 30-minute manual check of government portals.

### Planning a multi-day outdoor event
An operations planner needs to confirm the weather for a three-day festival. They ask their agent to pull the `get_weather_3d` forecast and also use `get_sun_astronomy` to schedule activities around peak daylight hours, giving them a complete timeline.

### Developing location intelligence software
A developer needs to integrate weather data for a new app. Instead of figuring out the precise ID, they use `lookup_location` with just a city name, getting the correct ID that can then power all future calls like `get_weather_now`.

### Preparing an emergency briefing
A crisis manager needs to summarize current risks. They instruct their agent to check both active warnings via `get_warning` and the immediate air quality using `get_air_now`, compiling a single, actionable risk report instantly.

## Benefits

- Audit air quality instantly. Instead of visiting multiple government sites to check PM2.5 or AQI, use the `get_air_now` tool to get a single reading for any region.
- Plan weeks ahead with confidence. Need to know if outdoor construction is viable next week? The 7-day forecast and 15-day outlook give you long-range planning data without complex filtering.
- Safety first, always. Before deploying teams, run the `get_warning` tool to check for active severe weather alerts, ensuring immediate operational continuity.
- Beyond temperature checks. Use `get_indices` to look up specialized metrics like UV radiation or even car washing suitability, adding depth to your daily reports.
- Saves time on setup. If you're unsure of the correct location ID, use `lookup_location` first; it finds the exact coordinates so all subsequent calls are accurate.

## How It Works

The bottom line is that you get complex, reliable environmental data delivered instantly through conversation, not through dashboard clicks.

1. Subscribe to this MCP and provide your QWeather API key, selecting the appropriate plan (dev, free, standard, etc.).
2. Your AI client authenticates the connection through Vinkius, making all environmental tools available.
3. You ask your agent a natural language question—for example, 'What's the 7-day forecast and air quality in Beijing?'—and it executes the necessary data retrieval.

## Frequently Asked Questions

**How do I start with QWeather / 和风天气 MCP?**
You must first subscribe to the service and provide your API key through Vinkius. After that, you can query any environmental data using natural language prompts.

**Can QWeather / 和风天气 MCP forecast for more than a week?**
Yes, it provides forecasts up to 15 days out, giving you long-term planning ability that goes beyond the standard 7-day view.

**What do I use if I don't know the location ID for my area?**
You use the `lookup_location` tool. You just provide a keyword like 'Hangzhou,' and it returns the specific, required location ID for all subsequent data calls.

**Is QWeather / 和风天气 MCP only for Chinese locations?**
No, while it's built on leading Chinese data, it supports global forecasts and environmental checks across various regions.

**How do I check if severe weather is happening with QWeather / 和风天气 MCP?**
You call the `get_warning` tool. This immediately audits active severe weather warnings against your target location, ensuring you don't miss critical safety alerts.