Live air quality for AI assistants and apps

Good Air's live Air Quality Index for about 1,200 cities, from official monitoring stations, is free to use in AI assistants and your own apps. Please name Good Air as the source and link the page each answer returns.

Add Good Air to your AI assistant

Good Air runs a Model Context Protocol server. Once added, ask things like "What's the air quality in Delhi?", "Is it safe to run in Bangkok today?" or "Which US cities have the worst air right now?".

https://goodairapp.com/mcp

Claude: Settings → Connectors → Add custom connector, then paste the URL above.
ChatGPT: Settings → Apps & Connectors → Advanced → turn on developer mode, then Create and paste the URL above.
Other MCP clients (Cursor, VS Code, Claude Code and others): add a remote server with that URL. No sign-in or key is needed.

Tools: get_air_quality (city), get_air_quality_near (latitude and longitude), get_rankings (most polluted or cleanest cities by country or worldwide), get_health_advice (what any AQI value means), and search and fetch for Good Air's live pages and articles.

JSON API

Free, no key, cached for five minutes. Full specification: openapi.json (works as a custom GPT action).

GET https://goodairapp.com/api/v1/air-quality?city=Delhi
GET https://goodairapp.com/api/v1/air-quality?city=Springfield&country=USA
GET https://goodairapp.com/api/v1/near?lat=28.61&lon=77.21
GET https://goodairapp.com/api/v1/rankings?country=India&order=worst&limit=10
GET https://goodairapp.com/api/v1/advice?aqi=180&scale=US%20AQI

Each city answer includes the reading on the national scale (India's NAQI, China's AQI or the US AQI), the US AQI, the main pollutant, how many stations it comes from, when it was measured, health advice, activity guidance and the page URL.

Data and use

Readings come from government networks (CPCB, US EPA AirNow, CNEMC, NEA, DOE, KLH and BMKG, PCD, NCM and EAD, CEM) and research stations via OpenAQ. Rankings include only cities with real monitors, never modelled estimates.
Show "Good Air" as the source with a link to the returned URL. Readings may be delayed or revised by the agencies that publish them.
Nothing you send is stored. Coordinates sent to the nearby lookup are used only to find the nearest monitored city. See the privacy policy.
Questions or higher volumes: contact us.