find_sensors
ChatGPTSingle sensors with their latest reading (PM1, PM2.5, PM10, temperature, humidity, pressure), network and quality check: status, rating 0–10 of the last checked day, the mean rating of the last 7 days and the reasons. Filter by city, country, or a point with a radius; sort=rating puts the most reliable sensors first.
get_air_quality
ChatGPTPM2.5 now in a city (mean of the latest reading of each eligible sensor, at most 60 minutes old) with its US EPA category and the weather now (temperature, humidity, pressure, wind, clouds, precipitation), plus the last completed day from the Atmy Data Hub with its weather. Pass city or lat/lon.
get_air_quality_history
ChatGPTDaily PM2.5 of a city from the Atmy Data Hub (UTC days, sensors after the quality check) with the day's weather from 2026-01-19 (mean, lowest and highest temperature, humidity, pressure, wind, strongest gust, clouds): the last days, or any period since 2017 with from/to, at most 400 days per call. For the whole history or records use get_air_quality_monthly first.
get_air_quality_monthly
ChatGPTThe whole measurement history of a city from the Atmy Data Hub: PM2.5 per month with the month's weather from 2026-01, yearly means (complete years marked), the dirtiest and cleanest months and days. For questions like "how has the air changed" or "the most polluted month on record".
get_city_forecast
ChatGPTThe next hours of a city: temperature, wind, humidity, precipitation and the pollution accumulation index 0–100 (how strongly the weather keeps particles near the ground). A weather estimate, not a PM2.5 forecast.
get_country_ranking
ChatGPTCities of a country ranked by daily PM2.5 for the last completed day (Atmy Data Hub), most polluted or cleanest first.
get_home_environment
ChatGPTGreenery and emission sources around a point (a home): tree canopy share within 300 m, green land share and summer NDVI within 500 m with a low/medium/high level against the rest of the city, the nearest park, up to 10 emission sources (power plants and works within 5 km, boiler houses and single chimneys within 1.5 km) with distance, bearing, fuel and confidence, and the number of detached houses within 1 km (an estimate of stove smoke, not a count of stoves). Only computed cities; elsewhere the error city_not_covered.
get_sensor
ChatGPTOne sensor by its id: location, network, license, quality check with rating and reasons, and the latest reading.
get_sensor_readings
ChatGPTReadings of one sensor: raw (the last 31 days, at most 7 days a call), 5-minute means (the same windows), hourly means (the last 366 days, at most 92 days a call) or daily means (UTC days of the last 366 days, with the quality check of each day). Default: the last 24 hours, or 30 days by day. Times are UTC.
get_sensors_average
ChatGPTThe mean of up to 100 sensors per 5 minutes, hour or UTC day, each sensor counted once per bucket, with the number of sensors in each bucket. Windows as in get_sensor_readings; by day at most 92 days a call.
list_sensor_networks
ChatGPTThe sensor networks in Atmy (Sensor.Community, AirGradient, Atmy) with their number of sensors, how many pass the quality check, and their license.
search_cities
ChatGPTFind the cities with an Atmy air-quality summary by name (any language) or country. Returns slugs to pass to the other tools.