# IQAir MCP for AI Agents AI Agent Connect

> IQAir lets your AI agent pull real-time air quality indices (AQI) and weather data for any city in its catalog. Use it to audit pollution levels, check local weather conditions like humidity and pressure, and monitor environmental markers for research or health assessments. It turns complex pollution data into plain-text answers for your agent, making it a go-to for environmental research and sustainability audits.

## Overview
- **Category:** data-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_JCjmdGZ7DsshUYFxHI0BydM57Q1WVp8TR4MW1paZ/ai-agent-connect
- **Tags:** air-quality, pollution-data, aqi, environmental-monitoring, weather-data, real-time-sync

## Description

Getting a clear picture of air quality usually involves digging through complex dashboards or hunting for specific city data across multiple websites. If you're trying to track pollution trends or verify local atmospheric conditions, you're likely spending way too much time copy-pasting numbers into a spreadsheet. This Connector changes that by letting your AI agent do the heavy lifting for you. Instead of manually searching for the Air Quality Index or checking if a city's humidity is affecting local smog, you can just ask your agent to pull the data directly. Whether you're looking for specific pollutants in a major hub or just want to see what the air feels like near your current location, the information comes back instantly. It's about moving from manual data gathering to immediate insights. By adding this to your toolkit on Vinkius, you give your agent the ability to act as a real-time environmental researcher. You get precise, localized data without ever having to navigate a technical portal or deal with messy API responses. It's built for anyone who needs to know what the air looks like right now, where it matters most. You can quickly audit multiple locations to see how pollution varies by region or check the status of the data feed to ensure your research stays on track. It turns a complex environmental search into a simple conversation.

## Tools

### get_nearest_city_air_quality
Find the air quality data for the city closest to your current IP address. This is perfect for quick local checks.

### list_supported_cities
Find every city available in a specific state and country. This is useful for verifying geographic reach before starting a research project.

### list_supported_countries
See a complete list of every country covered by the IQAir network. Use this to understand the global scale of the data.

### list_supported_states
Get a list of all states within a specific country that have data. This helps narrow down regional monitoring options.

### check_api_status
Confirm that the IQAir service is currently online and responding. Use this to ensure your automated workflows stay active.

### get_city_air_quality
Fetch current AQI, weather, and pollutants for a specific city. It provides immediate data for urban pollution audits.

## Prompt Examples

**Prompt:** 
```
What's the air quality like in Paris right now?
```

**Response:** 
```
I've retrieved the current air quality data for Paris. Here is the breakdown:

| Metric | Value |
| :--- | :--- |
| **Air Quality Index (AQI)** | 42 (Good) |
| **Temperature** | 18°C |
| **Humidity** | 55% |
| **Main Pollutant** | PM2.5 |

The air quality is currently within safe limits. Would you like to see the data for any other cities?
```

**Prompt:** 
```
Check the air quality for the city I'm in.
```

**Response:** 
```
I've identified the nearest monitored city via your IP! The air quality is currently **Moderate** with an AQI of 65. The main pollutant is identified as PM2.5. I can provide the full weather breakdown if you'd like.
```

**Prompt:** 
```
Which countries can we get air quality data for?
```

**Response:** 
```
I've scanned the global catalog. We can currently pull real-time air quality and weather data for over 150 countries. Let me know if you want to see the full list of countries or check for a specific state within one of them.
```

## Capabilities

### Fetch real-time air quality
Get current AQI and weather data for any specific city in the catalog.

### Identify nearby pollution
Automatically find and report air quality for the city closest to your current IP.

### Browse global coverage
List all countries and states supported by the IQAir network.

### Search specific cities
Retrieve a full list of monitored cities within a specific state and country.

### Verify data connectivity
Check if the IQAir API is currently online and operational.

## Use Cases

### Health safety checks for clinics
A health worker needs to know if a city is safe for a respiratory clinic and asks the agent to check the AQI for 'New Delhi' using get_city_air_quality.

### Mapping global pollution trends
A researcher needs to see which countries have data and uses list_supported_countries to map out a global study.

### Corporate site audits
A sustainability lead wants to see what's near an office and uses get_nearest_city_air_quality to see local pollution markers.

### Regional site identification
A team needs to find all cities in a specific region and uses list_supported_states and list_supported_cities to build a list of sites.

## Benefits

- Stop manual searching by using get_city_air_quality to pull AQI and weather data instantly.
- Map out global coverage quickly with list_supported_countries to see exactly where data is available.
- Identify local hotspots for your team using get_nearest_city_air_quality to check your immediate surroundings.
- Save hours on research by using list_supported_states and list_supported_cities to verify geographic reach.
- Ensure your data pipeline stays active by using check_api_status to monitor the connection health.
- Get precise pollutant markers like PM2.5 directly in your chat instead of hunting through technical dashboards.

## How It Works

The bottom line is you get instant, actionable environmental data without leaving your chat interface.

1. Subscribe to the IQAir MCP on the marketplace.
2. Provide your IQAir API key in the configuration settings.
3. Ask your agent to check pollution or weather for any location.

## Frequently Asked Questions

**Can I use IQAir to see pollution in my own city?**
Yes, if your city is in the catalog, your agent can pull real-time AQI and weather data instantly. It identifies the nearest monitored city based on your location.

**What kind of weather info does IQAir provide?**
It provides the current temperature, humidity, and atmospheric pressure alongside the air quality index for a complete environmental snapshot.

**Is this good for climate change research?**
Yes, it's a great way to get real-time pollution markers and metadata for specific global locations to support your research.

**Can my agent find the nearest city for me?**
Yes, it uses your IP to identify the closest monitored city and pull its current air quality data automatically.

**Does IQAir cover every country in the world?**
It covers a wide range of countries and states. You can ask your agent to list all supported countries to see exactly where it can pull data.

**How do I know if the data is live?**
The agent pulls real-time data from the IQAir platform, ensuring you see the most current conditions available at that moment.

**How do I find my IQAir API Key?**
Log in to your [**IQAir dashboard**](https://www.iqair.com/dashboard/api), create a new key in the API section, and copy it. Copy and paste it below.

**Does the agent use the server's IP for nearest city?**
Yes. The `get_nearest_city_air_quality` tool automatically uses the requester's IP address to identify and audit the nearest monitored location.

**Are weather details included with air quality?**
Yes. Every city data retrieval includes current weather metadata such as temperature, humidity, and atmospheric pressure alongside the AQI.