Skip to content
MCP server

Atmy air quality

Open air quality API for AI agents: PM2.5 for about 300 cities and 12,000 sensors

Install
Pricing
Free
Platforms
API, Web, CLI
Runs
Locally or Remotely
Version
1.1.0
Listing updated
2 days ago

About Atmy air quality

Atmy air quality is a free MCP server for health and science. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.atmy.ai/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "air-quality": {
      "url": "https://api.atmy.ai/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Free

Free, no key; 60 requests/minute per IP

Prices change. Check atmy.ai before you buy.

Atmy air quality 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 to Atmy air quality

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science