4,500+ servers built on MCP Fusion
Vinkius

QWeather MCP. Get real-time environmental data, no manual dashboards needed.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

QWeather / 和风天气 MCP on Cursor AI Code Editor MCP Client QWeather / 和风天气 MCP on Claude Desktop App MCP Integration QWeather / 和风天气 MCP on OpenAI Agents SDK MCP Compatible QWeather / 和风天气 MCP on Visual Studio Code MCP Extension Client QWeather / 和风天气 MCP on GitHub Copilot AI Agent MCP Integration QWeather / 和风天气 MCP on Google Gemini AI MCP Integration QWeather / 和风天气 MCP on Lovable AI Development MCP Client QWeather / 和风天气 MCP on Mistral AI Agents MCP Compatible QWeather / 和风天气 MCP on Amazon AWS Bedrock MCP Support

Just plug in your AI agents and start using Vinkius.

QWeather / 和风天气 connects your AI agent to China's leading professional weather data service. It retrieves real-time air quality (AQI, PM2.5), 15-day forecasts, severe weather warnings, and specialized life indices.

Use it to check current conditions or plan operations based on accurate environmental metrics for any location.

What your AI agents can do

Get air now

Retrieves the current air quality index (AQI) and pollutant levels for a given location.

Get indices

Fetches specialized daily life indices, such as UV radiation or clothing advice, for a location.

Get moon astronomy

Calculates the moonrise and moonset times for a specific geographic area.

+ 7 more capabilities included
Get Current Weather Conditions

The agent retrieves immediate weather data, including temperature and humidity, for a specified location.

Audit Air Quality Indices (AQI)

You check the current air quality level, monitoring specific pollutants like PM2.5 and PM10 to determine if outdoor activity is safe.

Generate Multi-Day Forecasts

The agent pulls weather predictions for different timelines: 3 days (get_weather_3d), up to 7 days (get_weather_7d), or a full 24 hours.

Determine Celestial Timing

You get precise times for sunrise, sunset, moonrise, and moonset for planning purposes.

Search by Location ID

The agent finds the required location ID using a simple keyword search before running any other environmental query.

Supported MCP Clients

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients
Free for Subscribers

Waiting for input…

AI Agent

QWeather / 和风天气 MCP Server: 10 Tools for Environmental Data

Use these tools to pull air quality readings, multi-day weather forecasts, location IDs, and specialized indices into your AI workflow.

get019d8473

get air now

Retrieves the current air quality index (AQI) and pollutant levels for a given location.

get019d8473

get indices

Fetches specialized daily life indices, such as UV radiation or clothing advice, for a location.

get019d8473

get moon astronomy

Calculates the moonrise and moonset times for a specific geographic area.

get019d8473

get sun astronomy

Determines the precise sunrise and sunset times for a given location.

get019d8473

get warning

Checks if there are any active severe weather warnings issued for an area.

get019d8473

get weather 24h

Provides a detailed weather forecast spanning the next 24 hours.

get019d8473

get weather 3d

Returns a concise three-day weather outlook for the specified location.

get019d8473

get weather 7d

Generates an extended, detailed weather forecast covering up to seven days.

get019d8473

get weather now

Gets the most current, real-time weather observations for a given location.

lookup019d8473

lookup location

Searches by keyword to find and return the specific Location ID required for all other environmental queries.

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
Start building

Make Your AI Do More

Start with QWeather / 和风天气, 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

Need weather intel? This connects your AI client directly to China's leading professional weather data service, giving your agent access to serious environmental metrics. You don't need a technical dashboard or a bunch of different APIs; you just ask your agent, and it handles the heavy lifting.

First thing’s first: If you wanna run any kind of check—whether it’s air quality or a 7-day forecast—your agent needs to know exactly where you are. You use the lookup_location tool with simple keywords; that searches the system and spits out the required Location ID. Once you've got that ID, everything else just works.

Current Conditions & Air Quality Audits

When you need to know what’s happening right now, your agent gets it. It pulls immediate weather observations using get_weather_now, telling you the current temperature and humidity for a precise spot. But checking if the air is safe outside is just as critical. You check the real-time air quality index (AQI) and specific pollutants like PM2.5 and PM10 with get_air_now.

This tells you straight up whether outdoor activity is gonna be safe or if you need to stay indoors.

For specialized planning, your agent hits the get_indices tool. This fetches daily life indices—think UV radiation levels, advice on what kind of clothes you should wear that day, or even suitability scores for certain activities like car washing. It’s a quick snapshot of environmental risk beyond just temperature.

