@cyanheads/epa-mcp-server 0.1.4 → 0.2.0

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

@@ -10,10 +10,17 @@ 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<{
+/**
+ * Tools backed only by keyless public APIs (ECHO, DMAP). Always registered —
+ * these require no API key.
+ */
+export declare const coreToolDefinitions: 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>;
+    latitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+    longitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+    radius_miles: import("zod").ZodOptional<import("zod").ZodNumber>;
     active_only: import("zod").ZodOptional<import("zod").ZodBoolean>;
     programs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
         CAA: "CAA";
@@ -52,15 +59,20 @@ export declare const allToolDefinitions: readonly [import("@cyanheads/mcp-ts-cor
     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 code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "No geographic filter (zip_code, state, city, or a latitude+longitude+radius_miles triple) was provided.";
+    readonly recovery: "Provide at least one of zip_code, state, or city, or a complete latitude + longitude + radius_miles triple, to scope the search.";
+}, {
+    readonly reason: "incomplete_proximity";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "A proximity search was started but latitude, longitude, and radius_miles were not all provided.";
+    readonly recovery: "Proximity search needs all three of latitude, longitude, and radius_miles. Provide the missing value, or use zip_code / state / city instead.";
 }, {
     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<{
+}], undefined>, 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;
@@ -113,7 +125,7 @@ export declare const allToolDefinitions: readonly [import("@cyanheads/mcp-ts-cor
     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<{
+}], undefined>, 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<{
@@ -150,48 +162,281 @@ export declare const allToolDefinitions: readonly [import("@cyanheads/mcp-ts-cor
     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 code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
     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<{
+}], undefined>, 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.";
+}], undefined>, 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.";
+}], {
+    readonly truncated: import("zod").ZodBoolean;
+    readonly shown: import("zod").ZodNumber;
+    readonly cap: import("zod").ZodNumber;
+}>, 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>;
-    mode: import("zod").ZodDefault<import("zod").ZodEnum<{
-        current: "current";
-        forecast: "forecast";
+    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";
     }>>;
-    forecast_date: import("zod").ZodOptional<import("zod").ZodString>;
-    distance_miles: import("zod").ZodDefault<import("zod").ZodNumber>;
+    limit: 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>;
+    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>;
-        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;
+    totalCount: import("zod").ZodNumber;
     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: "no_location_filter";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    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: "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<{
+    readonly reason: "radius_required";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "Latitude and longitude were provided without radius_miles.";
+    readonly recovery: "Provide radius_miles together with latitude and longitude for a proximity search.";
+}], undefined>, 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.ValidationError;
+    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.";
+}], undefined>];
+/**
+ * Full tool surface, adding epa_get_air_quality (requires AIRNOW_API_KEY).
+ * index.ts registers this set when the key is configured, falling back to
+ * coreToolDefinitions when it is absent.
+ */
+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>;
+    latitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+    longitude: import("zod").ZodOptional<import("zod").ZodNumber>;
+    radius_miles: import("zod").ZodOptional<import("zod").ZodNumber>;
+    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.ValidationError;
+    readonly when: "No geographic filter (zip_code, state, city, or a latitude+longitude+radius_miles triple) was provided.";
+    readonly recovery: "Provide at least one of zip_code, state, or city, or a complete latitude + longitude + radius_miles triple, to scope the search.";
+}, {
+    readonly reason: "incomplete_proximity";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "A proximity search was started but latitude, longitude, and radius_miles were not all provided.";
+    readonly recovery: "Proximity search needs all three of latitude, longitude, and radius_miles. Provide the missing value, or use zip_code / state / city instead.";
+}, {
+    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.";
+}], undefined>, 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.";
+}], undefined>, 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.ValidationError;
+    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.";
+}], undefined>, 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>;
@@ -209,7 +454,7 @@ export declare const allToolDefinitions: readonly [import("@cyanheads/mcp-ts-cor
     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<{
+}], undefined>, 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>;
@@ -230,7 +475,11 @@ export declare const allToolDefinitions: readonly [import("@cyanheads/mcp-ts-cor
     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<{
+}], {
+    readonly truncated: import("zod").ZodBoolean;
+    readonly shown: import("zod").ZodNumber;
+    readonly cap: import("zod").ZodNumber;
+}>, 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>;
@@ -263,15 +512,15 @@ export declare const allToolDefinitions: readonly [import("@cyanheads/mcp-ts-cor
     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 code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
     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 code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
     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<{
+}], undefined>, 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>;
@@ -298,8 +547,46 @@ export declare const allToolDefinitions: readonly [import("@cyanheads/mcp-ts-cor
     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 code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
     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.";
-}]>];
+}], undefined>, 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.ValidationError;
+    readonly when: "Neither zip_code nor latitude+longitude was provided.";
+    readonly recovery: "Provide either zip_code or both latitude and longitude to identify the location.";
+}, {
+    readonly reason: "forecast_date_required";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "Mode is \"forecast\" but forecast_date was not provided.";
+    readonly recovery: "Provide forecast_date as YYYY-MM-DD when using mode=\"forecast\".";
+}], undefined>];
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAQtB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAAuD,CAAC"}

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

