> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# iqair

> Air Quality Data

**Server path:** `/iqair` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                              | Description                            |
| --------------------------------------------------------------------------------- | -------------------------------------- |
| [`iqair_get_city_air_quality`](#iqair_get_city_air_quality)                       | Get air quality for a specific city    |
| [`iqair_get_city_ranking`](#iqair_get_city_ranking)                               | Get world air quality city ranking     |
| [`iqair_get_nearest_city_air_quality`](#iqair_get_nearest_city_air_quality)       | Get air quality for nearest city       |
| [`iqair_get_nearest_station_air_quality`](#iqair_get_nearest_station_air_quality) | Get air quality from nearest station   |
| [`iqair_get_station_air_quality`](#iqair_get_station_air_quality)                 | Get air quality for a specific station |
| [`iqair_list_cities`](#iqair_list_cities)                                         | List cities in a state                 |
| [`iqair_list_countries`](#iqair_list_countries)                                   | List supported countries               |
| [`iqair_list_states`](#iqair_list_states)                                         | List states in a country               |

***

## iqair\_get\_city\_air\_quality

Get air quality for a specific city

**Parameters:**

| Parameter | Type   | Required | Default | Description                               |
| --------- | ------ | -------- | ------- | ----------------------------------------- |
| `city`    | string | Yes      | —       | City name (e.g. 'Los Angeles', 'Beijing') |
| `state`   | string | Yes      | —       | State name (e.g. 'California', 'Beijing') |
| `country` | string | Yes      | —       | Country name (e.g. 'USA', 'China')        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "city": {
        "type": "string",
        "description": "City name (e.g. 'Los Angeles', 'Beijing')"
      },
      "state": {
        "type": "string",
        "description": "State name (e.g. 'California', 'Beijing')"
      },
      "country": {
        "type": "string",
        "description": "Country name (e.g. 'USA', 'China')"
      }
    },
    "required": [
      "PCID",
      "city",
      "state",
      "country"
    ]
  }
  ```
</Expandable>

***

## iqair\_get\_city\_ranking

Get world air quality city ranking

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## iqair\_get\_nearest\_city\_air\_quality

Get air quality for nearest city

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                |
| --------- | ------ | -------- | ------- | -------------------------------------------------------------------------- |
| `lat`     | number | No       | —       | Latitude coordinate (e.g. 34.0522). If omitted, IP geolocation is used.    |
| `lon`     | number | No       | —       | Longitude coordinate (e.g. -118.2437). If omitted, IP geolocation is used. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "lat": {
        "type": "number",
        "description": "Latitude coordinate (e.g. 34.0522). If omitted, IP geolocation is used."
      },
      "lon": {
        "type": "number",
        "description": "Longitude coordinate (e.g. -118.2437). If omitted, IP geolocation is used."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## iqair\_get\_nearest\_station\_air\_quality

Get air quality from nearest station

**Parameters:**

| Parameter | Type   | Required | Default | Description                                               |
| --------- | ------ | -------- | ------- | --------------------------------------------------------- |
| `lat`     | number | No       | —       | Latitude coordinate. If omitted, IP geolocation is used.  |
| `lon`     | number | No       | —       | Longitude coordinate. If omitted, IP geolocation is used. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "lat": {
        "type": "number",
        "description": "Latitude coordinate. If omitted, IP geolocation is used."
      },
      "lon": {
        "type": "number",
        "description": "Longitude coordinate. If omitted, IP geolocation is used."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## iqair\_get\_station\_air\_quality

Get air quality for a specific station

**Parameters:**

| Parameter | Type   | Required | Default | Description                               |
| --------- | ------ | -------- | ------- | ----------------------------------------- |
| `station` | string | Yes      | —       | Station name                              |
| `city`    | string | Yes      | —       | City name where the station is located    |
| `state`   | string | Yes      | —       | State name where the station is located   |
| `country` | string | Yes      | —       | Country name where the station is located |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "station": {
        "type": "string",
        "description": "Station name"
      },
      "city": {
        "type": "string",
        "description": "City name where the station is located"
      },
      "state": {
        "type": "string",
        "description": "State name where the station is located"
      },
      "country": {
        "type": "string",
        "description": "Country name where the station is located"
      }
    },
    "required": [
      "PCID",
      "station",
      "city",
      "state",
      "country"
    ]
  }
  ```
</Expandable>

***

## iqair\_list\_cities

List cities in a state

**Parameters:**

| Parameter | Type   | Required | Default | Description                               |
| --------- | ------ | -------- | ------- | ----------------------------------------- |
| `state`   | string | Yes      | —       | State name (e.g. 'California', 'Beijing') |
| `country` | string | Yes      | —       | Country name (e.g. 'USA', 'China')        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "state": {
        "type": "string",
        "description": "State name (e.g. 'California', 'Beijing')"
      },
      "country": {
        "type": "string",
        "description": "Country name (e.g. 'USA', 'China')"
      }
    },
    "required": [
      "PCID",
      "state",
      "country"
    ]
  }
  ```
</Expandable>

***

## iqair\_list\_countries

List supported countries

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## iqair\_list\_states

List states in a country

**Parameters:**

| Parameter | Type   | Required | Default | Description                                 |
| --------- | ------ | -------- | ------- | ------------------------------------------- |
| `country` | string | Yes      | —       | Country name (e.g. 'USA', 'China', 'India') |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "country": {
        "type": "string",
        "description": "Country name (e.g. 'USA', 'China', 'India')"
      }
    },
    "required": [
      "PCID",
      "country"
    ]
  }
  ```
</Expandable>