Multi-Day Forecasting and Planning

The agent handles all your timeline needs. If you're planning something big, it pulls the full picture: You can check a detailed weather forecast spanning the next 24 hours using get_weather_24h. For medium-term plans, you get a concise three-day outlook with get_weather_3d, but if you’re looking ahead—say, planning for an entire work week or a trip—you request the extended forecast.

The tool get_weather_7d returns detailed weather predictions covering up to seven days out.

Safety Alerts and Celestial Timing

Safety is paramount. To keep everything running smoothly, you check for active severe weather warnings using get_warning. This tells your agent immediately if the area has any issued safety alerts, so you're never caught off guard by a sudden storm or hazard.

For scheduling tasks that depend on natural light, your agent manages celestial timing. You get precise times for when the sun pops up and when it dips down using get_sun_astronomy. If you need to plan around the moon—for anything from photography to navigation—it calculates both the exact moonrise and moonset times with get_moon_astronomy.

Bottom line: You don't have to jump between five different weather sites. Your agent uses this connection to take complex environmental data—from air pollutant levels to 7-day rain chances—and gives you a single, accurate source of truth whenever you need it.

How QWeather MCP Works

  1. 1 First, call lookup_location with a geographic name to get the target area's specific Location ID.
  2. 2 Second, pass that ID and your desired timeframe (e.g., 'current' or '7-day forecast') to the relevant tool like get_weather_now or get_weather_7d.
  3. 3 Your agent processes the raw data from QWeather and presents a synthesized answer tailored for the original prompt.

The bottom line is: you query your AI client once, and it handles the multi-step lookup process across multiple specialized environmental tools.

Who Is QWeather MCP For?

This server is for Ops Managers who get stuck clicking through 10 different weather dashboards. It's for HSE Professionals who need to quickly audit air quality and safety warnings during an incident. If you're a Developer building field service apps, this lets you integrate reliable environmental data without running your own API key management.

Operations Manager

Checks if a multi-day outdoor event is safe by combining get_weather_7d with get_warning and factoring in local air quality.

HSE Professional

Runs an immediate audit of PM2.5 levels using get_air_now to determine if a site is safe for workers after a smoke incident.

Field Engineer

Needs the location ID first, running lookup_location, before calculating optimal work times based on sun/moon angles using get_sun_astronomy.

Developer

Integrates reliable environmental metrics into a service layer, calling multiple tools like get_weather_now and get_indices programmatically.

What Changes When You Connect

  • Immediate safety checks. Instead of visiting three different sites to check weather, AQI, and warnings, your agent runs get_air_now and get_warning simultaneously, giving you a single pass/fail assessment for operations.
  • Long-term planning accuracy. For events requiring weeks of prep, use lookup_location first, then call get_weather_7d. This ensures the forecast is anchored to the correct location ID from day one.
  • Contextual insights. Don't just get temperature; run get_indices alongside get_weather_now to understand if you need a specific type of gear or if car washing is even recommended for that day’s weather.
  • Full coverage, single query. The agent handles the flow: it finds the location ID (lookup_location), checks current conditions (get_weather_now), and then can pull historical context using get_sun_astronomy—all in one conversational turn.
  • Deep forecasting options. Need to plan for a week? Use get_weather_7d. Only need tonight's details? Stick with get_weather_24h. The toolset gives you the right level of detail without overwhelming your query.

Real-World Use Cases

01

Pre-Trip Safety Audit

A project manager needs to know if a remote construction site is safe for next week. They ask their agent, and the system combines lookup_location (to find the ID), then runs get_air_now and get_warning. The result tells them immediately if air quality or severe warnings block the work.

02

Event Scheduling Optimization

A festival organizer needs to schedule activities. They prompt the agent, which uses get_sun_astronomy and get_weather_3d. The system replies with suggested activity times that avoid peak rain chances while maximizing daylight hours.

03

Daily Logistics Check

A logistics coordinator asks for today's status. The agent runs get_weather_now and checks the specialized indices via get_indices. It reports not only the temperature but also if high UV radiation means extra sun protection is needed.

04

Historical Comparison

A risk analyst wants to compare last month's conditions to today. They use the agent, which runs lookup_location and then pulls both current data (get_air_now) and historical sunset times via get_sun_astronomy.

The Tradeoffs

Assuming the AI knows where you are.

You ask, 'What's the forecast?' without giving a location. The agent fails because it doesn't have context for any tool call.

