@cyanheads/epa-mcp-server 0.1.1

package/dist/mcp-server/resources/definitions/index.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Barrel export for all EPA MCP server resource definitions.
+ * @module mcp-server/resources/definitions/index
+ */
+export { facilityResource } from './facility.resource.js';
+export { superfundSiteResource } from './superfund-site.resource.js';
+import { facilityResource } from './facility.resource.js';
+import { superfundSiteResource } from './superfund-site.resource.js';
+export const allResourceDefinitions = [facilityResource, superfundSiteResource];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/resources/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,gBAAgB,EAAE,qBAAqB,CAAU,CAAC"}

package/dist/mcp-server/resources/definitions/superfund-site.resource.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Resource for fetching a Superfund site record by SEMS site ID.
+ * @module mcp-server/resources/definitions/superfund-site.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const superfundSiteResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    site_id: z.ZodString;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=superfund-site.resource.d.ts.map

package/dist/mcp-server/resources/definitions/superfund-site.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"superfund-site.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/superfund-site.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,qBAAqB;;wCAyBhC,CAAC"}

package/dist/mcp-server/resources/definitions/superfund-site.resource.js

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Resource for fetching a Superfund site record by SEMS site ID.
+ * @module mcp-server/resources/definitions/superfund-site.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getDmapService } from '../../../services/dmap/dmap-service.js';
+export const superfundSiteResource = resource('epa://superfund/{site_id}', {
+    name: 'epa-superfund-site',
+    description: 'Superfund site record from EPA SEMS by site ID. Returns NPL status, cleanup status, location, and coordinates.',
+    mimeType: 'application/json',
+    params: z.object({
+        site_id: z.string().describe('EPA SEMS Superfund site ID (obtained from epa_search_superfund)'),
+    }),
+    async handler(params, ctx) {
+        ctx.log.info('epa://superfund resource', { siteId: params.site_id });
+        // DMAP supports direct column equality filters — use site_id/equals/{id} directly
+        const sites = await getDmapService().searchSuperfundById(params.site_id, ctx);
+        const site = sites[0];
+        if (!site) {
+            throw notFound(`No Superfund site found with site ID "${params.site_id}". Use epa_search_superfund to discover valid site IDs.`, { siteId: params.site_id });
+        }
+        return site;
+    },
+});
+//# sourceMappingURL=superfund-site.resource.js.map

package/dist/mcp-server/resources/definitions/superfund-site.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"superfund-site.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/superfund-site.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAC,2BAA2B,EAAE;IACzE,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,gHAAgH;IAClH,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;KAChG,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAErE,kFAAkF;QAClF,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC9E,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,QAAQ,CACZ,yCAAyC,MAAM,CAAC,OAAO,yDAAyD,EAChH,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAC3B,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Tool for getting AQI observations or forecasts for a location from AirNow.
+ * @module mcp-server/tools/definitions/get-air-quality.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getAirQualityTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    zip_code: z.ZodOptional<z.ZodString>;
+    latitude: z.ZodOptional<z.ZodNumber>;
+    longitude: z.ZodOptional<z.ZodNumber>;
+    mode: z.ZodDefault<z.ZodEnum<{
+        current: "current";
+        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>;
+        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>;
+        localTimeZone: z.ZodOptional<z.ZodString>;
+        readings: z.ZodArray<z.ZodObject<{
+            parameterName: z.ZodString;
+            aqi: z.ZodNumber;
+            categoryNumber: z.ZodOptional<z.ZodNumber>;
+            categoryName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    mode: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_location";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    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 code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Mode is \"forecast\" but forecast_date was not provided.";
+    readonly recovery: "Provide forecast_date as YYYY-MM-DD when using mode=\"forecast\".";
+}]>;
+//# sourceMappingURL=get-air-quality.tool.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkO5B,CAAC"}

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

