Airnow MCP Server

🚀 AirNow MCP Server

The AirNow MCP Server is an unofficial implementation of the Model Context Protocol (MCP). It facilitates the integration between large language models (LLMs) and the AirNow API, providing real - time, forecasted, and historical U.S. air quality data.

🚀 Quick Start

The AirNow MCP Server is an unofficial Model Context Protocol (MCP) implementation. It bridges the gap between large language models (LLMs) and the AirNow API, which offers U.S. air - quality data. With this server, LLMs can access and make use of real - time, forecasted, and historical air - quality information.

✨ Features

• Standardized Access: Gain direct access to AirNow API resources using standardized MCP tools.
• Natural Language Interface: Query air - quality data through a natural - language interface.
• Comprehensive Data Support: Support for current, forecasted, and historical AQI, observations, and contour maps.
• Easy Integration: Seamlessly integrate via NPX or Docker.

📚 Documentation

About the AirNow API

The AirNow API offers access to official U.S. air - quality data, including:

• Current and Forecasted Air Quality Index (AQI): Retrieve real - time and forecasted AQI values for ozone, PM2.5, and PM10 for specific locations or regions.
• Observations and Reporting Areas: Access air - quality observations by ZIP code, latitude/longitude, bounding box, or reporting area.
• Air Quality Maps: Obtain contour maps for ozone and PM2.5, available as images or data overlays.
• Historical Data: Query historical air - quality data for supported pollutants.
• Health Recommendations: The API provides health recommendations and cautionary statements based on AQI levels.

For detailed information on endpoints, parameters, and response formats, log in with your AirNow API account and visit the AirNow API Web Services Documentation.

Available Tools

Forecasts

• forecast_by_lat_long: Get current or historical forecasted AQI values and categories for a reporting area by latitude and longitude.
• forecast_by_zip_code: Get current or historical forecasted AQI values and categories for a reporting area by Zip code.

Contour Maps

• contour_maps_by_geographic_bounding_box_ozone: Get current or historical ozone contour maps in KML.
• contour_maps_by_geographic_bounding_box_pm25: Get current or historical PM2.5 contour maps in KML.
• contour_maps_by_bounding_box_combined_ozone_pm25: Get current or historical contour maps in KML for combined ozone and PM2.5 values.

Observations

• current_observations_by_reporting_area_by_lat_long: Get current AQI values and categories for a reporting area by latitude and longitude.
• current_observations_by_reporting_area_by_zip_code: Get current AQI values and categories for a reporting area by Zip code.
• observations_by_monitoring_site_by_geographic_bounding_box: Get AQI values or data concentrations for a specified date and time range and set of parameters within a geographic area of interest.

Historical Data

• historical_observations_by_reporting_area_by_lat_long: Get historical AQI values and categories for a reporting area by latitude and longitude.
• historical_observations_by_reporting_area_by_zip_code: Get historical AQI values and categories for a reporting area by Zip code.

📦 Installation

Requirements

• An AirNow API key, which you can obtain by requesting an AirNow API Account.
• For use with NPX, Node.js >= v22.14.0 is required.

Configuration

Claude Desktop

Add one of these configurations to your claude_desktop_config.json:

NPX

{
  "mcpServers": {
    "airnow-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@prsantos/airnow-mcp-server"
      ],
      "env":{
        "AIRNOW_API_KEY": "<YOUR-AIRNOW-API-KEY>",
        "APPDATA": "<Value of APPDATA>" // Windows example: "C:\\Users\\[username]\\AppData\\Roaming"
      }
    }
  }
}

Note:

• For Windows, get the APPDATA value by opening the Command Prompt and running: echo %APPDATA%
• For Mac, get the APPDATA value by opening the Terminal and running: which npm

Docker

{
  "mcpServers": {
    "airnow-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AIRNOW_API_KEY",
        "prsantos/airnow-mcp-server"
      ],
      "env":{
        "AIRNOW_API_KEY": "<YOUR-AIRNOW-API-KEY>"
      }
    }
  }
}