# Caiyun Weather MCP for AI Agents AI Agent Connect > Caiyun Weather provides high-precision meteorological data for China. It gives your AI agent access to minute-level rain forecasts, real-time air quality indices (AQI), and detailed visibility or wind conditions. Use it to automate environmental monitoring or plan outdoor activities with hyper-local accuracy. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_mevhGXYe6xKHWrqeEPmDZa6YCgoZNHfAugzSJkeH/ai-agent-connect - **Tags:** weather, meteorology, caiyun, air-quality, aqi, precipitation, forecasting, environmental-data, china-api ## Description Caiyun Weather gives your AI agent access to high-precision weather and air quality data across China. It handles everything from minute-level rain forecasts to real-time pollutant levels. When you connect this through Vinkius, you stop toggling between different apps to see if a storm is coming. You can just ask your agent if it's safe to move a shipment or check the air quality for a new store location. It turns your AI into a real-time environmental coordinator. You get a clear picture of humidity, wind speed, and visibility without ever opening a map. It's a way to put professional meteorological data into your daily routine so you can make better decisions on the fly. ## Tools ### get_hourly_forecast The get_hourly_forecast tool shows what the weather looks like hour by hour. Use it to plan specific windows of activity. ### get_minutely_rain The get_minutely_rain tool offers high-resolution rain data for the next 120 minutes. It tells you exactly when rain starts. ### get_precipitation_probability The get_precipitation_probability tool checks the chance of rain for a specific area. It helps you weigh the risks of outdoor events. ### get_realtime_weather The get_realtime_weather tool provides a snapshot of current temperature, humidity, and visibility. Use it for immediate awareness. ### get_visibility_data The get_visibility_data tool retrieves the current visibility distance in kilometers. This is vital for transportation and safety. ### get_wind_conditions The get_wind_conditions tool finds out the wind speed and direction for any coordinate. It is essential for outdoor logistics. ### get_aqi_info The get_aqi_info tool pulls the current Air Quality Index for any location. It helps you monitor pollution levels like PM2.5 instantly. ### get_daily_forecast The get_daily_forecast tool provides a day-by-day weather breakdown. This is perfect for long-term planning and scheduling. ## Prompt Examples **Prompt:** ``` Is it going to rain in Beijing in the next hour? ``` **Response:** ``` No rain is expected in the Beijing area for the next 120 minutes. It will remain cloudy. Would you like me to check the daily forecast for the rest of the week? ``` **Prompt:** ``` What's the air quality like in Guangzhou right now? ``` **Response:** ``` The current AQI for Guangzhou is 45, which is **Good**. Pollutant levels are low, with PM2.5 at 12 μg/m³. Is there anything else you'd like to know about the environmental conditions there? ``` **Prompt:** ``` Check the wind and visibility for a site at 121.47,31.23. ``` **Response:** ``` At these coordinates (Shanghai), the current wind speed is 15 km/h from the North. Visibility is excellent at 15 km. Would you like to see the hourly forecast for the rest of the day? ``` ## Capabilities ### Get minute-by-minute rain alerts See exactly when rain will start and stop in the next two hours. ### Check real-time air quality Pull current AQI and pollutant levels like PM2.5 for specific areas. ### Track wind and visibility Get precise wind speed, direction, and visibility distance for safety. ### View long-term weather trends Access hourly and daily forecasts for up to 15 days out. ### Monitor local humidity Get instant humidity readings for environmental control or health advice. ## Use Cases ### Avoiding delivery delays A logistics manager asks if a truck in Shanghai will hit rain in the next 30 minutes. The agent uses get_minutely_rain to suggest a reroute. ### Public health alerts A wellness app pulls get_aqi_info for Beijing to send push notifications to users with asthma when pollution levels spike. ### Safe construction planning A foreman checks get_wind_conditions for a specific site to see if wind speeds are safe for crane operations that day. ### Retail setup decisions A store owner checks get_realtime_weather to decide if it is a good day to put out outdoor furniture and signage. ## Benefits - Better logistics planning using get_minutely_rain to avoid weather-related delivery delays. - Real-time health alerts by pulling AQI data with get_aqi_info for specific neighborhoods. - More accurate site planning with get_visibility_data and get_wind_conditions for construction. - Seamless long-term scheduling using get_daily_forecast for 15-day planning. - Immediate environmental awareness using get_realtime_weather for retail and warehouse management. ## How It Works The bottom line is you get high-precision China weather data directly inside your AI chat interface. 1. Subscribe to this Connector and get your Caiyun Weather Token. 2. Enter your token into your preferred AI client configuration. 3. Ask your agent for specific weather data like rain probability or AQI. ## Frequently Asked Questions **Does Caiyun Weather MCP cover the whole world?** No, it is optimized for high-precision data across mainland China. It is the best choice for hyper-local weather and AQI in that specific region. **Can I use Caiyun Weather MCP for logistics?** Yes, it is perfect for that. The minute-level rain forecasts help you coordinate deliveries and avoid weather-related delays in real-time. **How accurate is the rain forecast?** It provides minute-level precision for the next 120 minutes. This is much more granular than standard weather apps, making it great for time-sensitive tasks. **Can it tell me about air pollution?** Yes, it pulls real-time AQI and specific pollutant data like PM2.5 and PM10, which is great for health and environmental monitoring. **What do I need to get started with Caiyun Weather MCP?** You just need a Caiyun Weather Token. Once you have that, you can connect it to your AI client through Vinkius and start asking questions. **How do I find my Caiyun Weather Token?** Log in to the [Caiyun Weather Open Platform](https://open.caiyunapp.com/), navigate to the 'Application Management' (应用管理) section to find your unique API Token. **What is the coordinate format for location?** Caiyun uses the format `[Longitude],[Latitude]`. For example, Beijing is approximately `116.40,39.90`. It is important to put the Longitude first. **Which coordinate system should I use?** Caiyun natively supports GCJ-02 coordinates, which is the standard system for maps in mainland China. Ensure your coordinates are in this format for maximum accuracy.