# Atmy air quality

> Atmy air quality is a free MCP server for health and science. Open air quality API for AI agents: PM2.5 for about 300 cities and 12,000 sensors. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web, CLI
- **Website:** https://atmy.ai/air-quality/api/
- **MCP Registry name:** ai.atmy/air-quality
- **Categories:** health and science
- **Listing updated:** 2026-11-15

## About

Atmy publishes read-only PM2.5 data for roughly 300 cities, looked up by name in 25 languages or by coordinates, along with single-sensor readings from Sensor.Community, AirGradient, Atmy's own devices and government stations. PurpleAir is excluded because its terms bar redistribution. No sign-up or key is needed.

The endpoints cover current air quality, daily and monthly history, forecasts, country rankings, and lists of cities, networks and sensors. Levels follow the US EPA 2024 PM2.5 breakpoints, and the API intentionally gives no numeric AQI. Each night Atmy checks every sensor's previous day and gives it a 0 to 10 rating (50% PM data, 30% regular transmission, 20% temperature and humidity); failing sensors stay visible with quality.pm_eligible set to false, while city values use only passing ones. Indoor sensors are filtered out.

The MCP server offers the same data as tools, over stdio via the atmy-mcp npm package or at api.atmy.ai/mcp. Limits are 60 requests per minute per IP, values are approximate low-cost sensor readings, and attribution to Atmy and the source network is required.

## Features

- **City air quality:** Current, historical and forecast PM2.5 by city name or coordinates.
- **Country rankings:** Ranks cities by PM2.5 within a country.
- **Sensor readings:** Per-sensor data from several open networks.
- **Nightly quality rating:** Sensors get a 0-10 rating and can be filtered by minimum rating.
- **EPA-based levels:** Uses 2024 US EPA PM2.5 breakpoints without a numeric AQI.
- **Stdio and HTTP:** Run via npm or connect to the hosted endpoint.

## Good for

- Answer what the air is like in a city right now
- Rank cities in a country by pollution
- Pick reliable sensors with a minimum quality rating
- Pull monthly PM2.5 history for a report

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http air-quality https://api.atmy.ai/mcp
```

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

```sh
https://api.atmy.ai/mcp
```

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

```json
{
  "mcpServers": {
    "air-quality": {
      "url": "https://api.atmy.ai/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "air-quality": {
      "type": "http",
      "url": "https://api.atmy.ai/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "air-quality": {
      "serverUrl": "https://api.atmy.ai/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "air-quality": {
      "type": "http",
      "url": "https://api.atmy.ai/mcp"
    }
  }
}
```

## FAQ

### Do I need an API key?

No. The API is public and read-only.

### What is the rate limit?

60 requests per minute per IP address; over the limit returns 429.

### Is it official monitoring data?

No. Values are approximate, from low-cost sensors.

### Is attribution required?

Yes, credit Atmy (atmy.ai) and the sensor network.

### Is Atmy air quality free?

Yes. Atmy air quality is free to use.

### How do I add Atmy air quality to Claude Code?

Run this command in your terminal: claude mcp add --transport http air-quality https://api.atmy.ai/mcp

### What are the best alternatives to Atmy air quality?

The closest alternatives to Atmy air quality are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Alternatives

- [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.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/atmy-air-quality
