AirNow Tools Reference

Complete reference for all AirNow MCP tools.

Available Tools

The AirNow service provides the following MCP tools:

RSS Feed Tools

• airnow.get_forecast_rss - Get air quality forecast RSS feed for a state/city
• airnow.get_action_day_rss - Get action day RSS feed (air quality alerts)
• airnow.get_current_conditions_rss - Get current air quality conditions RSS feed

REST API Tools

• airnow.get_current_observations - Get current observations by ZIP code or lat/lon
• airnow.get_forecast - Get forecast by ZIP code or lat/lon
• airnow.get_historical_observations - Get historical observations by ZIP code

Tool Details

See the AirNow Examples page for usage examples.

RSS Feed Tools

airnow.get_forecast_rss

Get air quality forecast RSS feed.

Arguments:

• state (required): 2-letter state code (e.g., "CA")
• city (optional): City name (e.g., "San Francisco")
• data_format (optional): "cleaned" (default) or "raw"

Returns: Forecast data with multiple days, AQI values, and pollutant types.

airnow.get_action_day_rss

Get action day RSS feed for air quality alerts.

Arguments:

• state (required): 2-letter state code
• city (optional): City name
• data_format (optional): "cleaned" (default) or "raw"

Returns: Action day information and alerts.

airnow.get_current_conditions_rss

Get current air quality conditions RSS feed.

Arguments:

• state (required): 2-letter state code
• city (optional): City name
• data_format (optional): "cleaned" (default) or "raw"

Returns: Current conditions with AQI and pollutant information.

REST API Tools

airnow.get_current_observations

Get current air quality observations.

Arguments:

• zip_code (optional): 5-digit ZIP code
• lat (optional): Latitude
• lon (optional): Longitude
• distance (optional): Distance in miles (default: 25)
• data_format (optional): "cleaned" (default) or "raw"

Note: Either zip_code or both lat and lon are required. Requires API key.

airnow.get_forecast

Get air quality forecast via REST API.

Arguments:

• zip_code (optional): 5-digit ZIP code
• lat (optional): Latitude
• lon (optional): Longitude
• distance (optional): Distance in miles (default: 25)
• data_format (optional): "cleaned" (default) or "raw"

Note: Either zip_code or both lat and lon are required. Requires API key.

airnow.get_historical_observations

Get historical air quality observations.

Arguments:

• zip_code (required): 5-digit ZIP code
• date (required): Date in YYYY-MM-DD format
• distance (optional): Distance in miles (default: 25)
• data_format (optional): "cleaned" (default) or "raw"

Note: Requires API key.