{
  "info": {
    "name": "Iqair Airvisual — mcp.ai",
    "description": "REST API for the Iqair Airvisual MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/iqair_airvisual",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "iqair_airvisual_get_air_quality_forecast_data",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/air/quality/forecast/data",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "air",
            "quality",
            "forecast",
            "data"
          ]
        },
        "description": "Tool to retrieve air quality forecast data for a specified city, state, and country. Use after confirming location details.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"city\": \"\",\n  \"state\": \"\",\n  \"country\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "iqair_airvisual_get_cities",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/cities",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "cities"
          ]
        },
        "description": "Tool to list supported cities in a specified state and country. Use when you need to retrieve cities for a given state/country.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"state\": \"\",\n  \"country\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "iqair_airvisual_get_city_air_quality",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/city/air/quality",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "city",
            "air",
            "quality"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"city\": \"\",\n  \"state\": \"\",\n  \"country\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "iqair_airvisual_get_countries",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/countries",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "countries"
          ]
        },
        "description": "Tool to list all supported countries. Use when you need to know which countries are supported by the AirVisual API.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "iqair_airvisual_get_historical_aqi_data",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/historical/aqi/data",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "historical",
            "aqi",
            "data"
          ]
        },
        "description": "Tool to retrieve historical air quality data for a city. Use after confirming city, state, and country when you need AQI readings over time.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"end\": \"\",\n  \"city\": \"\",\n  \"start\": \"\",\n  \"state\": \"\",\n  \"country\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "iqair_airvisual_get_nearest_city_air_quality",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/nearest/city/air/quality",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "nearest",
            "city",
            "air",
            "quality"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ip\": \"\",\n  \"lat\": 0,\n  \"lon\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "iqair_airvisual_get_nearest_station_air_quality",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/nearest/station/air/quality",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "nearest",
            "station",
            "air",
            "quality"
          ]
        },
        "description": "Tool to get nearest station air quality. Use when you have GPS coordinates and need closest station’s AQI.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"lat\": 0,\n  \"lon\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "iqair_airvisual_get_states",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/states",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "states"
          ]
        },
        "description": "Tool to list supported states in a specified country. Use when you need to retrieve states/provinces for a given country.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"country\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "iqair_airvisual_get_station_by_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/station/by/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "station",
            "by",
            "id"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"city\": \"\",\n  \"state\": \"\",\n  \"country\": \"\",\n  \"station\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "iqair_airvisual_get_world_ranking",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/world/ranking",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "world",
            "ranking"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ip\": \"\",\n  \"lat\": 0,\n  \"lon\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}