Caiyun Weather MCP. Get hyper-local, minute-by-minute environmental data.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Caiyun Weather / 彩云天气 connects your AI agent to China's high-precision environmental data. Get minute-level precipitation forecasts, real-time AQI, and long-term weather trends for any coordinate.
Your agent retrieves current temperature, humidity, visibility, and wind data instantly, eliminating the need to check multiple weather websites.
What your AI agents can do
Get aqi info
Fetches the Air Quality Index (AQI) and related pollutant data for a given location.
Get daily forecast
Retrieves the general weather forecast for a specified day.
Get hourly forecast
Gets a detailed weather forecast broken down by hour.
The agent retrieves the current temperature, humidity, visibility, and wind speed/direction for a specific geographic coordinate.
The agent accesses hyper-local precipitation forecasts, specifically checking for rain probability or minute-by-minute rain alerts over the next two hours.
The agent fetches real-time AQI scores and pollutant concentrations (PM2.5, PM10) for any location in mainland China.
The agent pulls detailed weather data, allowing checks on daily or hourly trends extending up to 15 days into the future.
The agent retrieves specific data points like visibility distance and current wind speed/direction for operational planning.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Caiyun Weather MCP Server: 8 Tools for Environmental Data
Use these tools to get real-time air quality, minute-by-minute rain forecasts, and detailed weather trends for operational planning.
019d8422get aqi info
Fetches the Air Quality Index (AQI) and related pollutant data for a given location.
019d8422get daily forecast
Retrieves the general weather forecast for a specified day.
019d8422get hourly forecast
Gets a detailed weather forecast broken down by hour.
019d8422get minutely rain
Provides highly granular, minute-by-minute predictions for rainfall.
019d8422get precipitation probability
Checks the likelihood of rain occurring at a specific time and location.
019d8422get realtime weather
Gathers the immediate, current environmental status, including temperature and humidity.
019d8422get visibility data
Calculates and returns the current visibility distance (e.g., in kilometers).
019d8422get wind conditions
Reports the current wind speed and direction for a given location.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Caiyun Weather / 彩云天气, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Caiyun Weather connects your AI agent to China's high-precision environmental data. You'll get minute-level rain forecasts, real-time Air Quality Index (AQI) scores, and long-term weather trends for any coordinates. Your agent pulls the current temperature, humidity, visibility, and wind data instantly, meaning you don't have to jump between weather sites. get_aqi_info fetches the Air Quality Index and related pollutant data for a given spot. get_realtime_weather gathers the immediate environmental status, giving you current temperature, humidity, visibility, and wind speed/direction.
You can check for rain probability using get_precipitation_probability or get minute-by-minute predictions with get_minutely_rain over the next two hours. get_wind_conditions reports the current wind speed and direction. You can check daily trends with get_daily_forecast or get a detailed hourly breakdown using get_hourly_forecast, both extending up to 15 days out. get_visibility_data calculates the current visibility distance for operational planning.
How Caiyun Weather MCP Works
- 1 Subscribe to the Caiyun Weather server and enter your unique Caiyun Weather Token (天气令牌).
- 2 Direct your AI client (Claude, Cursor, etc.) to perform a task, such as 'Check the AQI at X coordinates' or 'What's the rain forecast for the next two hours at Y coordinates'.
- 3 The agent calls the necessary tool(s) and returns the structured, real-time environmental data directly into your conversation.
The bottom line is, your agent uses the token to call the right weather tool and gives you the answer, not a link to a weather map.
Who Is Caiyun Weather MCP For?
The logistics manager who needs to reschedule deliveries based on minute-by-minute rain alerts. The public health official monitoring air quality for high-risk populations. The field operations lead who needs to know current visibility and wind conditions for equipment deployment. It's for anyone whose plans depend on accurate, local environmental data.
Uses get_minutely_rain to determine if an outdoor delivery route is viable in the next 120 minutes.
Uses get_aqi_info to generate reports on localized air quality and pollutant levels for clients.
Uses get_realtime_weather and get_wind_conditions to verify current conditions before deploying equipment.
What Changes When You Connect
- You get rain predictions minute-by-minute using
get_minutely_rain. This is better than looking at a general forecast because it tells you exactly when the rain starts and stops, critical for outdoor logistics. - Stop guessing about air quality.
get_aqi_infogives you the current AQI and pollutant levels (PM2.5, PM10), allowing you to provide accurate health advice to clients immediately. - Need to know if the weather is changing fast? Use
get_hourly_forecastto see detailed trends. You get a full picture of how the environment shifts over the next several hours. - If you're planning a site visit,
get_realtime_weatherprovides immediate readings on temp, humidity, and visibility. It's a single call for the full current status. - The
get_wind_conditionstool reports current wind speed and direction. This is crucial for anything involving drones, construction, or maritime operations. - You don't have to choose between daily and hourly data. You can use
get_daily_forecastfor planning 15 days out, and thenget_hourly_forecastto plan next week's day by day.
Real-World Use Cases
Planning a City-Wide Delivery Route
The logistics manager asks: 'Will the Shanghai route be clear for the next two hours?' Their agent runs get_minutely_rain and get_realtime_weather for all stops. The agent reports back: 'No rain expected, but visibility will drop below 10km in 90 minutes. Adjust the route accordingly.' The delivery is rescheduled based on real data, not a general prediction.
Assessing Outdoor Event Safety
A public health official needs to vet an outdoor festival site. They run get_aqi_info and get_visibility_data. The agent reports: 'The AQI is moderate, but visibility is currently low at 8km due to haze. Recommend postponing outdoor activities until visibility improves.' Safety decisions are made instantly.
Checking Equipment Deployment Viability
A construction site manager needs to deploy a crane. They run get_wind_conditions and get_realtime_weather. The agent confirms: 'Current wind speed is 45 km/h from the northeast, exceeding safe limits. Wait until the wind drops below 30 km/h.' The operation is halted safely.
Comparing Long-Term Climate Risk
A developer building an insurance model needs historical data. They use get_daily_forecast to pull 15 days of trend data, then combine it with get_hourly_forecast to build a predictive model of seasonal risk.
The Tradeoffs
Checking weather manually via multiple sites
Opening Google Weather, then clicking to a specialized AQI site, then opening a wind map. You spend five minutes copy-pasting coordinates and cross-referencing different graphs to get a full picture.
→
Ask your agent directly: 'What's the environmental status at 121.47, 31.23?' The agent uses get_realtime_weather, get_aqi_info, and get_wind_conditions simultaneously, giving one cohesive answer.
Relying on general forecasts
Seeing a forecast that says 'Rain possible this afternoon.' This is useless because you don't know if it's a 10-minute shower or an all-day drizzle, making planning impossible.
→
Use get_minutely_rain or get_precipitation_probability with your agent. It tells you if rain is expected in the next 120 minutes and when, making planning precise.
Forgetting to check visibility
Planning a flight path or a drone survey without checking visibility. You assume clear skies, but the get_visibility_data tool shows 5km due to fog, causing a costly delay or failure.
→
Always include visibility in your query. Your agent runs get_visibility_data alongside the other tools, providing a complete picture for safety-critical operations.
When It Fits, When It Doesn't
Use this server if your operation requires environmental data measured in minutes, not hours. You need to know if a specific activity—like a delivery or construction lift—is safe right now, or within a tight, two-hour window. If you only need a general idea ('Will it be warm this weekend?'), stick to a simple calendar check. If you need to know why it might be bad ('Is the air quality poor because of PM2.5, and how bad is it right now?'), use get_aqi_info. If you need to know what's coming next, combine get_hourly_forecast with get_minutely_rain. Don't use this if you only need a simple temperature reading; get_realtime_weather handles that fine, but this server gives you the full context.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Caiyun Weather / 彩云天气. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Checking the weather used to be a mess of separate websites and conflicting data.
You remember the routine: open a map to check the general forecast. Then, you switch tabs to an air quality site to check PM2.5. You might open a third site just to see the wind speed. You spend ten minutes jumping between services, copy-pasting coordinates, and trying to reconcile three different, fragmented views of the same location.
With the Caiyun Weather MCP Server, you ask your agent one question: 'What's the environmental status at this site?' Your agent runs all the necessary checks—temperature, AQI, wind, and minute-by-minute rain—and gives you a single, consolidated report. You get the full picture in seconds.
Caiyun Weather MCP Server: Get hyper-local, minute-by-minute environmental data.
Before, you had to check the daily forecast for general planning, and then run a separate query for the hourly forecast to see what would happen next. It was a frustrating sequence of two different data sets that didn't always align perfectly.
Now, your agent handles the sequencing. You can ask for 'the next two hours' and the agent intelligently combines `get_hourly_forecast` with `get_minutely_rain` to give you a continuous, reliable timeline. The data speaks in one voice.
Common Questions About Caiyun Weather MCP
How do I use the get_minutely_rain tool? +
You use get_minutely_rain when you need to know the precise timing of rain. It provides hyper-local precipitation forecasts for the next 120 minutes, which is much more useful than a general 'rain possible' warning.
Is get_aqi_info only for China? +
Yes, the get_aqi_info tool provides real-time AQI and pollutant data specific to mainland China. This data is critical for local health and environmental compliance reports in the region.
What's the difference between get_hourly_forecast and get_daily_forecast? +
Use get_hourly_forecast for detailed, time-specific planning (e.g., 'What will the wind be like at 2 PM?'). Use get_daily_forecast for broad, long-term planning over multiple days.
Can I get current weather and rain probability at once? +
Yes. You can ask your agent to check the current status using get_realtime_weather and simultaneously check for rain chances using get_precipitation_probability for the location.
How do I get the wind conditions using the get_wind_conditions tool? +
You pass the desired coordinates to the tool. The tool returns the current wind speed and direction for that specific location. This is useful for logistics planning or monitoring industrial sites.
What should I do if the get_realtime_weather tool fails? +
If the tool returns an error, check that the coordinates are valid and within the service area. You can try running a forecast tool like get_hourly_forecast to cross-reference the data.
Can I use get_aqi_info for coordinates outside of mainland China? +
No, the get_aqi_info tool is designed for air quality data across mainland China. For international locations, you'll need a different environmental data source.
Does get_minutely_rain provide historical rain data? +
No, get_minutely_rain provides a forecast for precipitation in the next 120 minutes. For historical data, you must use other dedicated data sources.
How do I find my Caiyun Weather Token? +
Log in to the Caiyun Weather Open Platform, 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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
CallGear
Analyze communication performance via CallGear — track calls, monitor advertising campaigns, and retrieve real-time stats directly from any AI agent.
TzKT (Tezos Indexer & Explorer API)
Access real-time Tezos blockchain data — explore accounts, smart contracts, and transaction history directly from your AI agent.
Fortnite Player Stats & News Intelligence
The definitive server for Fortnite player scouting — track wins, K/D ratios, and official game news via AI.
You might also like
ClickHouse (Vector Search)
Manage vector embeddings and SQL via ClickHouse — list databases, execute SQL, and perform high-speed vector searches directly from any AI agent.
Snapchat Ads Alternative
Manage your Snapchat Ads campaigns — audit accounts, ad squads, and stats via AI.
Library of Congress
Search and retrieve millions of historical items, maps, photos, and manuscripts from the world's largest library.