Always start by using lookup_location with the city name first. This gives your AI client the specific Location ID needed to make all subsequent calls (e.g., get_weather_now).

Asking for 'the forecast' vaguely.

You prompt, 'Give me weather info.' The agent doesn't know if you mean 3 days, 7 days, or just today. It provides incomplete data.

Be explicit about the timeline. Use get_weather_3d for a quick look ahead, or get_weather_7d when planning week-long operations.

Mixing up current and future state.

You ask 'What's the weather?' but really mean 'What will the air quality be tomorrow?'. You get a real-time report that doesn't answer your question.

If you need tomorrow’s data, use get_air_now for today's reading. For future predictions, rely on the forecast tools like get_weather_24h or get_weather_7d.

When It Fits, When It Doesn't

Use this server if your task involves synthesizing environmental data across multiple dimensions (e.g., combining air quality with temperature and warnings). You need the agent to run a chain of calls: lookup_location -> [check current state] -> [check long-term forecast]. Don't use it if you just need one piece of info; for example, if all you need is the sun’s time, running get_sun_astronomy is enough. But if you need to know if that sunset will be safe due to high wind warnings, you must chain get_warning and get_sun_astronomy. The key decision point: are you reporting a single metric (e.g., AQI), or are you building an operational assessment? Build the assessment; use this server.

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by QWeather / 和风天气. 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

How we secure it →

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 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.

Available Capabilities

get_air_now get_indices get_moon_astronomy get_sun_astronomy get_warning get_weather_24h get_weather_3d get_weather_7d get_weather_now lookup_location

Checking environmental conditions used to require opening five different tabs.

Before QWeather, if you needed a full picture of site safety, you had to visit a weather site for the forecast, another one for AQI readings, and maybe a third just for severe warnings. You'd spend ten minutes copying location names and pasting them into three different dashboards—all before you even got an answer.

Now, your agent handles it. You tell it: 'Check Beijing for current safety.' The system runs `get_air_now`, checks `get_weather_now` simultaneously, and then synthesizes the risk level in plain English. It's one prompt; you get a single, unified report.

QWeather MCP Server: Get data depth that goes beyond simple temperature readings.

It’s not just about the current temp. You can ask it to check if high UV radiation (`get_indices`) will make a specific part of your day difficult, or if the moonrise time (`get_moon_astronomy`) conflicts with planned outdoor work hours.

The difference is depth. Instead of just knowing 'it's sunny,' you know *when* it’s sunny, *how* intense the sun is, and *if* there are any alerts that could spoil your plans.

Common Questions About QWeather MCP

How do I find the location ID for a new site using get_air_now? +

You must call lookup_location first. This finds the specific Location ID needed, which you then pass to get_air_now. Without the correct ID, any environmental tool will fail.

Is there a difference between get_weather_24h and get_weather_now? +

Yes. get_weather_now gives you what's happening right this minute. Use get_weather_24h when you need to see the predicted trend and changes over the course of a full day.

Which tool should I use for planning a multi-week outdoor event? +

You need get_weather_7d. This gives the most comprehensive look ahead. If you only check today, your plan is incomplete. Use get_weather_7d to build a robust timeline.

How do I get sunrise and sunset times? Do I use get_sun_astronomy? +

Yes, you call get_sun_astronomy. This tool specifically provides the precise timing data needed for scheduling. It's separate from general weather forecasts.

What format must my QWeather API Key be in when I start using lookup_location? +

You must pass your API key as an environment variable or directly within the request header. Ensure the key you provide matches the plan scope (dev, free, standard) you activated on Vinkius.

What are the rate limits for calling get_air_now? +

Rate limits depend entirely on your subscription tier. Free users have a set cap, while higher-paid plans offer much greater throughput. Always check the Vinkius documentation for current quota details.

If I use get_weather_now and receive an error code, what does it usually mean? +

An API error typically means you've provided invalid input—this is often a missing coordinate or a bad location ID. The specific error message tells your AI client exactly which parameter needs correction.

How can I use get_indices to plan for different types of outdoor activities? +

This tool provides specialized metrics like UV radiation and clothing suitability. Querying these specific indices gives your agent highly targeted advice, moving beyond general weather descriptions.

How do I find my QWeather API Key? +

Log in to the QWeather Developer Console, 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.

More in this category

You might also like

Built & Managed by Vinkius 30s setup 10 tools

We've already built the connector for QWeather. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 10 tools are live and waiting. You're up and running in seconds.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.