@cyanheads/epa-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/search-facilities.tool.js

@@ -0,0 +1,182 @@
+/**
+ * @fileoverview Tool for searching EPA-regulated facilities by location, industry, or compliance status.
+ * @module mcp-server/tools/definitions/search-facilities.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 searchFacilitiesTool = tool('epa_search_facilities', {
+    title: 'Search EPA Facilities',
+    description: 'Search EPA-regulated facilities by location, industry program, or compliance status across all environmental programs (CAA, CWA, RCRA, TRI, SDWA). Returns facility name, EPA Registry ID, coordinates, county FIPS code, per-program registration flags, inspection counts, penalty totals, and TRI release totals. Registry IDs returned here feed epa_get_facility and epa_get_tri_releases. At least one geographic filter (zip_code, state, or city+state) is required — unscoped searches time out.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        zip_code: z.string().optional().describe('5-digit ZIP code to search within'),
+        state: z.string().optional().describe('2-letter US state abbreviation (e.g. "WA", "CA")'),
+        city: z.string().optional().describe('City name. Pair with state for best results.'),
+        active_only: z.boolean().optional().describe('When true, return only active facilities'),
+        programs: z
+            .array(z.enum(['CAA', 'CWA', 'RCRA', 'TRI', 'SDWA']))
+            .optional()
+            .describe('Restrict results to facilities registered in these environmental programs. CAA=air, CWA=water, RCRA=waste, TRI=toxic releases, SDWA=drinking water.'),
+        has_violation: z
+            .boolean()
+            .optional()
+            .describe('When true, return only facilities with recent significant violations'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(50)
+            .describe('Maximum number of facilities to return (1–100)'),
+    }),
+    output: z.object({
+        facilities: z
+            .array(z
+            .object({
+            registryId: z
+                .string()
+                .describe('EPA FRS Registry ID — use as input to epa_get_facility and epa_get_tri_releases'),
+            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 — use with Census API for demographics'),
+            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 from ECHO'),
+            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 Resource Conservation and Recovery Act (RCRA)'),
+                tri: z.boolean().describe('Participates in Toxic Release Inventory (TRI)'),
+                sdwa: z.boolean().describe('Regulated under Safe Drinking Water Act (SDWA)'),
+            })
+                .describe('Program registration flags'),
+            triReleasesTransfersInLbs: z
+                .number()
+                .optional()
+                .describe('Total TRI on/off-site releases and transfers in pounds (summary). Use epa_get_tri_releases for per-chemical breakdown.'),
+            inspectionCount: z.number().optional().describe('Number of EPA inspections on record'),
+            totalPenaltiesInDollars: z
+                .number()
+                .optional()
+                .describe('Total assessed penalties in dollars across all programs'),
+        })
+            .describe('EPA facility record with Registry ID, location, program flags, and compliance summary'))
+            .describe('Matching EPA facilities'),
+        totalCount: z.number().describe('Total facilities matched before the limit was applied'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when no results are found — echoes applied filters and suggests how to broaden the search. Absent when results are returned.'),
+    }),
+    errors: [
+        {
+            reason: 'no_geographic_filter',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'No geographic filter (zip_code, state, or city) was provided.',
+            recovery: 'Provide at least one of zip_code, state, or city to scope the search.',
+        },
+        {
+            reason: 'no_match',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No facilities matched the search criteria.',
+            recovery: 'Broaden the search by removing filters or expanding the geographic area.',
+        },
+    ],
+    async handler(input, ctx) {
+        // Enforce geographic scoping requirement
+        if (!input.zip_code?.trim() && !input.state?.trim() && !input.city?.trim()) {
+            throw ctx.fail('no_geographic_filter', 'At least one geographic filter (zip_code, state, or city) is required.', {
+                ...ctx.recoveryFor('no_geographic_filter'),
+            });
+        }
+        ctx.log.info('epa_search_facilities', {
+            zip: input.zip_code,
+            state: input.state,
+            city: input.city,
+            programs: input.programs,
+        });
+        const zipCode = input.zip_code?.trim();
+        const state = input.state?.trim();
+        const city = input.city?.trim();
+        const { facilities, totalCount } = await getEchoService().searchFacilities({
+            ...(zipCode && { zipCode }),
+            ...(state && { state }),
+            ...(city && { city }),
+            ...(input.active_only && { activeOnly: input.active_only }),
+            ...(input.programs?.length && { programs: input.programs }),
+            ...(input.has_violation && { hasViolation: input.has_violation }),
+            limit: input.limit,
+        }, ctx);
+        ctx.log.info('epa_search_facilities completed', { count: facilities.length, totalCount });
+        if (facilities.length === 0) {
+            const parts = [];
+            if (input.zip_code)
+                parts.push(`zip_code="${input.zip_code}"`);
+            if (input.state)
+                parts.push(`state="${input.state}"`);
+            if (input.city)
+                parts.push(`city="${input.city}"`);
+            if (input.programs?.length)
+                parts.push(`programs=[${input.programs.join(', ')}]`);
+            if (input.has_violation)
+                parts.push('has_violation=true');
+            return {
+                facilities: [],
+                totalCount: 0,
+                message: `No facilities matched: ${parts.join(', ')}. Try broadening the geographic area or removing program/violation filters.`,
+            };
+        }
+        return { facilities, totalCount };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## EPA Facility Search Results`);
+        lines.push(`**Total Found:** ${result.totalCount} | **Returned:** ${result.facilities.length}`);
+        if (result.message)
+            lines.push(`\n> ${result.message}`);
+        for (const f of result.facilities) {
+            lines.push(`\n### ${f.name}`);
+            lines.push(`**Registry ID:** ${f.registryId}`);
+            const location = [f.street, f.city, f.state, f.zip].filter(Boolean).join(', ');
+            if (location)
+                lines.push(`**Location:** ${location}`);
+            if (f.county)
+                lines.push(`**County:** ${f.county}${f.fipsCode ? ` (FIPS: ${f.fipsCode})` : ''}`);
+            if (f.latitude !== undefined && f.longitude !== undefined) {
+                lines.push(`**Coordinates:** ${f.latitude}, ${f.longitude}`);
+            }
+            if (f.complianceStatus)
+                lines.push(`**Compliance Status:** ${f.complianceStatus}`);
+            const activePrograms = Object.entries(f.programs)
+                .filter(([, v]) => v)
+                .map(([k]) => k.toUpperCase())
+                .join(', ');
+            if (activePrograms)
+                lines.push(`**Programs:** ${activePrograms}`);
+            if (f.triReleasesTransfersInLbs !== undefined) {
+                lines.push(`**TRI Releases+Transfers:** ${f.triReleasesTransfersInLbs.toLocaleString()} lbs`);
+            }
+            if (f.inspectionCount !== undefined)
+                lines.push(`**Inspections:** ${f.inspectionCount}`);
+            if (f.totalPenaltiesInDollars !== undefined) {
+                lines.push(`**Total Penalties:** $${f.totalPenaltiesInDollars.toLocaleString()}`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-facilities.tool.js.map

package/dist/mcp-server/tools/definitions/search-facilities.tool.js.map

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

package/dist/mcp-server/tools/definitions/search-superfund.tool.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Tool for searching Superfund (CERCLA/SEMS) sites by location or NPL status.
+ * @module mcp-server/tools/definitions/search-superfund.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const searchSuperfundTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    state: z.ZodOptional<z.ZodString>;
+    city: z.ZodOptional<z.ZodString>;
+    zip_code: z.ZodOptional<z.ZodString>;
+    latitude: z.ZodOptional<z.ZodNumber>;
+    longitude: z.ZodOptional<z.ZodNumber>;
+    radius_miles: z.ZodOptional<z.ZodNumber>;
+    npl_status: z.ZodDefault<z.ZodEnum<{
+        all: "all";
+        listed: "listed";
+        "not-listed": "not-listed";
+        proposed: "proposed";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    sites: z.ZodArray<z.ZodObject<{
+        siteId: 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>;
+        nplStatus: z.ZodOptional<z.ZodString>;
+        cleanupStatus: z.ZodOptional<z.ZodString>;
+        latitude: z.ZodOptional<z.ZodNumber>;
+        longitude: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_location_filter";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "No location filter (state, city, zip_code, or latitude+longitude) was provided.";
+    readonly recovery: "Provide at least one location filter: state, city, zip_code, or latitude+longitude+radius_miles.";
+}, {
+    readonly reason: "radius_required";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Latitude and longitude were provided without radius_miles.";
+    readonly recovery: "Provide radius_miles together with latitude and longitude for a proximity search.";
+}]>;
+//# sourceMappingURL=search-superfund.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-superfund.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-superfund.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-superfund.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,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+K9B,CAAC"}

package/dist/mcp-server/tools/definitions/search-superfund.tool.js

@@ -0,0 +1,155 @@
+/**
+ * @fileoverview Tool for searching Superfund (CERCLA/SEMS) sites by location or NPL status.
+ * @module mcp-server/tools/definitions/search-superfund.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getDmapService } from '../../../services/dmap/dmap-service.js';
+export const searchSuperfundTool = tool('epa_search_superfund', {
+    title: 'Search Superfund Sites',
+    description: 'Search Superfund (CERCLA/SEMS) sites by location or NPL listing status. Returns site name, EPA site ID, NPL status (listed/not listed/proposed), cleanup status, coordinates, and county FIPS code. Accepts either state/city/ZIP or latitude+longitude+radius for proximity searches. Use for "are there Superfund sites near X" questions.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        state: z.string().optional().describe('2-letter US state abbreviation to filter sites'),
+        city: z.string().optional().describe('City name (partial match within state)'),
+        zip_code: z.string().optional().describe('5-digit ZIP code to filter sites'),
+        latitude: z
+            .number()
+            .optional()
+            .describe('Latitude for proximity search (use with longitude and radius_miles)'),
+        longitude: z
+            .number()
+            .optional()
+            .describe('Longitude for proximity search (use with latitude and radius_miles)'),
+        radius_miles: z
+            .number()
+            .min(0.1)
+            .max(500)
+            .optional()
+            .describe('Search radius in miles from the given coordinates. Required when using latitude+longitude.'),
+        npl_status: z
+            .enum(['listed', 'not-listed', 'proposed', 'all'])
+            .default('all')
+            .describe('Filter by NPL (National Priorities List) status: listed=final NPL, not-listed=not on NPL, proposed=proposed for listing, all=include all'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .default(50)
+            .describe('Maximum number of sites to return (1–200)'),
+    }),
+    output: z.object({
+        sites: z
+            .array(z
+            .object({
+            siteId: z.string().describe('EPA SEMS site identifier'),
+            name: z.string().describe('Superfund site 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'),
+            nplStatus: z
+                .string()
+                .optional()
+                .describe('NPL status code: NPL=listed, N=not listed, P=proposed'),
+            cleanupStatus: z.string().optional().describe('Current cleanup stage or status'),
+            latitude: z.number().optional().describe('Latitude in decimal degrees'),
+            longitude: z.number().optional().describe('Longitude in decimal degrees'),
+        })
+            .describe('Superfund site record with location, NPL status, and cleanup status'))
+            .describe('Matching Superfund sites'),
+        totalCount: z
+            .number()
+            .describe('Number of sites returned (may be less than available if limit applied)'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when no sites are found. Absent when sites are returned.'),
+    }),
+    errors: [
+        {
+            reason: 'no_location_filter',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'No location filter (state, city, zip_code, or latitude+longitude) was provided.',
+            recovery: 'Provide at least one location filter: state, city, zip_code, or latitude+longitude+radius_miles.',
+        },
+        {
+            reason: 'radius_required',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Latitude and longitude were provided without radius_miles.',
+            recovery: 'Provide radius_miles together with latitude and longitude for a proximity search.',
+        },
+    ],
+    async handler(input, ctx) {
+        const hasGeo = !!input.state?.trim() || !!input.city?.trim() || !!input.zip_code?.trim();
+        const hasLatLng = input.latitude !== undefined && input.longitude !== undefined;
+        if (!hasGeo && !hasLatLng) {
+            throw ctx.fail('no_location_filter', 'At least one location filter is required to search Superfund sites.', {
+                ...ctx.recoveryFor('no_location_filter'),
+            });
+        }
+        if (hasLatLng && !input.radius_miles) {
+            throw ctx.fail('radius_required', 'Provide radius_miles when using latitude+longitude for proximity search.', {
+                ...ctx.recoveryFor('radius_required'),
+            });
+        }
+        ctx.log.info('epa_search_superfund', {
+            state: input.state,
+            lat: input.latitude,
+            nplStatus: input.npl_status,
+        });
+        const state = input.state?.trim();
+        const city = input.city?.trim();
+        const zipCode = input.zip_code?.trim();
+        const sites = await getDmapService().searchSuperfund({
+            ...(state && { state }),
+            ...(city && { city }),
+            ...(zipCode && { zipCode }),
+            ...(input.latitude !== undefined && { latitude: input.latitude }),
+            ...(input.longitude !== undefined && { longitude: input.longitude }),
+            ...(input.radius_miles !== undefined && { radiusMiles: input.radius_miles }),
+            ...(input.npl_status !== 'all' && { nplStatus: input.npl_status }),
+            limit: input.limit,
+        }, ctx);
+        ctx.log.info('epa_search_superfund completed', { count: sites.length });
+        if (sites.length === 0) {
+            const location = hasLatLng
+                ? `lat=${input.latitude}, lng=${input.longitude}, radius=${input.radius_miles} miles`
+                : [input.state, input.city, input.zip_code].filter(Boolean).join(', ');
+            return {
+                sites: [],
+                totalCount: 0,
+                message: `No Superfund sites found near ${location} with npl_status="${input.npl_status}". Try expanding the area, removing NPL status filter, or using a different location.`,
+            };
+        }
+        return { sites, totalCount: sites.length };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## Superfund Sites`);
+        lines.push(`**Found:** ${result.totalCount}`);
+        if (result.message)
+            lines.push(`\n> ${result.message}`);
+        for (const s of result.sites) {
+            lines.push(`\n### ${s.name}`);
+            lines.push(`**Site ID:** ${s.siteId}`);
+            const location = [s.street, s.city, s.state, s.zip].filter(Boolean).join(', ');
+            if (location)
+                lines.push(`**Location:** ${location}`);
+            if (s.county)
+                lines.push(`**County:** ${s.county}${s.fipsCode ? ` (FIPS: ${s.fipsCode})` : ''}`);
+            if (s.latitude !== undefined && s.longitude !== undefined) {
+                lines.push(`**Coordinates:** ${s.latitude}, ${s.longitude}`);
+            }
+            if (s.nplStatus)
+                lines.push(`**NPL Status:** ${s.nplStatus}`);
+            if (s.cleanupStatus)
+                lines.push(`**Cleanup Status:** ${s.cleanupStatus}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-superfund.tool.js.map

package/dist/mcp-server/tools/definitions/search-superfund.tool.js.map

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

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

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Tool for searching TRI release data across facilities in a state or county.
+ * @module mcp-server/tools/definitions/search-tri-releases.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const searchTriReleasesTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    state: z.ZodString;
+    county: z.ZodOptional<z.ZodString>;
+    year: z.ZodOptional<z.ZodNumber>;
+    chemical_name: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    releases: z.ZodArray<z.ZodObject<{
+        facilityId: z.ZodString;
+        facilityName: z.ZodOptional<z.ZodString>;
+        chemicalName: z.ZodString;
+        reportingYear: z.ZodNumber;
+        totalReleasesInLbs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    state: 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 state and filters.";
+    readonly recovery: "Verify the state abbreviation is valid. TRI data lags 18 months — try removing the year filter or using an earlier year.";
+}]>;
+//# sourceMappingURL=search-tri-releases.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-tri-releases.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-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,qBAAqB;;;;;;;;;;;;;;;;;;;;;GA6HhC,CAAC"}

package/dist/mcp-server/tools/definitions/search-tri-releases.tool.js

@@ -0,0 +1,113 @@
+/**
+ * @fileoverview Tool for searching TRI release data across facilities in a state or county.
+ * @module mcp-server/tools/definitions/search-tri-releases.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getDmapService } from '../../../services/dmap/dmap-service.js';
+export const searchTriReleasesTool = tool('epa_search_tri_releases', {
+    title: 'Search TRI Releases by Region',
+    description: 'Search Toxic Release Inventory data across facilities in a state or county for a given reporting year. Returns facility name, TRI ID, chemical name, and release quantity. Use to identify top polluters in an area or build an environmental exposure profile. Use epa_get_tri_releases for detailed release records for a single facility. TRI data lags ~18 months from the current calendar year.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        state: z
+            .string()
+            .min(2)
+            .max(2)
+            .describe('2-letter US state abbreviation (required, e.g. "WA", "TX")'),
+        county: z
+            .string()
+            .optional()
+            .describe('County name to narrow results within the state (partial match)'),
+        year: z
+            .number()
+            .int()
+            .min(1987)
+            .max(2030)
+            .optional()
+            .describe('Reporting year. Defaults to all available years in the state. TRI data lags ~18 months.'),
+        chemical_name: z
+            .string()
+            .optional()
+            .describe('Optional filter to restrict results to a specific chemical (partial match, case-insensitive)'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .default(50)
+            .describe('Maximum number of release records to return (1–200)'),
+    }),
+    output: z.object({
+        releases: z
+            .array(z
+            .object({
+            facilityId: z.string().describe('TRI facility identifier'),
+            facilityName: z.string().optional().describe('Facility name'),
+            chemicalName: z.string().describe('Chemical name as reported to TRI'),
+            reportingYear: z.number().describe('Year of the TRI submission'),
+            totalReleasesInLbs: z
+                .number()
+                .optional()
+                .describe('One-time release quantity in pounds (from tri_reporting_form)'),
+        })
+            .describe('TRI release record for a facility-chemical-year combination'))
+            .describe('TRI release records for facilities in the queried state and filters'),
+        state: z.string().describe('State queried'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when no releases are found. Absent when releases are returned.'),
+    }),
+    errors: [
+        {
+            reason: 'no_releases_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No TRI records found for the given state and filters.',
+            recovery: 'Verify the state abbreviation is valid. TRI data lags 18 months — try removing the year filter or using an earlier year.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('epa_search_tri_releases', {
+            state: input.state,
+            year: input.year,
+            county: input.county,
+        });
+        const county = input.county?.trim();
+        const chemicalName = input.chemical_name?.trim();
+        const releases = await getDmapService().searchTriReleases({
+            state: input.state.trim().toUpperCase(),
+            ...(county && { county }),
+            ...(input.year !== undefined && { year: input.year }),
+            ...(chemicalName && { chemicalName }),
+            limit: input.limit,
+        }, ctx);
+        ctx.log.info('epa_search_tri_releases completed', { count: releases.length });
+        if (releases.length === 0) {
+            const yearNote = input.year ? ` for year ${input.year}` : '';
+            const countyNote = input.county ? ` in ${input.county} county` : '';
+            const chemNote = input.chemical_name ? ` for chemical "${input.chemical_name}"` : '';
+            return {
+                releases: [],
+                state: input.state,
+                message: `No TRI releases found in ${input.state}${countyNote}${yearNote}${chemNote}. TRI data lags ~18 months — try year ${new Date().getFullYear() - 2} or removing filters.`,
+            };
+        }
+        return { releases, state: input.state };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## TRI Releases — ${result.state}`);
+        lines.push(`**Records:** ${result.releases.length}`);
+        if (result.message)
+            lines.push(`\n> ${result.message}`);
+        for (const r of result.releases) {
+            const facilityLabel = r.facilityName ? `${r.facilityName} (${r.facilityId})` : r.facilityId;
+            lines.push(`\n### ${r.chemicalName} — ${facilityLabel} (${r.reportingYear})`);
+            if (r.totalReleasesInLbs !== undefined)
+                lines.push(`**Release Quantity:** ${r.totalReleasesInLbs.toLocaleString()} lbs`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-tri-releases.tool.js.map

package/dist/mcp-server/tools/definitions/search-tri-releases.tool.js.map

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

package/dist/mcp-server/tools/definitions/search-violations.tool.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Tool for searching EPA enforcement cases by location, program, or date range.
+ * @module mcp-server/tools/definitions/search-violations.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const searchViolationsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    state: z.ZodOptional<z.ZodString>;
+    zip_code: z.ZodOptional<z.ZodString>;
+    program: z.ZodOptional<z.ZodEnum<{
+        CAA: "CAA";
+        CWA: "CWA";
+        RCRA: "RCRA";
+        SDWA: "SDWA";
+        CERCLA: "CERCLA";
+        FIFRA: "FIFRA";
+        TSCA: "TSCA";
+    }>>;
+    case_type: z.ZodDefault<z.ZodEnum<{
+        all: "all";
+        criminal: "criminal";
+        civil: "civil";
+    }>>;
+    date_filed_start: z.ZodOptional<z.ZodString>;
+    date_filed_end: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    cases: z.ZodArray<z.ZodObject<{
+        caseId: z.ZodOptional<z.ZodString>;
+        caseName: z.ZodOptional<z.ZodString>;
+        facilityName: z.ZodOptional<z.ZodString>;
+        registryId: z.ZodOptional<z.ZodString>;
+        programsViolated: z.ZodOptional<z.ZodString>;
+        caseType: z.ZodOptional<z.ZodString>;
+        penaltyAssessedInDollars: z.ZodOptional<z.ZodNumber>;
+        settlementDate: z.ZodOptional<z.ZodString>;
+        filedDate: z.ZodOptional<z.ZodString>;
+        state: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_geographic_filter";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Neither state nor zip_code was provided.";
+    readonly recovery: "Provide at least one of state or zip_code to scope the enforcement case search.";
+}]>;
+//# sourceMappingURL=search-violations.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-violations.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-violations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-violations.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,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmK/B,CAAC"}