@cyanheads/epa-mcp-server 0.1.1

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

@@ -0,0 +1,92 @@
+/**
+ * @fileoverview Tool for querying TRI annual chemical release data for a specific facility.
+ * @module mcp-server/tools/definitions/get-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 getTriReleasesTool = tool('epa_get_tri_releases', {
+    title: 'Get TRI Chemical Releases for Facility',
+    description: 'Query Toxic Release Inventory annual chemical release data for a specific facility. Returns per-chemical release records with chemical name, total release quantity, and reporting year. TRI data lags ~18 months — the most recent available year is typically 2 years prior to the current calendar year. Obtain facility_id (TRI facility ID) from epa_search_facilities. Use epa_search_tri_releases to identify top emitters across a region.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        facility_id: z
+            .string()
+            .min(1)
+            .describe('TRI facility ID (from the RegistryID field returned by epa_search_facilities)'),
+        year: z
+            .number()
+            .int()
+            .min(1987)
+            .max(2030)
+            .optional()
+            .describe('Reporting year to retrieve. Defaults to all available years. TRI data is typically available through ~2 years prior to the current year.'),
+        chemical_name: z
+            .string()
+            .optional()
+            .describe('Optional filter to restrict results to a specific chemical (partial match, case-insensitive)'),
+    }),
+    output: z.object({
+        releases: z
+            .array(z
+            .object({
+            facilityId: z.string().describe('TRI facility identifier'),
+            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('Per-chemical TRI release record for this facility and year'))
+            .describe('Per-chemical annual TRI release records for the queried facility'),
+        facilityId: z.string().describe('TRI facility ID queried'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when no releases are found — suggests alternative years or checking the facility ID. Absent when releases are returned.'),
+    }),
+    errors: [
+        {
+            reason: 'no_releases_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No TRI records found for the given facility ID and filters.',
+            recovery: 'Verify the facility ID via epa_search_facilities. TRI data lags 18 months — try an earlier year.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('epa_get_tri_releases', { facilityId: input.facility_id, year: input.year });
+        const chemicalName = input.chemical_name?.trim();
+        const releases = await getDmapService().getTriReleases({
+            facilityId: input.facility_id.trim(),
+            ...(input.year !== undefined && { year: input.year }),
+            ...(chemicalName && { chemicalName }),
+        }, ctx);
+        ctx.log.info('epa_get_tri_releases completed', { count: releases.length });
+        if (releases.length === 0) {
+            const yearNote = input.year ? ` for year ${input.year}` : '';
+            const chemNote = input.chemical_name ? ` matching chemical "${input.chemical_name}"` : '';
+            return {
+                releases: [],
+                facilityId: input.facility_id,
+                message: `No TRI releases found for facility "${input.facility_id}"${yearNote}${chemNote}. TRI data lags ~18 months — try year ${new Date().getFullYear() - 2} or earlier. Verify the facility ID with epa_search_facilities.`,
+            };
+        }
+        return { releases, facilityId: input.facility_id };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## TRI Chemical Releases — Facility ${result.facilityId}`);
+        lines.push(`**Records:** ${result.releases.length}`);
+        if (result.message)
+            lines.push(`\n> ${result.message}`);
+        for (const r of result.releases) {
+            lines.push(`\n### ${r.chemicalName} (${r.reportingYear})`);
+            lines.push(`**Facility ID:** ${r.facilityId}`);
+            if (r.totalReleasesInLbs !== undefined)
+                lines.push(`**Release Quantity:** ${r.totalReleasesInLbs.toLocaleString()} lbs`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-tri-releases.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-tri-releases.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-tri-releases.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,sBAAsB,EAAE;IAC7D,KAAK,EAAE,wCAAwC;IAC/C,WAAW,EACT,obAAob;IACtb,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;IAE9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,+EAA+E,CAAC;QAC5F,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,IAAI,CAAC;aACT,GAAG,CAAC,IAAI,CAAC;aACT,QAAQ,EAAE;aACV,QAAQ,CACP,0IAA0I,CAC3I;QACH,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,8FAA8F,CAC/F;KACJ,CAAC;IAEF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC;aACR,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YAC1D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YACrE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAChE,kBAAkB,EAAE,CAAC;iBAClB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,+DAA+D,CAAC;SAC7E,CAAC;aACD,QAAQ,CAAC,4DAA4D,CAAC,CAC1E;aACA,QAAQ,CAAC,kEAAkE,CAAC;QAC/E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC1D,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,uIAAuI,CACxI;KACJ,CAAC;IAEF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,mBAAmB;YAC3B,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,6DAA6D;YACnE,QAAQ,EACN,kGAAkG;SACrG;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAE1F,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,cAAc,EAAE,CAAC,cAAc,CACpD;YACE,UAAU,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE;YACpC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YACrD,GAAG,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,CAAC;SACtC,EACD,GAAG,CACJ,CAAC;QAEF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAE3E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,uBAAuB,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1F,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,KAAK,CAAC,WAAW;gBAC7B,OAAO,EAAE,uCAAuC,KAAK,CAAC,WAAW,IAAI,QAAQ,GAAG,QAAQ,yCAAyC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,iEAAiE;aAC/N,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,uCAAuC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAExD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;YAC/C,IAAI,CAAC,CAAC,kBAAkB,KAAK,SAAS;gBACpC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,kBAAkB,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACrF,CAAC;QAED,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -0,0 +1,305 @@
+/**
+ * @fileoverview Barrel export for all EPA MCP server tool definitions.
+ * @module mcp-server/tools/definitions/index
+ */
+export { getAirQualityTool } from './get-air-quality.tool.js';
+export { getFacilityTool } from './get-facility.tool.js';
+export { getTriReleasesTool } from './get-tri-releases.tool.js';
+export { searchFacilitiesTool } from './search-facilities.tool.js';
+export { searchSuperfundTool } from './search-superfund.tool.js';
+export { searchTriReleasesTool } from './search-tri-releases.tool.js';
+export { searchViolationsTool } from './search-violations.tool.js';
+export { searchWaterSystemsTool } from './search-water-systems.tool.js';
+export declare const allToolDefinitions: readonly [import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    zip_code: import("zod").ZodOptional<import("zod").ZodString>;
+    state: import("zod").ZodOptional<import("zod").ZodString>;
+    city: import("zod").ZodOptional<import("zod").ZodString>;
+    active_only: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    programs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+        CAA: "CAA";
+        CWA: "CWA";
+        RCRA: "RCRA";
+        TRI: "TRI";
+        SDWA: "SDWA";
+    }>>>;
+    has_violation: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    facilities: import("zod").ZodArray<import("zod").ZodObject<{
+        registryId: import("zod").ZodString;
+        name: import("zod").ZodString;
+        street: import("zod").ZodOptional<import("zod").ZodString>;
+        city: import("zod").ZodOptional<import("zod").ZodString>;
+        state: import("zod").ZodOptional<import("zod").ZodString>;
+        zip: import("zod").ZodOptional<import("zod").ZodString>;
+        county: import("zod").ZodOptional<import("zod").ZodString>;
+        fipsCode: import("zod").ZodOptional<import("zod").ZodString>;
+        latitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+        longitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+        complianceStatus: import("zod").ZodOptional<import("zod").ZodString>;
+        programs: import("zod").ZodObject<{
+            air: import("zod").ZodBoolean;
+            water: import("zod").ZodBoolean;
+            rcra: import("zod").ZodBoolean;
+            tri: import("zod").ZodBoolean;
+            sdwa: import("zod").ZodBoolean;
+        }, import("zod/v4/core").$strip>;
+        triReleasesTransfersInLbs: import("zod").ZodOptional<import("zod").ZodNumber>;
+        inspectionCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        totalPenaltiesInDollars: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    totalCount: import("zod").ZodNumber;
+    message: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_geographic_filter";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
+    readonly when: "No geographic filter (zip_code, state, or city) was provided.";
+    readonly recovery: "Provide at least one of zip_code, state, or city to scope the search.";
+}, {
+    readonly reason: "no_match";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No facilities matched the search criteria.";
+    readonly recovery: "Broaden the search by removing filters or expanding the geographic area.";
+}]>, import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    registry_id: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    registryId: import("zod").ZodString;
+    name: import("zod").ZodString;
+    street: import("zod").ZodOptional<import("zod").ZodString>;
+    city: import("zod").ZodOptional<import("zod").ZodString>;
+    state: import("zod").ZodOptional<import("zod").ZodString>;
+    zip: import("zod").ZodOptional<import("zod").ZodString>;
+    county: import("zod").ZodOptional<import("zod").ZodString>;
+    fipsCode: import("zod").ZodOptional<import("zod").ZodString>;
+    latitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+    longitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+    complianceStatus: import("zod").ZodOptional<import("zod").ZodString>;
+    programs: import("zod").ZodObject<{
+        air: import("zod").ZodBoolean;
+        water: import("zod").ZodBoolean;
+        rcra: import("zod").ZodBoolean;
+        tri: import("zod").ZodBoolean;
+        sdwa: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>;
+    triReleasesTransfersInLbs: import("zod").ZodOptional<import("zod").ZodNumber>;
+    compliance: import("zod").ZodOptional<import("zod").ZodObject<{
+        mediaStatusCode: import("zod").ZodOptional<import("zod").ZodString>;
+        mediaStatusDescription: import("zod").ZodOptional<import("zod").ZodString>;
+        quartersInViolation: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    inspections: import("zod").ZodArray<import("zod").ZodObject<{
+        activityType: import("zod").ZodOptional<import("zod").ZodString>;
+        activityDate: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    formalActions: import("zod").ZodArray<import("zod").ZodObject<{
+        caseId: import("zod").ZodOptional<import("zod").ZodString>;
+        settlementDate: import("zod").ZodOptional<import("zod").ZodString>;
+        penaltyAssessedInDollars: import("zod").ZodOptional<import("zod").ZodNumber>;
+        actionType: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    airCompliance: import("zod").ZodOptional<import("zod").ZodObject<{
+        programId: import("zod").ZodOptional<import("zod").ZodString>;
+        status: import("zod").ZodOptional<import("zod").ZodString>;
+        statusDate: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    waterCompliance: import("zod").ZodOptional<import("zod").ZodObject<{
+        programId: import("zod").ZodOptional<import("zod").ZodString>;
+        status: import("zod").ZodOptional<import("zod").ZodString>;
+        permitId: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "facility_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").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.";
+}]>, import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    state: import("zod").ZodOptional<import("zod").ZodString>;
+    zip_code: import("zod").ZodOptional<import("zod").ZodString>;
+    program: import("zod").ZodOptional<import("zod").ZodEnum<{
+        CAA: "CAA";
+        CWA: "CWA";
+        RCRA: "RCRA";
+        SDWA: "SDWA";
+        CERCLA: "CERCLA";
+        FIFRA: "FIFRA";
+        TSCA: "TSCA";
+    }>>;
+    case_type: import("zod").ZodDefault<import("zod").ZodEnum<{
+        all: "all";
+        criminal: "criminal";
+        civil: "civil";
+    }>>;
+    date_filed_start: import("zod").ZodOptional<import("zod").ZodString>;
+    date_filed_end: import("zod").ZodOptional<import("zod").ZodString>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    cases: import("zod").ZodArray<import("zod").ZodObject<{
+        caseId: import("zod").ZodOptional<import("zod").ZodString>;
+        caseName: import("zod").ZodOptional<import("zod").ZodString>;
+        facilityName: import("zod").ZodOptional<import("zod").ZodString>;
+        registryId: import("zod").ZodOptional<import("zod").ZodString>;
+        programsViolated: import("zod").ZodOptional<import("zod").ZodString>;
+        caseType: import("zod").ZodOptional<import("zod").ZodString>;
+        penaltyAssessedInDollars: import("zod").ZodOptional<import("zod").ZodNumber>;
+        settlementDate: import("zod").ZodOptional<import("zod").ZodString>;
+        filedDate: import("zod").ZodOptional<import("zod").ZodString>;
+        state: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    totalCount: import("zod").ZodNumber;
+    message: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_geographic_filter";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").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.";
+}]>, import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    zip_code: import("zod").ZodOptional<import("zod").ZodString>;
+    latitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+    longitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+    mode: import("zod").ZodDefault<import("zod").ZodEnum<{
+        current: "current";
+        forecast: "forecast";
+    }>>;
+    forecast_date: import("zod").ZodOptional<import("zod").ZodString>;
+    distance_miles: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    observations: import("zod").ZodArray<import("zod").ZodObject<{
+        reportingArea: import("zod").ZodOptional<import("zod").ZodString>;
+        stateCode: import("zod").ZodOptional<import("zod").ZodString>;
+        latitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+        longitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+        dateObserved: import("zod").ZodOptional<import("zod").ZodString>;
+        hourObserved: import("zod").ZodOptional<import("zod").ZodNumber>;
+        localTimeZone: import("zod").ZodOptional<import("zod").ZodString>;
+        readings: import("zod").ZodArray<import("zod").ZodObject<{
+            parameterName: import("zod").ZodString;
+            aqi: import("zod").ZodNumber;
+            categoryNumber: import("zod").ZodOptional<import("zod").ZodNumber>;
+            categoryName: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+    mode: import("zod").ZodString;
+    message: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_location";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").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: import("@cyanheads/mcp-ts-core/errors").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\".";
+}]>, import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    facility_id: import("zod").ZodString;
+    year: import("zod").ZodOptional<import("zod").ZodNumber>;
+    chemical_name: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    releases: import("zod").ZodArray<import("zod").ZodObject<{
+        facilityId: import("zod").ZodString;
+        chemicalName: import("zod").ZodString;
+        reportingYear: import("zod").ZodNumber;
+        totalReleasesInLbs: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    facilityId: import("zod").ZodString;
+    message: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_releases_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").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.";
+}]>, import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    state: import("zod").ZodString;
+    county: import("zod").ZodOptional<import("zod").ZodString>;
+    year: import("zod").ZodOptional<import("zod").ZodNumber>;
+    chemical_name: import("zod").ZodOptional<import("zod").ZodString>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    releases: import("zod").ZodArray<import("zod").ZodObject<{
+        facilityId: import("zod").ZodString;
+        facilityName: import("zod").ZodOptional<import("zod").ZodString>;
+        chemicalName: import("zod").ZodString;
+        reportingYear: import("zod").ZodNumber;
+        totalReleasesInLbs: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    state: import("zod").ZodString;
+    message: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_releases_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").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.";
+}]>, import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    state: import("zod").ZodOptional<import("zod").ZodString>;
+    city: import("zod").ZodOptional<import("zod").ZodString>;
+    zip_code: import("zod").ZodOptional<import("zod").ZodString>;
+    latitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+    longitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+    radius_miles: import("zod").ZodOptional<import("zod").ZodNumber>;
+    npl_status: import("zod").ZodDefault<import("zod").ZodEnum<{
+        all: "all";
+        listed: "listed";
+        "not-listed": "not-listed";
+        proposed: "proposed";
+    }>>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    sites: import("zod").ZodArray<import("zod").ZodObject<{
+        siteId: import("zod").ZodString;
+        name: import("zod").ZodString;
+        street: import("zod").ZodOptional<import("zod").ZodString>;
+        city: import("zod").ZodOptional<import("zod").ZodString>;
+        state: import("zod").ZodOptional<import("zod").ZodString>;
+        zip: import("zod").ZodOptional<import("zod").ZodString>;
+        county: import("zod").ZodOptional<import("zod").ZodString>;
+        fipsCode: import("zod").ZodOptional<import("zod").ZodString>;
+        nplStatus: import("zod").ZodOptional<import("zod").ZodString>;
+        cleanupStatus: import("zod").ZodOptional<import("zod").ZodString>;
+        latitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+        longitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    totalCount: import("zod").ZodNumber;
+    message: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_location_filter";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").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: import("@cyanheads/mcp-ts-core/errors").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.";
+}]>, import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    state: import("zod").ZodOptional<import("zod").ZodString>;
+    zip_code: import("zod").ZodOptional<import("zod").ZodString>;
+    has_violation: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    pws_type: import("zod").ZodOptional<import("zod").ZodEnum<{
+        community: "community";
+        "non-transient": "non-transient";
+        transient: "transient";
+    }>>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    systems: import("zod").ZodArray<import("zod").ZodObject<{
+        pwsid: import("zod").ZodString;
+        name: import("zod").ZodString;
+        state: import("zod").ZodOptional<import("zod").ZodString>;
+        city: import("zod").ZodOptional<import("zod").ZodString>;
+        zip: import("zod").ZodOptional<import("zod").ZodString>;
+        type: import("zod").ZodOptional<import("zod").ZodString>;
+        populationServed: import("zod").ZodOptional<import("zod").ZodNumber>;
+        primarySourceCode: import("zod").ZodOptional<import("zod").ZodString>;
+        hasViolation: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        isActive: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strip>>;
+    totalCount: import("zod").ZodNumber;
+    message: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_geographic_filter";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
+    readonly when: "Neither state nor zip_code was provided.";
+    readonly recovery: "Provide at least one of state or zip_code to search drinking water systems.";
+}]>];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAWxE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASrB,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Barrel export for all EPA MCP server tool definitions.
+ * @module mcp-server/tools/definitions/index
+ */
+export { getAirQualityTool } from './get-air-quality.tool.js';
+export { getFacilityTool } from './get-facility.tool.js';
+export { getTriReleasesTool } from './get-tri-releases.tool.js';
+export { searchFacilitiesTool } from './search-facilities.tool.js';
+export { searchSuperfundTool } from './search-superfund.tool.js';
+export { searchTriReleasesTool } from './search-tri-releases.tool.js';
+export { searchViolationsTool } from './search-violations.tool.js';
+export { searchWaterSystemsTool } from './search-water-systems.tool.js';
+import { getAirQualityTool } from './get-air-quality.tool.js';
+import { getFacilityTool } from './get-facility.tool.js';
+import { getTriReleasesTool } from './get-tri-releases.tool.js';
+import { searchFacilitiesTool } from './search-facilities.tool.js';
+import { searchSuperfundTool } from './search-superfund.tool.js';
+import { searchTriReleasesTool } from './search-tri-releases.tool.js';
+import { searchViolationsTool } from './search-violations.tool.js';
+import { searchWaterSystemsTool } from './search-water-systems.tool.js';
+export const allToolDefinitions = [
+    searchFacilitiesTool,
+    getFacilityTool,
+    searchViolationsTool,
+    getAirQualityTool,
+    getTriReleasesTool,
+    searchTriReleasesTool,
+    searchSuperfundTool,
+    searchWaterSystemsTool,
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,oBAAoB;IACpB,eAAe;IACf,oBAAoB;IACpB,iBAAiB;IACjB,kBAAkB;IAClB,qBAAqB;IACrB,mBAAmB;IACnB,sBAAsB;CACd,CAAC"}

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

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Tool for searching EPA-regulated facilities by location, industry, or compliance status.
+ * @module mcp-server/tools/definitions/search-facilities.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const searchFacilitiesTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    zip_code: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    city: z.ZodOptional<z.ZodString>;
+    active_only: z.ZodOptional<z.ZodBoolean>;
+    programs: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        CAA: "CAA";
+        CWA: "CWA";
+        RCRA: "RCRA";
+        TRI: "TRI";
+        SDWA: "SDWA";
+    }>>>;
+    has_violation: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    facilities: z.ZodArray<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>;
+        inspectionCount: z.ZodOptional<z.ZodNumber>;
+        totalPenaltiesInDollars: z.ZodOptional<z.ZodNumber>;
+    }, 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: "No geographic filter (zip_code, state, or city) was provided.";
+    readonly recovery: "Provide at least one of zip_code, state, or city to scope the search.";
+}, {
+    readonly reason: "no_match";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No facilities matched the search criteria.";
+    readonly recovery: "Broaden the search by removing filters or expanding the geographic area.";
+}]>;
+//# sourceMappingURL=search-facilities.tool.d.ts.map

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

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