@@ -0,0 +1,193 @@
+/**
+ * @fileoverview Tool for getting AQI observations or forecasts 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';
+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.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        zip_code: z.string().optional().describe('5-digit ZIP code for the location'),
+        latitude: z
+            .number()
+            .optional()
+            .describe('Latitude in decimal degrees (use with longitude instead of zip_code)'),
+        longitude: z
+            .number()
+            .optional()
+            .describe('Longitude in decimal degrees (use with latitude instead of zip_code)'),
+        mode: z
+            .enum(['current', 'forecast'])
+            .default('current')
+            .describe('Data mode: "current" for latest AQI observations, "forecast" for next-day projections'),
+        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.'),
+    }),
+    output: z.object({
+        observations: z
+            .array(z
+            .object({
+            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'),
+            dateObserved: z
+                .string()
+                .optional()
+                .describe('Observation or forecast date (YYYY-MM-DD)'),
+            hourObserved: z
+                .number()
+                .optional()
+                .describe('Hour of observation (0–23) in local time. Absent for daily forecasts.'),
+            localTimeZone: z
+                .string()
+                .optional()
+                .describe('Local time zone abbreviation (e.g. "PST")'),
+            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'),
+                categoryNumber: z
+                    .number()
+                    .optional()
+                    .describe('AQI category number: 1=Good, 2=Moderate, 3=Unhealthy for Sensitive Groups, 4=Unhealthy, 5=Very Unhealthy, 6=Hazardous'),
+                categoryName: z
+                    .string()
+                    .optional()
+                    .describe('AQI category name (e.g. "Good", "Moderate", "Unhealthy")'),
+            })
+                .describe('AQI reading for a single pollutant parameter'))
+                .describe('Per-pollutant AQI readings for this reporting area and time'),
+        })
+            .describe('AQI observation or forecast record for a single reporting area'))
+            .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.'),
+    }),
+    errors: [
+        {
+            reason: 'no_location',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Neither zip_code nor latitude+longitude was provided.',
+            recovery: 'Provide either zip_code or both latitude and longitude to identify the location.',
+        },
+        {
+            reason: 'forecast_date_required',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Mode is "forecast" but forecast_date was not provided.',
+            recovery: 'Provide forecast_date as YYYY-MM-DD when using mode="forecast".',
+        },
+    ],
+    async handler(input, ctx) {
+        // Validate location
+        const hasZip = !!input.zip_code?.trim();
+        const hasLatLng = input.latitude !== undefined && input.longitude !== undefined;
+        if (!hasZip && !hasLatLng) {
+            throw ctx.fail('no_location', 'Provide either zip_code or both latitude and longitude.', {
+                ...ctx.recoveryFor('no_location'),
+            });
+        }
+        // Validate forecast date
+        if (input.mode === 'forecast' && !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'),
+            });
+        }
+        ctx.log.info('epa_get_air_quality', {
+            mode: input.mode,
+            zip: input.zip_code,
+            lat: input.latitude,
+        });
+        const service = getAirNowService();
+        let observations;
+        if (input.mode === 'current') {
+            if (hasZip) {
+                observations = await service.getCurrentByZip({ zipCode: input.zip_code, distanceMiles: input.distance_miles }, ctx);
+            }
+            else {
+                observations = await service.getCurrentByLatLng({
+                    latitude: input.latitude,
+                    longitude: input.longitude,
+                    distanceMiles: input.distance_miles,
+                }, ctx);
+            }
+        }
+        else {
+            if (hasZip) {
+                observations = await service.getForecastByZip({
+                    zipCode: input.zip_code,
+                    date: input.forecast_date,
+                    distanceMiles: input.distance_miles,
+                }, ctx);
+            }
+            else {
+                observations = await service.getForecastByLatLng({
+                    latitude: input.latitude,
+                    longitude: input.longitude,
+                    date: input.forecast_date,
+                    distanceMiles: input.distance_miles,
+                }, ctx);
+            }
+        }
+        ctx.log.info('epa_get_air_quality completed', { areas: observations.length });
+        if (observations.length === 0) {
+            const location = hasZip
+                ? `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.`,
+            };
+        }
+        return { observations, mode: input.mode };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## 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 ?? ''}`
+                    : '';
+                lines.push(`**Date:** ${obs.dateObserved}${timeStr}`);
+            }
+            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}`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-air-quality.tool.js.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Tool for retrieving a full compliance profile for a single EPA-regulated facility.
+ * @module mcp-server/tools/definitions/get-facility.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getFacilityTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    registry_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    registryId: z.ZodString;
+    name: z.ZodString;
+    street: z.ZodOptional<z.ZodString>;
+    city: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    zip: z.ZodOptional<z.ZodString>;
+    county: z.ZodOptional<z.ZodString>;
+    fipsCode: z.ZodOptional<z.ZodString>;
+    latitude: z.ZodOptional<z.ZodNumber>;
+    longitude: z.ZodOptional<z.ZodNumber>;
+    complianceStatus: z.ZodOptional<z.ZodString>;
+    programs: z.ZodObject<{
+        air: z.ZodBoolean;
+        water: z.ZodBoolean;
+        rcra: z.ZodBoolean;
+        tri: z.ZodBoolean;
+        sdwa: z.ZodBoolean;
+    }, z.core.$strip>;
+    triReleasesTransfersInLbs: z.ZodOptional<z.ZodNumber>;
+    compliance: z.ZodOptional<z.ZodObject<{
+        mediaStatusCode: z.ZodOptional<z.ZodString>;
+        mediaStatusDescription: z.ZodOptional<z.ZodString>;
+        quartersInViolation: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    inspections: z.ZodArray<z.ZodObject<{
+        activityType: z.ZodOptional<z.ZodString>;
+        activityDate: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    formalActions: z.ZodArray<z.ZodObject<{
+        caseId: z.ZodOptional<z.ZodString>;
+        settlementDate: z.ZodOptional<z.ZodString>;
+        penaltyAssessedInDollars: z.ZodOptional<z.ZodNumber>;
+        actionType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    airCompliance: z.ZodOptional<z.ZodObject<{
+        programId: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        statusDate: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    waterCompliance: z.ZodOptional<z.ZodObject<{
+        programId: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        permitId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "facility_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "ECHO returned no facility record for the given Registry ID.";
+    readonly recovery: "Verify the Registry ID using epa_search_facilities and retry with a valid ID.";
+}]>;
+//# sourceMappingURL=get-facility.tool.d.ts.map

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

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

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

@@ -0,0 +1,193 @@
+/**
+ * @fileoverview Tool for retrieving a full compliance profile for a single EPA-regulated facility.
+ * @module mcp-server/tools/definitions/get-facility.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getEchoService } from '../../../services/echo/echo-service.js';
+export const getFacilityTool = tool('epa_get_facility', {
+    title: 'Get EPA Facility Compliance Profile',
+    description: 'Retrieve a full compliance profile for a single EPA-regulated facility by EPA Registry ID. Returns facility metadata, per-program compliance status, inspection history, formal enforcement actions, penalty totals, and TRI release summary. Use epa_search_facilities to discover Registry IDs. For area-level enforcement discovery use epa_search_violations instead.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        registry_id: z
+            .string()
+            .min(1)
+            .describe('EPA FRS Registry ID for the facility (obtained from epa_search_facilities)'),
+    }),
+    output: z.object({
+        registryId: z.string().describe('EPA FRS Registry ID'),
+        name: z.string().describe('Facility name'),
+        street: z.string().optional().describe('Street address'),
+        city: z.string().optional().describe('City'),
+        state: z.string().optional().describe('2-letter state abbreviation'),
+        zip: z.string().optional().describe('ZIP code'),
+        county: z.string().optional().describe('County name'),
+        fipsCode: z.string().optional().describe('5-digit county FIPS code'),
+        latitude: z.number().optional().describe('Latitude in decimal degrees'),
+        longitude: z.number().optional().describe('Longitude in decimal degrees'),
+        complianceStatus: z.string().optional().describe('Overall compliance status text'),
+        programs: z
+            .object({
+            air: z.boolean().describe('Registered under Clean Air Act (CAA)'),
+            water: z.boolean().describe('Registered under Clean Water Act (CWA)'),
+            rcra: z.boolean().describe('Registered under RCRA (hazardous waste)'),
+            tri: z.boolean().describe('Participates in Toxic Release Inventory (TRI)'),
+            sdwa: z.boolean().describe('Regulated under Safe Drinking Water Act'),
+        })
+            .describe('Program registration flags'),
+        triReleasesTransfersInLbs: z
+            .number()
+            .optional()
+            .describe('Total TRI on/off-site releases and transfers in pounds'),
+        compliance: z
+            .object({
+            mediaStatusCode: z.string().optional().describe('Compliance media status code'),
+            mediaStatusDescription: z
+                .string()
+                .optional()
+                .describe('Human-readable compliance status description'),
+            quartersInViolation: z
+                .number()
+                .optional()
+                .describe('Number of quarters with compliance violations in the past 3 years'),
+        })
+            .optional()
+            .describe('Compliance summary from DFR. Absent when ECHO DFR compliance endpoint unavailable.'),
+        inspections: z
+            .array(z
+            .object({
+            activityType: z.string().optional().describe('Inspection activity type code'),
+            activityDate: z.string().optional().describe('Date of inspection'),
+            description: z.string().optional().describe('Activity type description'),
+        })
+            .describe('Single inspection record with activity type and date'))
+            .describe('Inspection history records'),
+        formalActions: z
+            .array(z
+            .object({
+            caseId: z.string().optional().describe('Enforcement case identifier'),
+            settlementDate: z.string().optional().describe('Settlement or resolution date'),
+            penaltyAssessedInDollars: z
+                .number()
+                .optional()
+                .describe('Penalty amount assessed in dollars'),
+            actionType: z.string().optional().describe('Type of formal enforcement action'),
+        })
+            .describe('Single formal enforcement action with case ID and penalty amount'))
+            .describe('Formal enforcement actions on record'),
+        airCompliance: z
+            .object({
+            programId: z.string().optional().describe('CAA program identifier'),
+            status: z.string().optional().describe('Air compliance status'),
+            statusDate: z.string().optional().describe('Date of status determination'),
+        })
+            .optional()
+            .describe('CAA-specific compliance details. Present only when facility is registered under CAA (programs.air=true).'),
+        waterCompliance: z
+            .object({
+            programId: z.string().optional().describe('CWA program identifier'),
+            status: z.string().optional().describe('Water compliance status'),
+            permitId: z.string().optional().describe('NPDES permit ID'),
+        })
+            .optional()
+            .describe('CWA/NPDES permit and compliance details. Present only when facility is registered under CWA (programs.water=true).'),
+    }),
+    errors: [
+        {
+            reason: 'facility_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'ECHO returned no facility record for the given Registry ID.',
+            recovery: 'Verify the Registry ID using epa_search_facilities and retry with a valid ID.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('epa_get_facility', { registryId: input.registry_id });
+        const profile = await getEchoService().getFacility(input.registry_id.trim(), ctx);
+        if (!profile.registryId) {
+            throw ctx.fail('facility_not_found', `No facility found for Registry ID "${input.registry_id}".`, {
+                ...ctx.recoveryFor('facility_not_found'),
+            });
+        }
+        ctx.log.info('epa_get_facility completed', {
+            registryId: profile.registryId,
+            inspections: profile.inspections.length,
+            formalActions: profile.formalActions.length,
+        });
+        return profile;
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## ${result.name}`);
+        lines.push(`**Registry ID:** ${result.registryId}`);
+        const location = [result.street, result.city, result.state, result.zip]
+            .filter(Boolean)
+            .join(', ');
+        if (location)
+            lines.push(`**Location:** ${location}`);
+        if (result.county)
+            lines.push(`**County:** ${result.county}${result.fipsCode ? ` (FIPS: ${result.fipsCode})` : ''}`);
+        if (result.latitude !== undefined && result.longitude !== undefined) {
+            lines.push(`**Coordinates:** ${result.latitude}, ${result.longitude}`);
+        }
+        if (result.complianceStatus)
+            lines.push(`**Compliance Status:** ${result.complianceStatus}`);
+        const activePrograms = Object.entries(result.programs)
+            .filter(([, v]) => v)
+            .map(([k]) => k.toUpperCase())
+            .join(', ');
+        if (activePrograms)
+            lines.push(`**Programs:** ${activePrograms}`);
+        if (result.triReleasesTransfersInLbs !== undefined) {
+            lines.push(`**TRI Releases+Transfers:** ${result.triReleasesTransfersInLbs.toLocaleString()} lbs`);
+        }
+        if (result.compliance) {
+            lines.push('\n### Compliance Summary');
+            if (result.compliance.mediaStatusCode)
+                lines.push(`**Status Code:** ${result.compliance.mediaStatusCode}`);
+            if (result.compliance.mediaStatusDescription)
+                lines.push(`**Description:** ${result.compliance.mediaStatusDescription}`);
+            if (result.compliance.quartersInViolation !== undefined) {
+                lines.push(`**Quarters in Violation (3yr):** ${result.compliance.quartersInViolation}`);
+            }
+        }
+        if (result.inspections.length > 0) {
+            lines.push('\n### Inspections');
+            for (const insp of result.inspections) {
+                const parts = [insp.activityDate, insp.activityType, insp.description]
+                    .filter(Boolean)
+                    .join(' — ');
+                lines.push(`- ${parts || 'Inspection record (no detail)'}`);
+            }
+        }
+        if (result.formalActions.length > 0) {
+            lines.push('\n### Formal Enforcement Actions');
+            for (const fa of result.formalActions) {
+                const penalty = fa.penaltyAssessedInDollars !== undefined
+                    ? ` | Penalty: $${fa.penaltyAssessedInDollars.toLocaleString()}`
+                    : '';
+                lines.push(`- ${fa.caseId ?? 'Case'}: ${fa.actionType ?? 'Action'}${penalty}${fa.settlementDate ? ` (${fa.settlementDate})` : ''}`);
+            }
+        }
+        if (result.airCompliance) {
+            lines.push('\n### Air (CAA) Compliance');
+            if (result.airCompliance.programId)
+                lines.push(`**Program ID:** ${result.airCompliance.programId}`);
+            if (result.airCompliance.status)
+                lines.push(`**Status:** ${result.airCompliance.status}`);
+            if (result.airCompliance.statusDate)
+                lines.push(`**Status Date:** ${result.airCompliance.statusDate}`);
+        }
+        if (result.waterCompliance) {
+            lines.push('\n### Water (CWA) Compliance');
+            if (result.waterCompliance.programId)
+                lines.push(`**Program ID:** ${result.waterCompliance.programId}`);
+            if (result.waterCompliance.status)
+                lines.push(`**Status:** ${result.waterCompliance.status}`);
+            if (result.waterCompliance.permitId)
+                lines.push(`**NPDES Permit:** ${result.waterCompliance.permitId}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-facility.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/get-tri-releases.tool.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Tool for querying TRI annual chemical release data for a specific facility.
+ * @module mcp-server/tools/definitions/get-tri-releases.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getTriReleasesTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    facility_id: z.ZodString;
+    year: z.ZodOptional<z.ZodNumber>;
+    chemical_name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    releases: z.ZodArray<z.ZodObject<{
+        facilityId: z.ZodString;
+        chemicalName: z.ZodString;
+        reportingYear: z.ZodNumber;
+        totalReleasesInLbs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    facilityId: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_releases_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No TRI records found for the given facility ID and filters.";
+    readonly recovery: "Verify the facility ID via epa_search_facilities. TRI data lags 18 months — try an earlier year.";
+}]>;
+//# sourceMappingURL=get-tri-releases.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-tri-releases.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-tri-releases.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;GA0G7B,CAAC"}