# CleanAirData

> CleanAirData is a free MCP server for health and science. Historical US city PM2.5 and Clean Air Scores that name the source city of copied records. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://cleanairdata.org/developers/api
- **MCP Registry name:** io.github.chenweilie/cleanairdata
- **Categories:** health and science, analytics and data
- **Listing updated:** 2026-11-17

## About

CleanAirData's MCP server serves annual air-quality records for US cities, and it is careful about provenance. Most city pages reuse the record of the nearest scored city, and every result says whether the record is the city's own or copied, naming the source city and its distance, so a copied value is never passed off as a measurement for the named city.

Three read-only tools need no key. get_city_air_quality returns the score, grade, annual PM2.5, share of unhealthy days, trend and yearly values for a city; compare_cities puts two cities side by side with a warning when a record is copied; rank_cities lists the highest Clean Air Scores, restricted to cities with their own record by default. Results are historical annual data, not the current AQI.

The limit is 10 requests per 10 seconds per IP address. The same site also offers a separate current AQI route, which uses public sources, may use fallbacks, and is not meant as an emergency alert. Commercial API terms are not active yet.

## Features

- **City air-quality score:** Score, grade and annual PM2.5 for one city.
- **City comparison:** Two cities side by side with copied-record warnings.
- **City ranking:** Top Clean Air Scores, own-record cities by default.
- **Provenance labels:** Every result states own or copied and the source city.
- **No key needed:** Free read-only endpoint with a rate limit.

## Good for

- Compare air quality between two US cities
- Find the cities with the cleanest air
- Check how many days a year were unhealthy
- Verify whether a figure is a city's own measurement

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http cleanairdata https://cleanairdata.org/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://cleanairdata.org/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cleanairdata": {
      "url": "https://cleanairdata.org/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cleanairdata": {
      "type": "http",
      "url": "https://cleanairdata.org/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cleanairdata": {
      "serverUrl": "https://cleanairdata.org/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cleanairdata": {
      "type": "http",
      "url": "https://cleanairdata.org/api/mcp"
    }
  }
}
```

## Tools

- `get_city_air_quality`: Score, grade, annual PM2.5, unhealthy-day share and trend for a city
- `compare_cities`: Compare two cities side by side
- `rank_cities`: Rank cities by Clean Air Score

## FAQ

### Is it current air quality?

No. The MCP returns historical annual data, not the current AQI.

### What are copied records?

Records reused from the nearest scored city, flagged with the source and distance.

### Do I need a key?

No.

### What is the rate limit?

10 requests per 10 seconds per IP address.

### Is CleanAirData free?

Yes. CleanAirData is free to use.

### How do I add CleanAirData to Claude Code?

Run this command in your terminal: claude mcp add --transport http cleanairdata https://cleanairdata.org/api/mcp

### What are the best alternatives to CleanAirData?

The closest alternatives to CleanAirData are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tooluniverse, Oya Browser and Tapetide - Indian Stock Market MCP.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/cleanairdata
