# AirVisual MCP for AI Agents AI Agent Connect

> AirVisual lets you pull real-time air quality and weather data into your AI agent. You can check the Air Quality Index (AQI) for any city, find the nearest monitoring station using your IP or GPS coordinates, and get hyper-local pollution details. It connects your IQAir account to your workflow so you can stay informed about environmental health without switching tabs.

## Overview
- **Category:** iot-hardware
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_VGX1iJ9zQN0X34um29FbzVGt7YkF8gKTQwxcCGbx/ai-agent-connect
- **Tags:** air-quality, aqi, pollution-tracking, environmental-monitoring, weather-data

## Description

Imagine you're trying to plan a hike or just want to know if it's safe to open the windows today. Instead of opening multiple tabs to check different weather sites and air quality maps, you just ask your agent. This Connector connects your AirVisual account directly to your AI client, making it the go-to source for environmental data. You can ask for the current pollution levels in a specific neighborhood, see what the weather looks like in a different country, or find out what the air feels like at your exact location. It handles the heavy lifting of fetching data from thousands of global monitoring stations. Because Vinkius makes it easy to manage these connections, you can set up this tool in minutes and start getting real-time updates. It's about having the most accurate environmental data available right when you need it. You can quickly pivot from checking the air in Tokyo to seeing the humidity in London, or even drill down into specific station details for hyper-local insights. It turns your AI into a personal environmental monitor that knows the current conditions of the world.

## Tools

### get_nearest_city_by_coords
Find the nearest city data based on specific GPS coordinates. This is perfect for pinpointing your exact location.

### get_nearest_city_by_ip
Get air quality and weather data for the city closest to your current IP. It removes the need to type in your location.

### get_station_data
Access detailed data from a specific monitoring station. This gives you hyper-local insights for precise tracking.

### list_cities
Get a list of all cities supported within a specific state. This helps you find the right data points for your area.

### get_city_data
Pull the current AQI and weather for a specific city. Use this to get a quick snapshot of local conditions.

### list_countries
See all the countries that are supported by the platform. This is great for broad environmental research.

### list_states
See all supported states within a specific country. Use this to navigate to specific regions for data collection.

## Prompt Examples

**Prompt:** 
```
What's the air quality like in New York City right now?
```

**Response:** 
```
### Current Conditions for New York City

| Metric | Value |
| :--- | :--- |
| **Air Quality Index (AQI)** | 45 (Good) |
| **Main Pollutant** | PM2.5 |
| **Temperature** | 22°C |
| **Humidity** | 50% |

**Summary:** The air quality is currently good. You can safely spend time outdoors with minimal risk from pollutants.
```

**Prompt:** 
```
Check the air quality for my current location.
```

**Response:** 
```
Based on your IP address, I've found the nearest city data for **San Francisco**. 

*   **AQI:** 18 (Excellent)
*   **Weather:** Clear skies, 16°C
*   **Conditions:** The air is very clean right now, making it a great time for outdoor activities.
```

**Prompt:** 
```
What states are in the US that have air quality data?
```

**Response:** 
```
I've found the following supported states in the United States:

*   Alabama
*   Alaska
*   Arizona
*   Arkansas
*   California
*   Colorado
*   Connecticut
*   Delaware
*   Florida
*   Georgia
*   Hawaii
*   Idaho
*   Illinois
*   Indiana
*   Iowa
*   Kansas
*   Kentucky
*   Louisiana
*   Maine
*   Maryland
*   Massachusetts
*   Michigan
*   Minnesota
*   Mississippi
*   Missouri
*   Montana
*   Nebraska
*   Nevada
*   New Hampshire
*   New Jersey
*   New Mexico
*   New York
*   North Carolina
*   North Dakota
*   Ohio
*   Oklahoma
*   Oregon
*   Pennsylvania
*   Rhode Island
*   South Carolina
*   South Dakota
*   Tennessee
*   Texas
*   Utah
*   Vermont
*   Virginia
*   Washington
*   West Virginia
*   Wisconsin
*   Wyoming
```

