china_air_quality_ranking

Pack: china-air-quality · Endpoint: https://gateway.pipeworx.io/china-air-quality/mcp

Nationwide ranking of Chinese cities by air quality (空气质量排名) — the cleanest or most polluted cities right now, optionally ranked by a specific pollutant instead of overall AQI. Answers “which Chinese cities have the worst air quality today”, “cleanest cities in China right now”, “top 10 most polluted cities in China by PM2.5”. Covers all 338 CNEMC-monitored prefecture-level cities.

Parameters

NameTypeRequiredDescription
directionstringno”top” = cleanest (lowest AQI) first; “bottom” = most polluted (highest AQI) first. Default “bottom”.
nnumbernoHow many cities to return, 1-50 (default 10).
pollutantstringnoRank by this pollutant’s index level instead of overall AQI.

Example call

Arguments

{
  "direction": "top",
  "n": 10
}

curl

curl -X POST https://gateway.pipeworx.io/china-air-quality/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"china_air_quality_ranking","arguments":{"direction":"top","n":10}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('china_air_quality_ranking', {
  "direction": "top",
  "n": 10
});

More examples

{
  "direction": "bottom",
  "n": 5,
  "pollutant": "pm2_5"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "china-air-quality": {
      "url": "https://gateway.pipeworx.io/china-air-quality/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build September 7, 2026