@cyanheads/epa-mcp-server 0.3.2 → 0.4.0

package/changelog/0.3.x/0.3.3.md

@@ -0,0 +1,34 @@
+---
+summary: "ECHO debug logs use endpoint labels instead of request URLs, with framework recovery and error privacy updates."
+breaking: false
+security: true
+---
+
+# 0.3.3 — 2026-10-07
+
+## Changed
+
+- **Domain recovery** uses the framework's declared-hint fill from 0.13.10; redundant forwards are removed and contract tests preserve hints on both MCP result surfaces.
+- **Framework input and errors** adopt 0.13.9's integer-to-string repair and field-path guidance, 0.13.10's error request IDs, 0.13.12's generated IDs and URL-origin redaction, and 0.13.13's removal of framework-added `rootCause` from error envelopes.
+- **Docker builds** use Bun 1.4.2 and a native build-platform dependency stage, cross-installing for amd64/arm64 with framework-range OTel peers and pruning musl-only bindings.
+- **Framework tooling and guides** are synchronized; configuration documents OTLP endpoints and opt-in failed-call payload logging, packaging excludes `.mcpb`, cache, and logs, and CodeQL uploads per-language categories.
+- **ECHO User-Agent** reports the current server version.
+
+## Fixed
+
+- **MCP Registry npm entries** launch with `npx`, drop npm-script arguments, and fix `MCP_TRANSPORT_TYPE=http` for the HTTP entry.
+
+## Security
+
+- **ECHO debug logs** identify facility and enforcement requests by fixed endpoint labels and query IDs, omitting full configured URL paths and query strings ([#26](https://github.com/cyanheads/epa-mcp-server/issues/26)).
+
+## Dependencies
+
+- `@cyanheads/mcp-ts-core` ^0.13.6 → ^0.13.13.
+- Dev: `@biomejs/biome` ^2.5.14 → ^2.5.15.
+- Dev: `@socketsecurity/bun-security-scanner` ^1.1.2 → ^1.1.3.
+- Dev: `@types/node` ^26.6.1 → ^26.6.4.
+- Dev: `ignore` ^7.0.9 → ^7.0.12.
+- Dev: `tsc-alias` ^1.9.5 → ^1.9.7.
+- Dev: `vitest` ^5.0.1 → ^5.0.3.
+- **Bun** 1.4.0 → 1.4.2 in `packageManager` and Docker base images.

package/changelog/0.4.x/0.4.0.md

@@ -0,0 +1,35 @@
+---
+summary: "epa_get_air_quality moves to AirNow's 2026 web services (breaking: distance_miles removed, observation coordinates removed, aqi optional); TRI search runs as one DMAP join with a working county filter and opt-in release breakdown; water-system has_violation counts open violations; hosted endpoint at epa.caseyjhand.com."
+breaking: true
+security: false
+agent-notes: |
+  Callers of epa_get_air_quality: drop `distance_miles`, stop reading `latitude`/`longitude`, treat `hourObserved` as a string and `aqi` as optional.
+---
+
+# 0.4.0 — 2026-10-08
+
+## Added
+
+- **`epa_get_air_quality`** reads `observation/current/ziplatlong/` and `forecast/current/`, returns per-site readings (`siteName`, `siteID`, `reportingAgency`), the agency `discussion`, and an `attribution` credits block ([#30](https://github.com/cyanheads/epa-mcp-server/issues/30)).
+- **`epa_search_tri_releases`** takes opt-in `include_release_breakdown` for air, water, land, and underground-injection releases at the cost of one more upstream request ([#17](https://github.com/cyanheads/epa-mcp-server/issues/17)).
+- **`epa_search_tri_releases`** records carry `countyName`; TRI quantities reported in grams (dioxin and dioxin-like compounds) are converted to pounds and carry `reportedUnit`.
+- **Hosted endpoint** `https://epa.caseyjhand.com/mcp` is listed in `server.json` remotes and the README.
+
+## Changed
+
+- **`epa_get_air_quality` (breaking)** removes the `distance_miles` input and the `latitude`/`longitude` output fields, retypes `hourObserved`, and makes `aqi` optional (category-only forecasts omit it). `forecast_date` is optional, filters the issued forecast, and is rejected in current mode.
+- **`epa_search_tri_releases`** is one DMAP join instead of an unbounded facility walk ([#32](https://github.com/cyanheads/epa-mcp-server/issues/32)); the `county` filter matches `county_name` after dropping a trailing County, Parish, or Borough ([#27](https://github.com/cyanheads/epa-mcp-server/issues/27)).
+- **`epa_search_water_systems`** `has_violation` keeps systems with an open violation, in chunked lookups with a scan notice, and works with `zip_code`; `zip_code` is documented as the address of record.
+- **`epa_get_facility`**, **`epa_search_facilities`**, **`epa_search_superfund`** render latitude and longitude independently ([#24](https://github.com/cyanheads/epa-mcp-server/issues/24)) and pound quantities at full precision.
+- **`facility_id`** guidance on `epa_get_tri_releases` points at `epa_search_tri_releases` ([#21](https://github.com/cyanheads/epa-mcp-server/issues/21)).
+- **Tests** assert exact tool sets, error messages, and per-field output across the suite.
+
+## Fixed
+
+- **DMAP row ranges** are 1-based and inclusive.
+- **`epa_search_tri_releases`** under-limit searches no longer fail during enrichment.
+
+## Dependencies
+
+- `@cyanheads/mcp-ts-core` ^0.13.13 → ^0.13.14 (framework skills synced).
+- `pino-pretty` ^13.1.3 → ^13.2.0.

package/dist/mcp-server/tools/definitions/get-air-quality.tool.d.ts

@@ -1,5 +1,6 @@
 /**
- * @fileoverview Tool for getting AQI observations or forecasts for a location from AirNow.
+ * @fileoverview Tool for getting current AQI observations or the issued AQI forecast for a
+ * location from AirNow.
  * @module mcp-server/tools/definitions/get-air-quality.tool
  */
 import { z } from '@cyanheads/mcp-ts-core';
@@ -13,34 +14,47 @@ export declare const getAirQualityTool: import("@cyanheads/mcp-ts-core").ToolDef
         forecast: "forecast";
     }>>;
     forecast_date: z.ZodOptional<z.ZodString>;
-    distance_miles: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
     observations: z.ZodArray<z.ZodObject<{
         reportingArea: z.ZodOptional<z.ZodString>;
+        reportingAreaCode: z.ZodOptional<z.ZodString>;
         stateCode: z.ZodOptional<z.ZodString>;
-        latitude: z.ZodOptional<z.ZodNumber>;
-        longitude: z.ZodOptional<z.ZodNumber>;
         dateObserved: z.ZodOptional<z.ZodString>;
-        hourObserved: z.ZodOptional<z.ZodNumber>;
+        hourObserved: z.ZodOptional<z.ZodString>;
         localTimeZone: z.ZodOptional<z.ZodString>;
+        discussion: z.ZodOptional<z.ZodString>;
         readings: z.ZodArray<z.ZodObject<{
             parameterName: z.ZodString;
-            aqi: z.ZodNumber;
+            aqi: z.ZodOptional<z.ZodNumber>;
             categoryNumber: z.ZodOptional<z.ZodNumber>;
             categoryName: z.ZodOptional<z.ZodString>;
+            siteName: z.ZodOptional<z.ZodString>;
+            siteID: z.ZodOptional<z.ZodString>;
+            reportingAgency: z.ZodOptional<z.ZodString>;
+            dateIssue: z.ZodOptional<z.ZodString>;
+            dateValid: z.ZodOptional<z.ZodString>;
+            forecastAgency: z.ZodOptional<z.ZodString>;
+            actionDay: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     mode: z.ZodString;
     message: z.ZodOptional<z.ZodString>;
+    attribution: z.ZodString;
 }, z.core.$strip>, readonly [{
     readonly reason: "no_location";
     readonly code: JsonRpcErrorCode.ValidationError;
     readonly when: "Neither zip_code nor latitude+longitude was provided.";
     readonly recovery: "Provide either zip_code or both latitude and longitude to identify the location.";
 }, {
-    readonly reason: "forecast_date_required";
+    readonly reason: "forecast_date_needs_forecast_mode";
     readonly code: JsonRpcErrorCode.ValidationError;
-    readonly when: "Mode is \"forecast\" but forecast_date was not provided.";
-    readonly recovery: "Provide forecast_date as YYYY-MM-DD when using mode=\"forecast\".";
+    readonly when: "forecast_date was set while mode is \"current\", where it has no effect.";
+    readonly recovery: "Set mode to \"forecast\" to filter by forecast_date, or omit forecast_date.";
+}, {
+    readonly reason: "invalid_zip_code";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "AirNow rejected zip_code as invalid (HTTP 400).";
+    readonly recovery: "Check that zip_code is a valid 5-digit US ZIP code, or pass latitude and longitude instead.";
+    readonly thrownBy: "service";
 }], undefined>;
 //# sourceMappingURL=get-air-quality.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-air-quality.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-air-quality.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-air-quality.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAIjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwO5B,CAAC"}
+{"version":3,"file":"get-air-quality.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-air-quality.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA+BjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0R5B,CAAC"}

package/dist/mcp-server/tools/definitions/get-air-quality.tool.js

@@ -1,16 +1,35 @@
 /**
- * @fileoverview Tool for getting AQI observations or forecasts for a location from AirNow.
+ * @fileoverview Tool for getting current AQI observations or the issued AQI forecast for a
+ * location from AirNow.
  * @module mcp-server/tools/definitions/get-air-quality.tool
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
 import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
 import { getAirNowService } from '../../../services/airnow/airnow-service.js';
+const AIRNOW_PROGRAM = 'the U.S. EPA AirNow program (www.airnow.gov)';
+const PRELIMINARY_NOTICE = 'AirNow data are preliminary and unverified; do not use them for regulatory, trend, or enforcement decisions.';
+/** Credit line naming the agencies behind the returned readings and the AirNow program. */
+function attributionFor(mode, areas) {
+    const agencies = [
+        ...new Set(areas.flatMap((area) => area.readings.flatMap((r) => {
+            const agency = r.reportingAgency ?? r.forecastAgency;
+            return agency ? [agency] : [];
+        }))),
+    ];
+    const list = (items) => new Intl.ListFormat('en', { type: 'conjunction' }).format(items);
+    const credit = mode === 'current'
+        ? `Data courtesy of ${list([...agencies, AIRNOW_PROGRAM])}.`
+        : agencies.length > 0
+            ? `Forecasts issued by ${list(agencies)} and distributed by ${AIRNOW_PROGRAM}.`
+            : `Forecasts distributed by ${AIRNOW_PROGRAM}.`;
+    return `${credit} ${PRELIMINARY_NOTICE}`;
+}
 export const getAirQualityTool = tool('epa_get_air_quality', {
     title: 'Get Air Quality Index',
-    description: 'Get current AQI observations or forecasts for a location from the AirNow API. Returns per-pollutant AQI values (PM2.5, ozone, CO, SO2, NO2), AQI category (Good through Hazardous), reporting area name, and observation timestamp. Provide either zip_code or both latitude and longitude. Set mode to "forecast" and provide forecast_date for next-day projections. Data is preliminary — suitable for awareness and informational use, not regulatory decisions. Responses are cached for ~1 hour.',
+    description: "Get current AQI observations or the issued AQI forecast for a US location from the AirNow API. Provide either zip_code or both latitude and longitude. Current mode returns the latest hourly NowCast AQI for each pollutant (PM2.5, ozone, PM10) from the closest monitor within 50 miles, with the monitor site name, site ID, and reporting agency; pollutants in one reporting area can come from different monitors. Forecast mode returns every day the reporting area's agency has issued (typically one to five), each with the AQI category, an action-day flag, and the issue date, plus the agency's forecast discussion when one exists; some agencies forecast a category without an AQI number. In forecast mode, set forecast_date to keep only the forecast valid on that date; current mode rejects it. Data are preliminary — suitable for awareness, not regulatory, trend, or enforcement decisions. Responses are cached for ~1 hour.",
     annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
     input: z.object({
-        zip_code: z.string().optional().describe('5-digit ZIP code for the location'),
+        zip_code: z.string().optional().describe('5-digit US ZIP code for the location'),
         latitude: z
             .number()
             .optional()
@@ -22,18 +41,11 @@ export const getAirQualityTool = tool('epa_get_air_quality', {
         mode: z
             .enum(['current', 'forecast'])
             .default('current')
-            .describe('Data mode: "current" for latest AQI observations, "forecast" for next-day projections'),
+            .describe('Data mode: "current" for the latest hourly observations, "forecast" for every forecast day the reporting area has issued'),
         forecast_date: z
             .string()
             .optional()
-            .describe('Date for forecast in ISO 8601 format (YYYY-MM-DD). Required when mode is "forecast".'),
-        distance_miles: z
-            .number()
-            .int()
-            .min(0)
-            .max(300)
-            .default(25)
-            .describe('Search radius in miles for finding reporting stations. Default 25 miles.'),
+            .describe('Forecast mode only (rejected in current mode): keep just the forecast valid on this date (YYYY-MM-DD). Omit to get every issued forecast day. When no issued day matches, the result is empty and its message lists the issued dates.'),
     }),
     output: z.object({
         observations: z
@@ -42,48 +54,91 @@ export const getAirQualityTool = tool('epa_get_air_quality', {
             reportingArea: z
                 .string()
                 .optional()
-                .describe('Name of the AQI reporting area (e.g. "Seattle-Tacoma-Bellevue, WA")'),
-            stateCode: z.string().optional().describe('2-letter state code of the reporting area'),
-            latitude: z.number().optional().describe('Latitude of the reporting area centroid'),
-            longitude: z.number().optional().describe('Longitude of the reporting area centroid'),
+                .describe('Name of the AQI reporting area (e.g. "Seattle-Bellevue-Kent Valley")'),
+            reportingAreaCode: z
+                .string()
+                .optional()
+                .describe('AirNow reporting area code (e.g. "wa004"). Forecast mode only.'),
+            stateCode: z
+                .string()
+                .optional()
+                .describe('2-letter state code of the reporting area. Forecast mode only.'),
             dateObserved: z
                 .string()
                 .optional()
-                .describe('Observation or forecast date (YYYY-MM-DD)'),
+                .describe('Observation date (YYYY-MM-DD). Current mode only.'),
             hourObserved: z
-                .number()
+                .string()
                 .optional()
-                .describe('Hour of observation (0–23) in local time. Absent for daily forecasts.'),
+                .describe('Local hour of the observation as "HH:00". Current mode only.'),
             localTimeZone: z
                 .string()
                 .optional()
-                .describe('Local time zone abbreviation (e.g. "PST")'),
+                .describe('Local time zone abbreviation for hourObserved (e.g. "PDT"). Current mode only.'),
+            discussion: z
+                .string()
+                .optional()
+                .describe("The forecasting agency's discussion for this area, verbatim (may contain HTML). Forecast mode only; omitted when the agency issued none."),
             readings: z
                 .array(z
                 .object({
                 parameterName: z
                     .string()
-                    .describe('Pollutant name (e.g. "PM2.5", "Ozone", "CO")'),
-                aqi: z.number().describe('Air Quality Index value for this pollutant'),
+                    .describe('Pollutant name as AirNow reports it (e.g. "PM2.5", "OZONE", "PM10")'),
+                aqi: z
+                    .number()
+                    .optional()
+                    .describe('Air Quality Index value. Omitted when the agency issued only a category (category-only forecast).'),
                 categoryNumber: z
                     .number()
                     .optional()
-                    .describe('AQI category number: 1=Good, 2=Moderate, 3=Unhealthy for Sensitive Groups, 4=Unhealthy, 5=Very Unhealthy, 6=Hazardous'),
+                    .describe('AQI category number: 1=Good, 2=Moderate, 3=Unhealthy for Sensitive Groups, 4=Unhealthy, 5=Very Unhealthy, 6=Hazardous. Omitted when AirNow reports an unrecognized category.'),
                 categoryName: z
                     .string()
                     .optional()
                     .describe('AQI category name (e.g. "Good", "Moderate", "Unhealthy")'),
+                siteName: z
+                    .string()
+                    .optional()
+                    .describe('Monitor site that produced this observation. Current mode only.'),
+                siteID: z
+                    .string()
+                    .optional()
+                    .describe('AirNow ID of the monitor site. Current mode only.'),
+                reportingAgency: z
+                    .string()
+                    .optional()
+                    .describe('Agency that reported this observation. Current mode only.'),
+                dateIssue: z
+                    .string()
+                    .optional()
+                    .describe('Date the forecast was issued (YYYY-MM-DD). Forecast mode only.'),
+                dateValid: z
+                    .string()
+                    .optional()
+                    .describe('Date the forecast applies to (YYYY-MM-DD). Forecast mode only.'),
+                forecastAgency: z
+                    .string()
+                    .optional()
+                    .describe('Agency that issued the forecast. Forecast mode only.'),
+                actionDay: z
+                    .boolean()
+                    .optional()
+                    .describe('True when the agency declared an air quality action day for this date. Forecast mode only.'),
             })
-                .describe('AQI reading for a single pollutant parameter'))
-                .describe('Per-pollutant AQI readings for this reporting area and time'),
+                .describe('AQI reading for one pollutant (and, in forecast mode, one valid date)'))
+                .describe('Per-pollutant AQI readings for this reporting area'),
         })
-            .describe('AQI observation or forecast record for a single reporting area'))
+            .describe('AQI readings for one reporting area — per observed hour in current mode, per area across all forecast days in forecast mode'))
             .describe('AQI observation or forecast records grouped by reporting area'),
         mode: z.string().describe('Data mode used: "current" or "forecast"'),
         message: z
             .string()
             .optional()
-            .describe('Recovery hint when no observations are returned — suggests trying a different location or increasing distance_miles. Absent when data is returned.'),
+            .describe("Why the result is empty: AirNow's own explanation, the issued forecast dates when forecast_date matched none, or a coverage hint. Absent when data is returned."),
+        attribution: z
+            .string()
+            .describe('Credit to the reporting or forecasting agencies and the U.S. EPA AirNow program, with the preliminary-data notice. Reproduce it when passing this data on.'),
     }),
     errors: [
         {
@@ -93,102 +148,115 @@ export const getAirQualityTool = tool('epa_get_air_quality', {
             recovery: 'Provide either zip_code or both latitude and longitude to identify the location.',
         },
         {
-            reason: 'forecast_date_required',
+            reason: 'forecast_date_needs_forecast_mode',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'forecast_date was set while mode is "current", where it has no effect.',
+            recovery: 'Set mode to "forecast" to filter by forecast_date, or omit forecast_date.',
+        },
+        {
+            reason: 'invalid_zip_code',
             code: JsonRpcErrorCode.ValidationError,
-            when: 'Mode is "forecast" but forecast_date was not provided.',
-            recovery: 'Provide forecast_date as YYYY-MM-DD when using mode="forecast".',
+            when: 'AirNow rejected zip_code as invalid (HTTP 400).',
+            recovery: 'Check that zip_code is a valid 5-digit US ZIP code, or pass latitude and longitude instead.',
+            thrownBy: 'service',
         },
     ],
     async handler(input, ctx) {
-        // Resolve the location once into a discriminated shape so the service branches below
-        // narrow without non-null assertions. Zip takes precedence over lat/lng, and the raw
-        // (untrimmed) zip_code is forwarded to match prior behavior.
-        const zip = input.zip_code;
-        const loc = zip !== undefined && zip.trim() !== ''
+        // Zip takes precedence over lat/lng; a blank zip (form clients) falls through to lat/lng.
+        const zip = input.zip_code?.trim();
+        const location = zip
             ? { kind: 'zip', zipCode: zip }
             : input.latitude !== undefined && input.longitude !== undefined
                 ? { kind: 'latlng', latitude: input.latitude, longitude: input.longitude }
                 : undefined;
-        if (!loc) {
-            throw ctx.fail('no_location', 'Provide either zip_code or both latitude and longitude.', {
-                ...ctx.recoveryFor('no_location'),
-            });
+        if (!location) {
+            throw ctx.fail('no_location', 'Provide either zip_code or both latitude and longitude.');
         }
-        // forecast mode requires a date — validate up front so the error path is unchanged.
-        let forecastDate = '';
-        if (input.mode === 'forecast') {
-            if (input.forecast_date === undefined || input.forecast_date.trim() === '') {
-                throw ctx.fail('forecast_date_required', 'forecast_date (YYYY-MM-DD) is required when mode is "forecast".', {
-                    ...ctx.recoveryFor('forecast_date_required'),
-                });
-            }
-            forecastDate = input.forecast_date;
+        const forecastDate = input.forecast_date?.trim() || undefined;
+        if (forecastDate && input.mode === 'current') {
+            throw ctx.fail('forecast_date_needs_forecast_mode', `forecast_date "${forecastDate}" only filters forecasts; current mode returns the latest observations.`);
         }
         ctx.log.info('epa_get_air_quality', {
             mode: input.mode,
-            zip: input.zip_code,
-            lat: input.latitude,
+            location: location.kind,
+            forecastDate,
         });
         const service = getAirNowService();
-        let observations;
-        if (input.mode === 'current') {
-            observations =
-                loc.kind === 'zip'
-                    ? await service.getCurrentByZip({ zipCode: loc.zipCode, distanceMiles: input.distance_miles }, ctx)
-                    : await service.getCurrentByLatLng({
-                        latitude: loc.latitude,
-                        longitude: loc.longitude,
-                        distanceMiles: input.distance_miles,
-                    }, ctx);
+        const lookup = input.mode === 'forecast'
+            ? await service.getForecast(location, ctx)
+            : await service.getCurrent(location, ctx);
+        const observations = input.mode === 'forecast' && forecastDate
+            ? lookup.areas.flatMap((area) => {
+                const readings = area.readings.filter((r) => r.dateValid === forecastDate);
+                return readings.length > 0 ? [{ ...area, readings }] : [];
+            })
+            : lookup.areas;
+        ctx.log.info('epa_get_air_quality completed', { areas: observations.length });
+        const attribution = attributionFor(input.mode, observations);
+        if (observations.length > 0)
+            return { observations, mode: input.mode, attribution };
+        const where = location.kind === 'zip'
+            ? `zip_code="${location.zipCode}"`
+            : `latitude=${location.latitude}, longitude=${location.longitude}`;
+        let message;
+        if (lookup.noDataMessage !== undefined) {
+            message = `AirNow returned no data for ${where}: "${lookup.noDataMessage}"`;
         }
-        else {
-            observations =
-                loc.kind === 'zip'
-                    ? await service.getForecastByZip({ zipCode: loc.zipCode, date: forecastDate, distanceMiles: input.distance_miles }, ctx)
-                    : await service.getForecastByLatLng({
-                        latitude: loc.latitude,
-                        longitude: loc.longitude,
-                        date: forecastDate,
-                        distanceMiles: input.distance_miles,
-                    }, ctx);
+        else if (lookup.areas.length > 0) {
+            const issued = [
+                ...new Set(lookup.areas.flatMap((a) => a.readings.flatMap((r) => r.dateValid ?? []))),
+            ].sort();
+            message = `No forecast valid on ${forecastDate} for ${where}. ${issued.length > 0 ? `Issued forecast dates: ${issued.join(', ')}.` : 'AirNow listed no valid dates.'} Omit forecast_date to get every issued day.`;
         }
-        ctx.log.info('epa_get_air_quality completed', { areas: observations.length });
-        if (observations.length === 0) {
-            const location = loc.kind === 'zip'
-                ? `zip_code="${input.zip_code}"`
-                : `lat=${input.latitude}, lng=${input.longitude}`;
-            return {
-                observations: [],
-                mode: input.mode,
-                message: `No AQI data found for ${location} within ${input.distance_miles} miles. Try increasing distance_miles or check that the location is within the US.`,
-            };
+        else {
+            message = `No AQI data found for ${where}. AirNow observations come from monitors within 50 miles and forecasts from the location's reporting area; check that the location is in the US, or try a nearby ZIP code.`;
         }
-        return { observations, mode: input.mode };
+        return { observations: [], mode: input.mode, message, attribution };
     },
     format: (result) => {
-        const lines = [];
-        lines.push(`## Air Quality Index — ${result.mode === 'forecast' ? 'Forecast' : 'Current Observations'} (mode: ${result.mode})`);
+        const lines = [
+            `## Air Quality Index — ${result.mode === 'forecast' ? 'Forecast' : 'Current Observations'} (mode: ${result.mode})`,
+        ];
         if (result.message)
             lines.push(`\n> ${result.message}`);
-        for (const obs of result.observations) {
-            lines.push(`\n### ${obs.reportingArea ?? 'Unknown Area'}`);
-            if (obs.stateCode)
-                lines.push(`**State:** ${obs.stateCode}`);
-            if (obs.dateObserved) {
-                const timeStr = obs.hourObserved !== undefined
-                    ? ` at ${obs.hourObserved}:00 ${obs.localTimeZone ?? ''}`
+        for (const area of result.observations) {
+            lines.push(`\n### ${area.reportingArea ?? 'Unknown Area'}`);
+            const meta = [
+                area.stateCode && `**State:** ${area.stateCode}`,
+                area.reportingAreaCode && `**Reporting area code:** ${area.reportingAreaCode}`,
+            ].filter(Boolean);
+            if (meta.length > 0)
+                lines.push(meta.join(' | '));
+            if (area.dateObserved || area.hourObserved) {
+                const time = area.hourObserved
+                    ? ` at ${area.hourObserved}${area.localTimeZone ? ` ${area.localTimeZone}` : ''}`
                     : '';
-                lines.push(`**Date:** ${obs.dateObserved}${timeStr}`);
+                lines.push(`**Observed:** ${area.dateObserved ?? 'date not reported'}${time}`);
             }
-            if (obs.latitude !== undefined && obs.longitude !== undefined) {
-                lines.push(`**Coordinates:** ${obs.latitude}, ${obs.longitude}`);
-            }
-            for (const reading of obs.readings) {
-                const category = reading.categoryName ? ` (${reading.categoryName})` : '';
-                const catNum = reading.categoryNumber !== undefined ? ` [category ${reading.categoryNumber}]` : '';
-                lines.push(`**${reading.parameterName}:** AQI ${reading.aqi}${category}${catNum}`);
+            for (const r of area.readings) {
+                const label = r.dateValid ? `${r.dateValid} ${r.parameterName}` : r.parameterName;
+                const value = r.aqi !== undefined
+                    ? `AQI ${r.aqi}${r.categoryName ? ` (${r.categoryName})` : ''}`
+                    : (r.categoryName ?? 'Category not reported');
+                const category = r.categoryNumber !== undefined ? ` [category ${r.categoryNumber}]` : '';
+                const categoryOnly = r.aqi === undefined ? ' (category only, no AQI number)' : '';
+                const site = r.siteName || r.siteID
+                    ? ` — ${[r.siteName, r.siteID && `site ${r.siteID}`].filter(Boolean).join(', ')}`
+                    : '';
+                const details = [
+                    r.reportingAgency,
+                    (r.dateIssue || r.forecastAgency) &&
+                        ['issued', r.dateIssue, r.forecastAgency && `by ${r.forecastAgency}`]
+                            .filter(Boolean)
+                            .join(' '),
+                    r.actionDay !== undefined && `action day: ${r.actionDay ? 'yes' : 'no'}`,
+                ].filter(Boolean);
+                lines.push(`- **${label}:** ${value}${category}${categoryOnly}${site}${details.length > 0 ? ` · ${details.join(' · ')}` : ''}`);
             }
+            if (area.discussion)
+                lines.push(`\n**Discussion:**\n${area.discussion}`);
         }
+        lines.push(`\n**Source:** ${result.attribution}`);
         return [{ type: 'text', text: lines.join('\n') }];
     },
 });

package/dist/mcp-server/tools/definitions/get-air-quality.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-air-quality.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-air-quality.tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get-air-quality.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-air-quality.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/get-ejscreen.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-ejscreen.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ejscreen.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAQjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgT1B,CAAC"}
+{"version":3,"file":"get-ejscreen.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ejscreen.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAQjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+S1B,CAAC"}

package/dist/mcp-server/tools/definitions/get-ejscreen.tool.js

@@ -179,7 +179,7 @@ export const getEjscreenTool = tool('epa_get_ejscreen', {
     async handler(input, ctx) {
         const bufferMiles = input.unit === 'kilometers' ? input.distance * MILES_PER_KM : input.distance;
         if (bufferMiles > MAX_BUFFER_MILES) {
-            throw ctx.fail('buffer_too_large', `Buffer of ${bufferMiles.toFixed(2)} miles exceeds the EJAM API limit of ${MAX_BUFFER_MILES} miles.`, { ...ctx.recoveryFor('buffer_too_large') });
+            throw ctx.fail('buffer_too_large', `Buffer of ${bufferMiles.toFixed(2)} miles exceeds the EJAM API limit of ${MAX_BUFFER_MILES} miles.`);
         }
         ctx.log.info('epa_get_ejscreen', {
             lat: input.latitude,