Skip to main content
Glama

Aqs Monitors

aqs_monitors
Read-onlyIdempotent

EPA AQS monitor metadata for an area — which pollutants are measured where, by which agency, with what method and network membership (NCore, PAMS, SLAMS), the monitoring objective, and each monitor's open and close dates. Use it to find the site codes aqs_sample_data needs and to check whether a place is monitored at all. Sourced from the EPA Air Quality System. Requires an EPA AQS email + key.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
byNoGeography: "state" (default), "county", "site", "cbsa", "box"
bboxNoFor by=box: "minLon,minLat,maxLon,maxLat"
cbsaNoFive-digit CBSA code
siteNoFour-digit site number
bdateYesStart date YYYY-MM-DD
edateYesEnd date YYYY-MM-DD — same calendar year as bdate
emailNoThe email the AQS key was issued to, if not folded into _apiKey
limitNoMax monitor rows to return (default 200, max 2000)
paramYesPollutant parameter code(s), comma-separated, max 5, e.g. "44201"
stateNoTwo-digit state FIPS
countyNoThree-digit county FIPS
_apiKeyNoEPA AQS credential as "<email>:<key>", or just "<key>" with email= set. Register at https://aqs.epa.gov/data/api/signup?email=<your-email>

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, non-destructive, open-world behavior, so the safety profile is covered. The description adds material context the annotations don't: the data source (EPA AQS) and the hard auth requirement ('Requires an EPA AQS email + key'). It stops short of describing pagination or rate-limit behavior beyond what the schema's limit field implies.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, well front-loaded: purpose first, then the routing use case, then sourcing/auth. Dense but nearly every clause earns its place. Minor redundancy in listing returned fields that overlap with the purpose statement.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema exists, and the description compensates by enumerating the returned monitor fields. Combined with the auth requirement and source disclosure, an agent has everything needed to select and call this tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so every parameter is already documented with geography modes, FIPS formats, date constraints, and the credential format. The description adds no parameter-level detail beyond the schema, so baseline 3 is correct.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource ('EPA AQS monitor metadata for an area') and enumerates the returned dimensions: pollutants, agency, method, network membership (NCore/PAMS/SLAMS), objective, and open/close dates. It explicitly distinguishes itself from sibling aqs_sample_data by naming it, so the agent can route without opening either schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives two concrete use cases — 'find the site codes aqs_sample_data needs' and 'check whether a place is monitored at all' — and names the sibling tool that consumes its output. The selection condition versus the alternative is explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.