# Caiyun Weather MCP MCP > Caiyun Weather / 彩云天气 delivers high-precision environmental data for operations across China. Your agent gets minute-level rain forecasts, real-time air quality indexes (AQI), and immediate conditions like wind speed and visibility. It transforms complex meteorological feeds into simple, actionable reports for logistics planning or health monitoring. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** weather, meteorology, caiyun, air-quality, aqi, precipitation, forecasting, environmental-data, china-api ## Description This MCP lets your AI client treat environmental data like a conversation topic. You don't need to navigate weather maps or consult multiple specialized APIs. Instead, you ask your agent about conditions—say, 'What's the air quality and rain chance near the port today?' Your agent handles pulling together real-time temperature, pollution levels, wind patterns, and detailed rainfall probabilities from a single source. It’s designed to act as an environmental coordinator for everything from planning outdoor deliveries to monitoring indoor air systems across retail locations. If you're building complex workflows using multiple specialized APIs, Vinkius makes it simple: connect your AI client once to access this entire catalog of tools and start getting immediate, reliable data. ## Tools ### get_aqi_info Retrieves the current air quality index (AQI) and specific pollutant levels for a location. ### get_daily_forecast Provides generalized weather predictions covering an entire day's worth of conditions. ### get_hourly_forecast Delivers detailed weather changes, broken down hour by hour, for the near term. ### get_minutely_rain Calculates precise rainfall forecasts minute-by-minute over a two-hour window. ### get_precipitation_probability Checks the likelihood of rain occurring at a specific time and location. ### get_realtime_weather Gathers current, live data points like temperature, humidity, and visibility for any coordinates. ### get_visibility_data Reports the specific distance of visible air to account for fog or dust. ### get_wind_conditions Outputs the current speed and direction of winds at a given point. ## Prompt Examples **Prompt:** ``` What is the real-time weather at coordinates 121.47,31.23 (Shanghai)? ``` **Response:** ``` The current weather in Shanghai is 22 °C with clear skies. The humidity is 65% and visibility is excellent at 15 km. Should I also check if there's any rain forecast for the next hour? ``` **Prompt:** ``` Will it rain in the next 2 hours at 116.40,39.90 (Beijing)? ``` **Response:** ``` According to Caiyun's minutely forecast, there is no rain expected in your 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:** ``` Check the air quality index for coordinates 113.26,23.12 (Guangzhou). ``` **Response:** ``` I've retrieved the AQI for Guangzhou. The current index 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? ``` ## Capabilities ### Check current environmental status Retrieves immediate readings for temperature, humidity, visibility, wind direction, and air quality index at a specific coordinate. ### Predict short-term rainfall Provides minute-by-minute forecasts detailing the exact chance of precipitation over the next two hours. ### Forecast future weather trends Generates detailed hourly and daily outlooks extending up to 15 days out for planning purposes. ### Monitor pollution levels Gathers real-time data on common pollutants, including PM2.5 and PM10, across mainland China. ### Determine atmospheric movement Checks current wind speed and direction at a given location to assess outdoor feasibility. ## Use Cases ### Managing a construction site shutdown The foreman asks their agent, 'Should we pause work today?' The agent checks get_wind_conditions and gets_minutely_rain. It reports that winds are too high for the next 90 minutes and rain is probable in an hour, confirming the necessary halt. ### Coordinating a large-scale outdoor event The planner asks their agent to monitor conditions over three days. The agent uses get_daily_forecast for the big picture, then runs get_precipitation_probability checks to schedule backup indoor activities. ### Monitoring a remote industrial site's air quality The engineer queries the system using get_aqi_info. The agent immediately reports high PM2.5 levels, alerting the user that local equipment needs filter replacement before continuing operations. ### Planning a cross-city delivery route Instead of checking maps constantly, the dispatch manager asks their agent for real-time weather using get_realtime_weather at multiple waypoints. The agent compiles a single report showing current conditions and potential issues. ## Benefits - Minute-by-minute rain checks mean you won't get caught off guard. Use get_minutely_rain to plan outdoor work knowing exactly when the next drizzle starts. - You don't have to switch between AQI and weather sites anymore. Get immediate pollution data with get_aqi_info alongside current temperature readings. - Forget vague 'good' or 'poor' forecasts. Use get_hourly_forecast for actionable, predictable changes hour by hour when planning multi-stage operations. - Real-time visibility reports from get_visibility_data are crucial for field operations; they tell you if dust or fog is actually limiting movement. - Check the overall forecast using get_daily_forecast to plan week-long logistics runs without needing dozens of small calls. ## How It Works The bottom line is that your AI client handles all the API calls; you just ask a question. 1. First, subscribe to this MCP and input your Caiyun Weather Token. 2. Next, tell your agent what specific environmental data you need (e.g., 'What's the AQI in Shanghai?'). 3. The agent calls the appropriate tool, retrieves the structured data, and presents it back as a natural language answer. ## Frequently Asked Questions **How do I check if it will rain using get_minutely_rain?** The tool gives minute-by-minute predictions for the next 120 minutes. You just need to provide the location coordinates, and it outputs the probability of precipitation in small intervals. **Is get_aqi_info enough for all environmental checks?** No. While get_aqi_info covers pollution (PM2.5, PM10), you still need to check weather conditions using get_realtime_weather or the forecast tools. **Can I use get_daily_forecast for current readings?** No. get_daily_forecast is meant for broad, day-to-day predictions. For what's happening right now, you must call get_realtime_weather. **What coordinates should I use for the best results?** The tool supports Longitude/Latitude (GCJ-02) or administrative codes. Always ensure your location input matches the format required by the function call to get accurate data. **What specific details does the `get_wind_conditions` tool provide, and how do I interpret the data?** The tool delivers both wind speed and direction for a coordinate. The output includes numerical measurements (like km/h) alongside cardinal directions (N, S, E, W). This lets you know not just *how fast* it's blowing, but also which way it’s coming from. **How is the data retrieved using `get_hourly_forecast` different from what I get with `get_daily_forecast`?** The hourly forecast breaks down weather minute-by-minute for specific blocks of time. The daily forecast gives you a broad summary, covering general conditions and averages for an entire 24-hour period. Use the hourly tool when timing matters. **What should I know about usage limits or rate restrictions when calling `get_realtime_weather`?** Always ensure your Caiyun Weather Token is active and correctly formatted before making calls. High-volume usage can trigger rate limiting, so plan your API requests to prevent service interruptions. **Aside from pollution levels, what does `get_visibility_data` measure?** This tool measures atmospheric visibility distance (usually in kilometers). It tells you how far the horizon is clear due to fog, smog, or precipitation. This data is key for logistics planning.