# QWeather / 和风天气 MCP for AI Agents AI Agent Connect

> QWeather / 和风天气 MCP lets your AI agent pull professional weather data, air quality indices, and severe weather warnings from China's leading weather service. It handles everything from 15-day forecasts to specific life indices like UV radiation and clothing recommendations, making it easy to monitor environmental conditions across different regions without manual searching.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_fTu4TbXCCc0LiuAG0f24bbP0KxHT4Hykn3TVjKD4/ai-agent-connect
- **Tags:** weather-forecast, environmental-data, air-quality, life-indices, real-time-data, api-integration

## Description

QWeather / 和风天气 connects your AI agent to a professional-grade weather feed that covers real-time conditions, long-range forecasts, and hyper-local environmental data. Instead of jumping between multiple websites to check if it's safe to work outside or what the pollution levels are in a specific city, you can just ask your agent. You'll get specific details on air quality, including PM2.5 and PM10 levels, which is a huge win for safety officers who need to make quick calls on site conditions. It also pulls in life indices that give practical advice on things like whether it's a good day for car washing or what kind of clothes to wear based on the current temperature and UV levels. If you're managing logistics or planning outdoor events, having this level of environmental oversight in a single chat window saves a ton of time. You don't have to be a meteorologist to get high-quality data; your agent handles the heavy lifting of interpreting the numbers for you. Using this through the Vinkius catalog makes it simple to swap between different data sources while keeping your primary workflow intact. It turns your agent into a reliable environmental consultant that stays updated on everything from moonrise times to active severe weather alerts.

## Tools

### get_weather_24h
Get a detailed weather forecast for the next 24 hours. This helps you plan the next day's schedule with confidence.

### get_air_now
Check current air quality including PM2.5 and PM10 levels. It's perfect for real-time safety checks.

### get_indices
Pull daily life indices like UV radiation and clothing advice. Use this to give practical recommendations to others.

### get_moon_astronomy
Get precise moonrise and moonset times. This is useful for night operations or astronomical planning.

### get_sun_astronomy
Get sunrise and sunset times for any location. Use this to plan outdoor work shifts or photography.

### get_warning
Retrieve active severe weather warnings for a region. This helps you stay ahead of hazardous conditions.

### get_weather_3d
Get a 3-day weather forecast for a specific area. It's great for short-term planning and quick updates.

### get_weather_7d
Get a 7-day weather forecast. This allows you to see trends and plan for the upcoming week.

### get_weather_now
Get the current weather conditions right now. Use this for an instant snapshot of the environment.

### lookup_location
Search for a location ID using keywords. This helps you find the exact spot you need to track.

## Prompt Examples

**Prompt:** 
```
Is it safe to go for a run in Shanghai today?
```

**Response:** 
```
Based on the current data for Shanghai, the air quality is moderate with an AQI of 75. PM2.5 levels are around 25 μg/m³. While it's generally okay for most people, if you're sensitive to pollution, you might want to stay indoors or wear a mask.
```

**Prompt:** 
```
What's the weather looking like for our outdoor event in Beijing next week?
```

**Response:** 
```
Here's the 7-day outlook for Beijing:

| Day | Forecast | Temp | 
| :--- | :--- | :--- |
| Mon | Sunny | 22°C |
| Tue | Partly Cloudy | 20°C |
| Wed | Light Rain | 18°C |
| Thu | Cloudy | 19°C |
| Fri | Sunny | 21°C |

*Note: There are no severe weather warnings currently active.*
```

**Prompt:** 
```
Should I wash my car today in Hangzhou?
```

**Response:** 
```
Checking the life indices for Hangzhou... The current conditions aren't ideal for car washing today. The humidity is high, and the local life index suggests it's better to wait for a drier day.
```

## Capabilities

### Get 24-hour weather forecasts
See what the weather looks like for the next day in plain English.

### Monitor real-time air quality
Check AQI, PM2.5, and PM10 levels to see if it's safe to be outside.