@@ -18,14 +18,23 @@ 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 = [
+/**
+ * Tools backed only by keyless public APIs (ECHO, DMAP). Always registered —
+ * these require no API key.
+ */
+export const coreToolDefinitions = [
     searchFacilitiesTool,
     getFacilityTool,
     searchViolationsTool,
-    getAirQualityTool,
     getTriReleasesTool,
     searchTriReleasesTool,
     searchSuperfundTool,
     searchWaterSystemsTool,
 ];
+/**
+ * Full tool surface, adding epa_get_air_quality (requires AIRNOW_API_KEY).
+ * index.ts registers this set when the key is configured, falling back to
+ * coreToolDefinitions when it is absent.
+ */
+export const allToolDefinitions = [...coreToolDefinitions, getAirQualityTool];
 //# sourceMappingURL=index.js.map

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

@@ -1 +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"}
+{"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;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,oBAAoB;IACpB,eAAe;IACf,oBAAoB;IACpB,kBAAkB;IAClB,qBAAqB;IACrB,mBAAmB;IACnB,sBAAsB;CACd,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,mBAAmB,EAAE,iBAAiB,CAAU,CAAC"}

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

@@ -8,6 +8,9 @@ export declare const searchFacilitiesTool: import("@cyanheads/mcp-ts-core").Tool
     zip_code: z.ZodOptional<z.ZodString>;
     state: z.ZodOptional<z.ZodString>;
     city: z.ZodOptional<z.ZodString>;
+    latitude: z.ZodOptional<z.ZodNumber>;
+    longitude: z.ZodOptional<z.ZodNumber>;
+    radius_miles: z.ZodOptional<z.ZodNumber>;
     active_only: z.ZodOptional<z.ZodBoolean>;
     programs: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         CAA: "CAA";
@@ -46,13 +49,18 @@ export declare const searchFacilitiesTool: import("@cyanheads/mcp-ts-core").Tool
     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 code: JsonRpcErrorCode.ValidationError;
+    readonly when: "No geographic filter (zip_code, state, city, or a latitude+longitude+radius_miles triple) was provided.";
+    readonly recovery: "Provide at least one of zip_code, state, or city, or a complete latitude + longitude + radius_miles triple, to scope the search.";
+}, {
+    readonly reason: "incomplete_proximity";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "A proximity search was started but latitude, longitude, and radius_miles were not all provided.";
+    readonly recovery: "Proximity search needs all three of latitude, longitude, and radius_miles. Provide the missing value, or use zip_code / state / city instead.";
 }, {
     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.";
-}]>;
+}], undefined>;
 //# sourceMappingURL=search-facilities.tool.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2P/B,CAAC"}