IQAir AirVisual integration
IQAir AirVisual gives real-time air quality and weather for cities and monitoring stations worldwide: US EPA and Chinese AQI with the main pollutant, temperature, humidity, pressure and wind, plus, on higher plans, pollutant concentrations (PM2.5, PM10, O3, NO2, SO2, CO), forecasts and 48-hour history. Browse the supported countries, states, cities and stations by name, look up the nearest city or station to a latitude and longitude, or rank major cities by AQI. The IP-geolocation lookups (nearest city or station without coordinates) are not exposed, since they would locate the LiveContext server. Fields and tools depend on the plan: Community (free) has city-level data, overall AQI and current weather at 5 calls per minute, 500 per day and 10,000 per month; Startup adds stations and pollutant concentrations; Enterprise adds forecasts, history and the city ranking. A failed call answers status fail with a reason code in data.message (incorrect_api_key, api_key_expired, call_limit_reached, too_many_requests above 10 calls per second, feature_not_available, no_nearest_station, ip_location_failed); a key that is not recognized can also answer HTTP 403 with the message Forbidden. Authentication is an API key from the IQAir dashboard, sent as the key query parameter.
Say what should happen.
The workflow builds itself.
What you can do with IQAir AirVisual
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Air quality, 4 operations
get_cityGet cityGETReturns the AQI (US and Chinese, main pollutant) and weather of a named city. Get the names from list_countries, list_states and list_cities. Fields depend on the API plan.get_nearest_cityGet nearest cityGETReturns the air quality (US and Chinese AQI, main pollutant) and weather of the supported city nearest to a latitude and longitude. The fields returned depend on the API plan.get_nearest_stationGet nearest stationGETReturns the readings of the station nearest to a latitude and longitude: AQI, pollutant concentrations and weather. Startup plan and above.get_stationGet stationGETReturns the readings of a named station: AQI, pollutant concentrations and weather. Startup plan and above.
City, 1 operation
list_citiesList citiesGETLists the cities of a state that have at least one active station. Pass names from list_countries and list_states.
City ranking, 1 operation
get_city_rankingGet city rankingGETReturns selected major cities of the world sorted by current AQI, each with its US and Chinese AQI. Enterprise plan only.
Country, 1 operation
list_countriesList countriesGETLists every country that has at least one active station. Use the returned country names in the other tools.
State, 1 operation
list_statesList statesGETLists the states of a country that have at least one active station. Pass a country name from list_countries.
Station, 1 operation
list_stationsList stationsGETLists the active stations of a city with their names and coordinates. Startup plan and above.
Use IQAir AirVisual from Claude Code, Cursor or Codex
Connect IQAir AirVisual in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its IQAir AirVisual operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect IQAir AirVisual
- Create your workspace
Sign up free. Nothing to install.
- Connect IQAir AirVisual once
Add your IQAir AirVisual connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
IQAir AirVisual integration FAQ
What can you do with the IQAir AirVisual integration?
LiveContext exposes 9 operations on IQAir AirVisual, covering air quality, city, city ranking and country.