### Access daily life indices
Get practical advice on clothing, car washing, and UV radiation.

### Track moon and sun cycles
Find out exactly when the sun rises, sets, or when the moon appears.

### Receive severe weather alerts
Stay informed about active warnings and hazardous conditions in specific areas.

### Find specific location IDs
Search for regional coordinates and IDs to pinpoint weather for an exact spot.

## Use Cases

### Checking site safety for construction
A site manager needs to know if it's safe for workers to be outside today. They ask the agent to check the AQI in Shanghai, and the agent uses get_air_now to report the PM2.5 levels.

### Planning truck routes for logistics
A logistics team wants to know if a truck route will be hit by a storm this week. The team asks for a 7-day forecast, and the agent uses get_weather_7d to highlight upcoming hazards.

### Determining event safety for weddings
An event planner wants to know if they should suggest sunscreen for an outdoor wedding. They ask for the daily life indices, and the agent uses get_indices to report the UV radiation level.

### Finding exact weather for rural areas
A developer needs to build a location-based alert system. They ask the agent to find the ID for a specific rural town using lookup_location to get accurate weather for that spot.

## Benefits

- Stop manual tab switching by getting 7-day and 15-day forecasts directly in your chat using get_weather_7d and get_weather_3d.
- Make safer decisions on-site by checking real-time AQI and PM2.5 levels with get_air_now instead of guessing.
- Get practical daily advice on UV radiation and clothing suggestions through get_indices to keep people comfortable.
- Stay ahead of hazards by automatically pulling severe weather alerts with get_warning before they impact your operations.
- Plan night operations with precision by getting moonrise and sunset times using get_moon_astronomy and get_sun_astronomy.
- Pinpoint specific regional data by finding exact location IDs with lookup_location rather than searching for general cities.

## How It Works

The bottom line is you get professional-grade environmental data directly in your chat interface without opening a single extra tab.

1. Subscribe to the QWeather MCP on Vinkius and get your API key from the provider.
2. Add your API key and select your specific plan in the connection settings.
3. Ask your AI client for weather, AQI, or alerts for any location to see the data instantly.

## Frequently Asked Questions

**Can QWeather / 和风天气 help me check if it's safe to work outside?**
Yes, it pulls real-time air quality data including PM2.5 and PM10 levels. Your agent can tell you if the air is clear enough for outdoor tasks based on current conditions.

**How does QWeather / 和风天气 handle weather forecasts for long-term planning?**
It provides 7-day and 15-day forecasts. You can ask your agent about the weather for next week to help plan logistics or events with more lead time.

**Can I use QWeather / 和风天气 to find out when the sun sets?**
Yes, it includes astronomical data. You can ask for sunrise and sunset times for any location to plan your day or night operations.

**Does QWeather / 和风天气 provide alerts for dangerous weather?**
It can retrieve active severe weather warnings. Your agent can check for any immediate hazards like storms or high winds in a specific area.

**Can QWeather / 和风天气 give me advice on what to wear?**
It provides specialized life indices. This includes clothing recommendations based on current temperatures and UV radiation levels for a specific location.

**Is QWeather / 和风天气 good for finding specific regional weather?**
It includes a location lookup tool. If you have a specific area in mind, your agent can find the correct location ID to get accurate local data.

**How do I find my QWeather API Key?**
Log in to the [QWeather Developer Console](https://dev.qweather.com/), create a project, and your API Key will be displayed in the project settings. Ensure you select the correct key type (Web API).

**What is the difference between dev and commercial plans?**
The 'dev' plan uses `devapi.qweather.com` and has limited data frequency and locations. Commercial plans (standard/premium) use `api.qweather.com` and provide higher resolution data and broader global coverage. Set your `qweather_plan` in the credentials to use the correct endpoint.

**Can I query weather by coordinates?**
Yes! You can pass coordinates in the format `longitude,latitude` (e.g., '116.41,39.92') to any tool that accepts a `location` parameter.