# AQICN MCP

> AQICN provides real-time environmental intelligence by pulling data from over 30,000 global monitoring stations. It delivers live Air Quality Index (AQI) readings and pollutant levels like PM2.5 or Ozone, combined with localized weather forecasts. You get hyper-local air quality reports for any city, specific station, or area defined by map coordinates.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** air-quality, aqi, pollution-monitoring, environmental-data, weather

## Description

Getting accurate environmental data used to mean manually visiting different government websites and cross-referencing pollution maps. This MCP changes that. It lets your AI client connect directly to the world's largest public air quality database. You can ask for current air quality in a specific city, like London, or pinpoint exactly what the pollutant levels are at a single monitoring station using its unique ID. Need data for an entire neighborhood? Just give it map coordinates and pull every active station within that box. It also automatically checks the closest available station based on your IP address without you having to type anything. Whether you're tracking PM2.5 trends or need general weather context, this MCP brings all global environmental metrics into a single conversation flow, making complex data retrieval simple through Vinkius.

## Tools

### get_city_feed
Gets the real-time Air Quality Index data for any specified major city.

### get_ip_feed
Returns the current AQI and pollution data based on your device's location IP address.

### get_map_bounds
Retrieves all available station feeds within a specific set of geographical map coordinates.

### search_stations
Searches the database to find air quality monitoring stations using keywords or names in any region.

### get_station_feed
Retrieves precise, real-time AQI data for one specific station identified by its unique ID (UID).

## Prompt Examples

**Prompt:** 
```
What's the current air quality in London?
```

**Response:** 
```
I've checked the feed for London. The current AQI is 42 (Good), with PM2.5 as the primary pollutant. The temperature is 12°C with 78% humidity.
```

**Prompt:** 
```
Search for air quality monitoring stations in Beijing.
```

**Response:** 
```
I found several stations in Beijing. The main station (UID 1451) reports an AQI of 156 (Unhealthy). Other nearby stations include Dongsi and Temple of Heaven.
```

**Prompt:** 
```
Show me all air quality stations within these coordinates: 39.37,116.09,40.23,116.78.
```

**Response:** 
```
Scanning the area... I've identified 8 active stations within those bounds. AQI levels range from 140 to 165 across the grid. Would you like the specific details for the station with the highest pollution?
```

## Capabilities

### Check air quality for an entire city
It pulls the current AQI and pollutant data for any major metropolitan area.

### Get readings from a single station ID
You can request precise, real-time air quality data using a specific monitoring station's unique identifier.

### Find stations by IP address
The MCP automatically detects and provides the nearest available monitoring station based on your connection location.

### Search for stations anywhere globally
You can find air quality monitoring stations simply by entering a name or keyword, narrowing down your search region.

### Map specific geographic areas
Retrieve all active stations and their corresponding pollution data within defined map coordinates (a bounding box).

## Use Cases

### Planning a cross-country field study
A researcher needs air quality across five different cities over three weeks. Instead of booking travel and then manually checking pollution reports, they ask their agent to use the get_city_feed tool for all five locations weekly, compiling the data into one comparison report.

### Assessing a new construction site's air quality
An urban planner needs to know if a proposed area is safe. They use their agent to call get_map_bounds with the project coordinates, immediately identifying pollution hot spots and nearby monitoring stations for mitigation planning.

### Checking safety before an outdoor workout
A fitness coach wants to advise clients on running routes. They use their agent to run get_ip_feed while at the client's location, getting immediate PM2.5 levels and advising if the air is safe for exercise that day.

### Troubleshooting a sensor network
A maintenance engineer suspects a specific monitoring station is faulty. They use search_stations to confirm the UID and then run get_station_feed with that exact ID to verify if recent data streams are failing.

## Benefits

- Instantly check city-wide reports for major metropolitan areas. Use the get_city_feed tool to get a quick, high-level understanding of air safety in any global location.
- Never guess about pollution levels again. The get_station_feed tool lets you pull data from one precise station using its unique ID, ensuring maximum accuracy for critical reports.
- It works even if you don't know the exact coordinates or name. Using get_ip_feed automatically targets the nearest available monitoring station based on your current connection point.
- Need to cover a whole district? The get_map_bounds tool lets you define an area with map coordinates and pull every active station feed inside that boundary for comprehensive analysis.
- Start from scratch. If you just need to find out what stations exist near 'Beijing' or 'University Park,' use the search_stations tool to locate potential data sources first.

## How It Works

The bottom line is your AI client gets live environmental readings instantly without you needing to use a web browser or copy any IDs manually.

1. First, subscribe to this MCP on Vinkius and enter your personal AQICN API Token.
2. Next, tell your AI client exactly what you need—for example, 'What is the air quality in Berlin?' or 'Show me all stations within these coordinates.'
3. The system runs the appropriate tool call against the database and returns real-time data, including pollutant levels, AQI scores, and local weather.

## Frequently Asked Questions

**How do I use the AQICN MCP to check a whole city's air quality?**
Use the get_city_feed tool. You just need to specify the name of the major city, and it provides an instant report on the overall AQI for that area.

**Can I check a specific monitoring station's data using get_station_feed?**
Yes, you must use its unique ID (UID) with the get_station_feed tool. This gives you the most precise and accurate reading possible.

**What if I don't know the city name or the station name? Do I need search_stations?**
Yes, use search_stations first. You can enter a general keyword or area name to find potential stations and their UIDs before requesting specific data.

**What is the best way to check pollution across a large park?**
Use get_map_bounds. You provide the corner coordinates of the park, and this tool will list every active station within that defined area for comparison.

**How does AQICN MCP know where I am right now?**
If you don't specify a location, use get_ip_feed. This method automatically determines your nearest available monitoring station based on the IP address connecting to your AI client.