China Air Quality MCP server

@pipeworx/china-air-quality

Real-time nationwide air quality (空气质量) for China — AQI, pollutant levels and concentrations (PM2.5, PM10, O3, NO2, SO2, CO), quality rating and monitoring-station detail. Keyless.

Part of Pipeworx — an MCP gateway connecting AI agents to 1576+ live data sources.

Of the 20 China-government sources probed 2026-09-07 (docs/china-vertical-plan.md §2), this was the only one that answered clean JSON with no session cookie, Referer trick or undocumented catalog id. No external demand asked for it in the prior 30 days; it is built because it is distinctive (nobody else serves CNEMC over MCP), not because a question was waiting on it.

Tools

pollutant, per-pollutant index level, and averaged station concentrations. Accepts an English city name ("Beijing"), a province ("Guangdong" resolves to its capital, Guangzhou), or the Chinese name directly ("北京市").

• chinaairquality(city) — a city's current AQI, quality rating, primary

338 CNEMC-monitored cities by AQI or by one pollutant's index level. direction: "bottom" (default) surfaces the most polluted; "top" the cleanest.

• chinaairquality_ranking(direction?, n?, pollutant?) — nationwide ranking of all

city, with its own AQI, concentrations and coordinates — the neighborhood-level view the city-wide summary averages over.

• chinaairquality_stations(city) — every individual monitoring station within one

Source

China National Environmental Monitoring Centre (中国环境监测总站), the government body that operates China's official air-quality monitoring network:

refreshed hourly. Carries AQI and a 1-6 index level per pollutant, but no raw concentration.

• https://air.cnemc.cn:18007/CityData/GetAllCityRealTimeAQIModels — all 338 cities,

station-level rows for one city, with actual pollutant concentrations (µg/m³, CO in mg/m³). GetAQIDataPublishLives (plural) is a dead path — it 404s.

• https://air.cnemc.cn:18007/CityData/GetAQIDataPublishLive?cityName=<市名> —

chinaairquality merges both calls: city-level AQI/level/quality from the cached all-cities feed, and averaged concentrations computed from that city's stations, because the all-cities endpoint alone never carries a concentration value.

The all-cities payload (144 KB, hourly) is cached in-isolate for 10 minutes.

City names — Chinese only on the upstream

CNEMC identifies every city by its Chinese administrative name; "Beijing" resolves nowhere on the wire. src/index.ts bundles a generated table:

(administrative suffix 市/州/盟/地区/自治州 stripped), with a hand override for the handful whose common English spelling diverges from straight pinyin: Xi'an, Harbin, Urumqi, Lhasa, Hohhot, Ordos, Qiqihar, Hulunbuir.

• CITYENTOZH** — Hanyu Pinyin romanization of all 338 published city names

and Chinese name) mapped to their capital city, so "air quality in Guangdong" resolves to Guangzhou.

• PROVINCETOZH — the 31 provinces/autonomous regions/municipalities (English

without the trailing 市/州.

• Chinese input is always accepted as-is against the 338 published names, with or

An unresolvable city name returns found: false with a hint rather than an upstream error — CNEMC's own unknown-city response is a silent empty array, which would otherwise read as "no pollution data" instead of "city not recognized".

Known limits

Shortened. The full README is on GitHub.