`aqs_annual_summary`

Pack: epa-aqs · Endpoint: https://gateway.pipeworx.io/epa-aqs/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/aqs_annual_summary for the schema, then POST the same URL with its arguments for the data.

EPA AQS annual summary statistics for a pollutant and area — arithmetic mean, maximum, 98th/99th percentile, exceedance counts, observation completeness and the certification status behind each. This is what attainment and trend statements are built on. Sourced from the EPA Air Quality System. Requires an EPA AQS email + key.

Parameters

Name	Type	Required	Description
`param`	string	yes	Pollutant parameter code(s), comma-separated, max 5, e.g. “44201”
`bdate`	string	yes	Start date YYYY-MM-DD
`edate`	string	yes	End date YYYY-MM-DD — same calendar year as bdate
`by`	string	no	Geography: “state” (default), “county”, “site”, “cbsa”, “box”
`state`	string	no	Two-digit state FIPS
`county`	string	no	Three-digit county FIPS
`site`	string	no	Four-digit site number
`cbsa`	string	no	Five-digit CBSA code
`bbox`	string	no	For by=box: “minLon,minLat,maxLon,maxLat”
`limit`	number	no	Max summary rows to return (default 200, max 2000)
`email`	string	no	The email the AQS key was issued to, if not folded into _apiKey
`_apiKey`	string	no	EPA AQS credential as ”:”, or just "" with email= set. Register at https://aqs.epa.gov/data/api/signup?email=

Example call

Arguments

{
  "param": "44201",
  "bdate": "2023-01-01",
  "edate": "2023-12-31",
  "by": "state",
  "state": "37"
}

curl

curl -X POST https://gateway.pipeworx.io/epa-aqs/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"aqs_annual_summary","arguments":{"param":"44201","bdate":"2023-01-01","edate":"2023-12-31","by":"state","state":"37"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('aqs_annual_summary', {
  "param": "44201",
  "bdate": "2023-01-01",
  "edate": "2023-12-31",
  "by": "state",
  "state": "37"
});

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "epa-aqs": {
      "url": "https://gateway.pipeworx.io/epa-aqs/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build September 18, 2026

Was this helpful?