Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AQS_EMAIL | No | Your email address for EPA AQS API authentication | |
| AQS_API_KEY | No | Your EPA AQS API key (obtained via aqs_signup tool) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| aqs_signup | Register for an EPA Air Quality System (AQS) API key. Provide your email address and an API key will be sent to you. This key is required for all other AQS API operations. |
| aqs_is_available | Check if the EPA Air Quality System (AQS) API is operational. This is a health check endpoint that verifies the API is responding. Credentials are optional - uses environment variables (AQS_EMAIL, AQS_API_KEY) as fallback. |
| aqs_list_states | Get a list of all US states with their 2-digit FIPS codes. Use this to look up state codes for other AQS API queries. Example: California = "06", Texas = "48", New York = "36". |
| aqs_list_counties | Get a list of counties within a state with their 3-digit FIPS codes. Use this to look up county codes for county-level AQS API queries. Example: Los Angeles County, CA = "037", Harris County, TX = "201". |
| aqs_list_sites | Get a list of air quality monitoring sites within a county with their 4-digit site codes. Use this to look up site codes for site-level AQS API queries. Requires both state and county codes. |
| aqs_list_cbsas | Get a list of Core Based Statistical Areas (CBSAs) with their codes. CBSAs are metropolitan and micropolitan statistical areas defined by the US Census. Use CBSA codes for regional air quality queries. Example: Los Angeles-Long Beach-Anaheim = "31080", New York-Newark-Jersey City = "35620". |
| aqs_list_parameter_classes | Get a list of parameter classification groups (e.g., "CRITERIA", "AIR TOXICS", "METEOROLOGICAL"). Use the class name to query parameters within that class using aqs_list_parameters. Common classes: CRITERIA (criteria pollutants like ozone, PM2.5), AIR TOXICS (hazardous air pollutants), METEOROLOGICAL (weather data). |
| aqs_list_parameters | Get a list of parameters (pollutants/measurements) within a parameter class. Returns parameter codes and names. Use these codes in data queries. Common parameter codes: 44201 (Ozone), 88101 (PM2.5 Local), 81102 (PM10), 42401 (SO2), 42101 (CO), 42602 (NO2). Use aqs_list_parameter_classes first to get available class names. |
| aqs_monitors_by_site | Get air quality monitors at a specific monitoring site. Returns detailed information about monitors including location, operational dates, and measurement parameters. Parameters:
Note: Email and API key can be provided or will use AQS_EMAIL/AQS_API_KEY environment variables. |
| aqs_monitors_by_county | Get all air quality monitors in a county. Returns detailed information about monitors including location, operational dates, and measurement parameters. Parameters:
Note: Email and API key can be provided or will use AQS_EMAIL/AQS_API_KEY environment variables. |
| aqs_monitors_by_state | Get all air quality monitors in a state. Returns detailed information about monitors including location, operational dates, and measurement parameters. Parameters:
Note: Email and API key can be provided or will use AQS_EMAIL/AQS_API_KEY environment variables. |
| aqs_monitors_by_box | Get all air quality monitors within a latitude/longitude bounding box. Useful for querying monitors in a geographic region that may span multiple states or counties. Parameters:
Example bounding box for Los Angeles area: minlat=33.5, maxlat=34.5, minlon=-118.8, maxlon=-117.5 Note: Email and API key can be provided or will use AQS_EMAIL/AQS_API_KEY environment variables. |
| aqs_monitors_by_cbsa | Get all air quality monitors in a Core Based Statistical Area (CBSA). CBSAs are metropolitan or micropolitan statistical areas defined by the Office of Management and Budget. Parameters:
Note: Email and API key can be provided or will use AQS_EMAIL/AQS_API_KEY environment variables. |
| aqs_sample_data_by_site | Get raw sample data for a specific monitoring site. WARNING: Sample data can be very large. Strongly recommend limiting date ranges to one week or one month. Returns individual sample measurements including time, value, units, and quality flags. |
| aqs_sample_data_by_county | Get raw sample data for all monitoring sites in a county. WARNING: Sample data can be very large. Strongly recommend limiting date ranges to one week or one month. Returns individual sample measurements from all sites in the specified county. |
| aqs_sample_data_by_state | Get raw sample data for all monitoring sites in a state. WARNING: Sample data can be EXTREMELY large for state-level queries. Strongly recommend limiting date ranges to one week or less. Returns individual sample measurements from all sites in the specified state. |
| aqs_sample_data_by_box | Get raw sample data for all monitoring sites within a geographic bounding box. WARNING: Sample data can be very large depending on box size. Strongly recommend limiting date ranges to one week or one month. Returns individual sample measurements from all sites within the specified coordinates. |
| aqs_sample_data_by_cbsa | Get raw sample data for all monitoring sites in a Core Based Statistical Area (CBSA). WARNING: Sample data can be very large for metropolitan areas. Strongly recommend limiting date ranges to one week or one month. Returns individual sample measurements from all sites in the specified CBSA. |
| aqs_daily_summary_by_site | Get daily summary air quality data for a specific monitoring site. Daily summaries include arithmetic mean, maximum values, observation counts, and AQI values for each day. Requires state FIPS code (2-digit), county FIPS code (3-digit), and site number (4-digit). |
| aqs_daily_summary_by_county | Get daily summary air quality data for all monitoring sites in a county. Daily summaries include arithmetic mean, maximum values, observation counts, and AQI values for each day. Requires state FIPS code (2-digit) and county FIPS code (3-digit). |
| aqs_daily_summary_by_state | Get daily summary air quality data for all monitoring sites in a state. Daily summaries include arithmetic mean, maximum values, observation counts, and AQI values for each day. Requires state FIPS code (2-digit). Note: This can return large amounts of data. |
| aqs_daily_summary_by_box | Get daily summary air quality data for all monitoring sites within a geographic bounding box. Daily summaries include arithmetic mean, maximum values, observation counts, and AQI values for each day. Specify the bounding box using minimum and maximum latitude/longitude coordinates. |
| aqs_daily_summary_by_cbsa | Get daily summary air quality data for all monitoring sites in a Core Based Statistical Area (CBSA). CBSAs are metropolitan or micropolitan statistical areas defined by the US Office of Management and Budget. Daily summaries include arithmetic mean, maximum values, observation counts, and AQI values for each day. |
| aqs_quarterly_summary_by_site | Retrieve quarterly summary data for a specific air quality monitoring site. Quarterly summaries aggregate measurements by calendar quarter, providing observation counts, arithmetic means, and maximum values. Useful for analyzing seasonal patterns and trends at individual monitoring locations. |
| aqs_quarterly_summary_by_county | Retrieve quarterly summary data for all air quality monitoring sites in a county. Quarterly summaries aggregate measurements by calendar quarter, providing observation counts, arithmetic means, and maximum values. Useful for comparing air quality across multiple monitoring sites within a county. |
| aqs_quarterly_summary_by_state | Retrieve quarterly summary data for all air quality monitoring sites in a state. Quarterly summaries aggregate measurements by calendar quarter, providing observation counts, arithmetic means, and maximum values. Useful for statewide air quality analysis and comparing trends across different regions. |
| aqs_annual_summary_by_site | Get annual summary data for a specific EPA air quality monitoring site. Annual summaries include yearly statistics such as arithmetic mean, standard deviation, maximum values, percentiles (10th through 99th), observation counts, data completeness metrics, and exceedance counts for primary and secondary NAAQS standards. |
| aqs_annual_summary_by_county | Get annual summary data for all monitoring sites in a county. Annual summaries include yearly statistics such as arithmetic mean, standard deviation, maximum values, percentiles (10th through 99th), observation counts, data completeness metrics, and exceedance counts for primary and secondary NAAQS standards. |
| aqs_annual_summary_by_state | Get annual summary data for all monitoring sites in a state. Annual summaries include yearly statistics such as arithmetic mean, standard deviation, maximum values, percentiles (10th through 99th), observation counts, data completeness metrics, and exceedance counts for primary and secondary NAAQS standards. |
| aqs_annual_summary_by_box | Get annual summary data for all monitoring sites within a geographic bounding box defined by latitude/longitude coordinates. Annual summaries include yearly statistics such as arithmetic mean, standard deviation, maximum values, percentiles (10th through 99th), observation counts, data completeness metrics, and exceedance counts for primary and secondary NAAQS standards. |
| aqs_annual_summary_by_cbsa | Get annual summary data for all monitoring sites within a Core Based Statistical Area (CBSA), which represents metropolitan and micropolitan statistical areas. Annual summaries include yearly statistics such as arithmetic mean, standard deviation, maximum values, percentiles (10th through 99th), observation counts, data completeness metrics, and exceedance counts for primary and secondary NAAQS standards. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |