Skip to content
MCP server

CleanAirData

Historical US city PM2.5 and Clean Air Scores that name the source city of copied records

Install
Pricing
Free
Platforms
API, Web
Runs
Remotely
Version
0.1.0
Listing updated
today

About CleanAirData

CleanAirData is a free MCP server for health and science. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cleanairdata": {
      "url": "https://cleanairdata.org/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Free

Free; commercial API terms not yet active

Prices change. Check cleanairdata.org before you buy.

CleanAirData 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 to CleanAirData

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. 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
  4. Oya Browser

    MCP server

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

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  5. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  6. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data