## Capabilities

### Get real-time AQI and weather
Pull current air quality and meteorological data for any city instantly.

### Find nearest stations by IP
Locate the closest air quality data based on your current internet connection.

### Use GPS for proximity search
Get data for the nearest monitoring station using specific coordinates.

### Browse countries and states
Identify supported regions to find data for different parts of the world.

### Access station-level detail
Get granular environmental insights from specific monitoring stations.

### List supported cities
See all available cities within a specific state to find your local data.

## Use Cases

### Checking safety for a run
A runner asks "Is the air safe to run outside in Chicago?" and the agent uses get_city_data to check the AQI and primary pollutants.

### Mapping out pollution trends
A scientist asks for a list of states in Canada and then pulls data for each to map out pollution levels across the country.

### Pre-trip travel prep
A traveler asks about the weather and AQI in Tokyo to see if they need to pack extra masks for their upcoming flight.

### Smart home automation
A user asks for the nearest city data via IP to see if they should turn on their home air purifier based on local pollution.

## Benefits

- You get instant AQI updates without leaving your chat interface. By using get_city_data, you can see current pollution levels and weather for any city in seconds, which helps you stay informed about environmental health without switching apps.
- You can find hyper-local data using get_nearest_city_by_ip so you don't have to guess your local conditions. This is perfect for checking the air outside your front door without having to manually input your address or coordinates every time.
- You can research global trends across different regions using list_countries and list_states. This allows you to quickly identify which areas have the most comprehensive data available for your specific research goals.
- You can pinpoint exact station details with get_station_data for high-precision environmental monitoring. This is a huge win for researchers who need to know the specific readings from a known sensor rather than just a general city average.
- You can quickly browse available locations using list_cities to find the best data points for your area. It saves you from clicking through menus on a website just to see which neighborhoods are actually covered by the monitoring network.

## How It Works

The bottom line is you get instant, accurate environmental data from global stations without leaving your chat interface.

1. Subscribe to the AirVisual MCP on Vinkius.
2. Enter your AirVisual API Key in the configuration.
3. Ask your AI client to check the air quality or weather anywhere in the world.

## Frequently Asked Questions

**Can I use AirVisual MCP to check the air quality in my own backyard?**
Yes, you can. By asking your agent to check the air quality near your current location, it will use your IP or GPS coordinates to find the nearest monitoring station and give you the local data.

**Does AirVisual MCP provide weather forecasts too?**
Yes, it provides both air quality and meteorological data. When you ask about a city, your agent will give you the AQI, the temperature, and the humidity levels all at once.

**Can I get data for specific countries?**
Absolutely. You can ask your agent to list supported countries or look up the air quality and weather for any specific nation in the global network.

**Is the data from AirVisual MCP real-time?**
Yes, the data is pulled in real-time from the AirVisual platform, meaning you get the most current readings available from their global monitoring stations.

**How do I get data for a specific city?**
Just ask your AI agent. You can say something like 'What is the air quality in Tokyo?' and it will automatically fetch the current AQI and weather for that city.

**Can I see specific details for a monitoring station?**
Yes, if you know the specific station you want to monitor, your agent can pull granular data directly from that station for hyper-local insights.

**Can I get air quality data for my current location without entering coordinates?**
Yes! You can use the `get_nearest_city_by_ip` tool. The agent will use your requester IP address to find and return the AQI and weather data for the closest supported city automatically.

**How do I find out which cities are supported in a specific region?**
You can browse the hierarchy using `list_countries`, then `list_states` for a specific country, and finally `list_cities` for a specific state. This allows you to discover exactly which locations have active monitoring.

**Does this server provide data from specific monitoring stations?**
Yes, the `get_station_data` tool allows you to retrieve real-time data from a specific named monitoring station if you know its name and location details (city, state, country).