# Iqair Airvisual — MCP server on mcp.ai
> Connect your Iqair Airvisual account and use 10 tools for developer tools straight from your AI agent. Connect with your own API key. IQAir AirVisual provides global air quality data through its API, offering real-time and historical information on air pollution levels.

By: mcp.ai · official
Page: https://mcp.ai/iqair_airvisual

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_iqair_airvisual?ms=1787291400000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/iqair_airvisual/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/iqair_airvisual/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/iqair_airvisual/skill.md
Postman collection (v2.1): https://mcp.ai/iqair_airvisual/postman.json

## Tools
- iqair_airvisual_get_air_quality_forecast_data(city: string, state: string, country: string) — Tool to retrieve air quality forecast data for a specified city, state, and country. Use after confirming location details.
- iqair_airvisual_get_cities(state: string, country: string) — Tool to list supported cities in a specified state and country. Use when you need to retrieve cities for a given state/country.
- iqair_airvisual_get_city_air_quality(city: string, state: string, country: string) — Tool to retrieve air quality data for a specific city. Use when you need current pollution and weather data by specifying city, state, and country.
- iqair_airvisual_get_countries() — Tool to list all supported countries. Use when you need to know which countries are supported by the AirVisual API.
- iqair_airvisual_get_historical_aqi_data(end?: string, city: string, start?: string, state: string, country: string) — Tool to retrieve historical air quality data for a city. Use after confirming city, state, and country when you need AQI readings over time.
- iqair_airvisual_get_nearest_city_air_quality(ip?: string, lat?: number, lon?: number) — Tool to retrieve air quality data for the nearest city based on latitude/longitude or IP. Use when you have precise location data or want to geolocate an IP for air quality.
- iqair_airvisual_get_nearest_station_air_quality(lat: number, lon: number) — Tool to get nearest station air quality. Use when you have GPS coordinates and need closest station’s AQI.
- iqair_airvisual_get_states(country: string) — Tool to list supported states in a specified country. Use when you need to retrieve states/provinces for a given country.
- iqair_airvisual_get_station_by_id(city: string, state: string, country: string, station: string) — Fetches current air quality and weather data for a specific location by station/city/state/country names. Falls back to city-level data if the Stations API requires premium access. Returns current AQI
- iqair_airvisual_get_world_ranking(ip?: string, lat?: number, lon?: number) — Retrieves air quality ranking data. With premium API access, returns a global ranking of cities by AQI. With standard (free) API access, automatically falls back to returning the nearest city's air qu

## Example prompts
- "What can I do in Iqair Airvisual?"
- "Show me a summary of my Iqair Airvisual account"

## Links
Docs: https://mcp.ai/docs/mcps/iqair_airvisual
Website: https://mcp.ai/mcps/iqair_airvisual