@cyanheads/epa-mcp-server 0.1.1

package/dist/services/echo/echo-service.js

@@ -0,0 +1,295 @@
+/**
+ * @fileoverview ECHO API service for EPA facility compliance and enforcement data.
+ * Wraps echodata.epa.gov/echo REST endpoints for facility search, facility detail,
+ * and enforcement case search.
+ * @module services/echo/echo-service
+ */
+import { serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { httpErrorFromResponse, withRetry } from '@cyanheads/mcp-ts-core/utils';
+import { getServerConfig } from '../../config/server-config.js';
+/** Normalizes a raw ECHO facility to the domain type. */
+function normalizeFacility(raw) {
+    const penaltyAir = parseFloat(raw.AIRPenalties ?? '0') || 0;
+    const penaltyCwa = parseFloat(raw.CWAPenalties ?? '0') || 0;
+    const penaltyRcr = parseFloat(raw.RCRPenalties ?? '0') || 0;
+    const totalPenalties = penaltyAir + penaltyCwa + penaltyRcr;
+    return {
+        registryId: raw.RegistryID ?? '',
+        name: raw.FacName ?? '',
+        ...(raw.FacStreet && { street: raw.FacStreet }),
+        ...(raw.FacCity && { city: raw.FacCity }),
+        ...(raw.FacState && { state: raw.FacState }),
+        ...(raw.FacZip && { zip: raw.FacZip }),
+        ...(raw.FacCounty && { county: raw.FacCounty }),
+        ...(raw.FacFIPSCode && { fipsCode: raw.FacFIPSCode }),
+        ...(raw.FacLat &&
+            !Number.isNaN(parseFloat(raw.FacLat)) && { latitude: parseFloat(raw.FacLat) }),
+        ...(raw.FacLon &&
+            !Number.isNaN(parseFloat(raw.FacLon)) && { longitude: parseFloat(raw.FacLon) }),
+        ...(raw.FacComplianceStatus && { complianceStatus: raw.FacComplianceStatus }),
+        programs: {
+            air: raw.AIRFlag === 'Y',
+            water: raw.CWAFlag === 'Y',
+            rcra: raw.RCRFlag === 'Y',
+            tri: raw.TRIFlag === 'Y',
+            sdwa: raw.SDWAFlag === 'Y',
+        },
+        ...(raw.TRIReleasesTransfers &&
+            !Number.isNaN(parseFloat(raw.TRIReleasesTransfers)) && {
+            triReleasesTransfersInLbs: parseFloat(raw.TRIReleasesTransfers),
+        }),
+        ...(raw.InspectionCount &&
+            !Number.isNaN(parseInt(raw.InspectionCount, 10)) && {
+            inspectionCount: parseInt(raw.InspectionCount, 10),
+        }),
+        ...(totalPenalties > 0 && { totalPenaltiesInDollars: totalPenalties }),
+    };
+}
+export class EchoService {
+    baseUrl;
+    // config and storage retained for future caching/state use
+    constructor(_config, _storage) {
+        this.baseUrl = getServerConfig().echoBaseUrl;
+    }
+    /** Build URL with query params. */
+    buildUrl(path, params) {
+        const url = new URL(`${this.baseUrl}/${path}`);
+        for (const [key, val] of Object.entries(params)) {
+            if (val !== undefined && val !== '') {
+                url.searchParams.set(key, String(val));
+            }
+        }
+        return url.toString();
+    }
+    /** Fetch JSON from ECHO with retry. */
+    // biome-ignore lint/suspicious/useAwait: delegates to withRetry() which returns a Promise — async typing is correct
+    async fetchJson(url, ctx) {
+        return withRetry(async () => {
+            const response = await fetch(url, {
+                signal: ctx.signal,
+                headers: { 'User-Agent': '@cyanheads/epa-mcp-server/0.1.1' },
+            });
+            if (!response.ok) {
+                throw await httpErrorFromResponse(response, { service: 'ECHO', data: { url } });
+            }
+            const text = await response.text();
+            if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                throw serviceUnavailable('ECHO API returned HTML instead of JSON — likely rate-limited or unavailable.', { url });
+            }
+            const parsed = JSON.parse(text);
+            // ECHO returns bot-blocking errors in Results.Error.ErrorMessage rather than HTTP error codes
+            const errorMsg = parsed.Results
+                ?.Error?.ErrorMessage;
+            if (errorMsg) {
+                throw serviceUnavailable(`ECHO API error: ${errorMsg}`, { url });
+            }
+            return parsed;
+        }, {
+            operation: 'EchoService.fetchJson',
+            baseDelayMs: 1000,
+            signal: ctx.signal,
+        });
+    }
+    /**
+     * Search EPA-regulated facilities using ECHO get_facility_info.
+     * At least one geographic parameter must be supplied.
+     */
+    async searchFacilities(params, ctx) {
+        const qparams = {
+            output: 'JSON',
+            p_limit: params.limit ?? 50,
+        };
+        if (params.zipCode)
+            qparams.p_zip = params.zipCode;
+        if (params.state)
+            qparams.p_state = params.state;
+        if (params.city)
+            qparams.p_city = params.city;
+        if (params.activeOnly)
+            qparams.p_act = 'Y';
+        if (params.hasViolation)
+            qparams.p_sv_flag = 'Y';
+        // Program filters — comma-separated list restricts to facilities in those programs
+        if (params.programs?.length) {
+            const programMap = {
+                CAA: 'AIR',
+                CWA: 'CWA',
+                RCRA: 'RCRA',
+                TRI: 'TRI',
+                SDWA: 'SDWA',
+            };
+            const mapped = params.programs.map((p) => programMap[p]).filter(Boolean);
+            if (mapped.length)
+                qparams.p_naa = mapped.join(',');
+        }
+        const url = this.buildUrl('echo_rest_services.get_facility_info', qparams);
+        ctx.log.debug('ECHO facility search', { url });
+        const data = await this.fetchJson(url, ctx);
+        const raw = data.Results?.Facilities ?? [];
+        const totalCount = parseInt(data.Results?.TotalCount ?? '0', 10) || raw.length;
+        return {
+            facilities: raw.map((f) => normalizeFacility(f)),
+            totalCount,
+        };
+    }
+    /**
+     * Retrieve a full compliance profile for a single facility, aggregating multiple DFR endpoints.
+     * Steps 2-5 run in parallel after the initial facility info fetch.
+     */
+    async getFacility(registryId, ctx) {
+        // Step 1: Get base facility info + program flags
+        const facilityUrl = this.buildUrl('echo_rest_services.get_facility_info', {
+            output: 'JSON',
+            p_id: registryId,
+            p_limit: 1,
+        });
+        ctx.log.debug('ECHO get_facility_info', { registryId });
+        const facilityData = await this.fetchJson(facilityUrl, ctx);
+        const rawFacilities = facilityData.Results?.Facilities ?? [];
+        const raw = rawFacilities[0];
+        if (!raw?.RegistryID) {
+            throw serviceUnavailable(`ECHO returned no facility for Registry ID "${registryId}". Check the ID and try again.`, { registryId });
+        }
+        const base = normalizeFacility(raw);
+        // Steps 2-5: Parallel DFR calls
+        const [complianceResult, inspEnfResult, airResult, waterResult] = await Promise.allSettled([
+            this.fetchJson(this.buildUrl('dfr_rest_services.get_compliance_summary', {
+                output: 'JSON',
+                p_id: registryId,
+            }), ctx),
+            this.fetchJson(this.buildUrl('dfr_rest_services.get_inspection_enforcement', {
+                output: 'JSON',
+                p_id: registryId,
+            }), ctx),
+            base.programs.air
+                ? this.fetchJson(this.buildUrl('dfr_rest_services.get_air', { output: 'JSON', p_id: registryId }), ctx)
+                : Promise.resolve(null),
+            base.programs.water
+                ? this.fetchJson(this.buildUrl('dfr_rest_services.get_water', { output: 'JSON', p_id: registryId }), ctx)
+                : Promise.resolve(null),
+        ]);
+        // Extract compliance summary
+        let compliance;
+        if (complianceResult.status === 'fulfilled') {
+            const cs = complianceResult.value?.Results?.ComplianceSummary;
+            if (cs) {
+                compliance = {
+                    ...(cs.MediaStatusCode && { mediaStatusCode: cs.MediaStatusCode }),
+                    ...(cs.MediaStatusDesc && { mediaStatusDescription: cs.MediaStatusDesc }),
+                    ...(cs.QtrsInViol !== undefined && { quartersInViolation: Number(cs.QtrsInViol) }),
+                };
+            }
+        }
+        // Extract inspections and formal actions
+        const inspections = [];
+        const formalActions = [];
+        if (inspEnfResult.status === 'fulfilled') {
+            const ie = inspEnfResult.value?.Results;
+            for (const insp of ie?.Inspections ?? []) {
+                inspections.push({
+                    ...(insp.ActivityType && { activityType: insp.ActivityType }),
+                    ...(insp.ActivityDate && { activityDate: insp.ActivityDate }),
+                    ...(insp.ActivityTypeDescription && { description: insp.ActivityTypeDescription }),
+                });
+            }
+            for (const fa of ie?.FormalActions ?? []) {
+                formalActions.push({
+                    ...(fa.CaseID && { caseId: fa.CaseID }),
+                    ...(fa.SettlementDate && { settlementDate: fa.SettlementDate }),
+                    ...(fa.PenaltyAssessed !== undefined && {
+                        penaltyAssessedInDollars: Number(fa.PenaltyAssessed),
+                    }),
+                    ...(fa.FormalActionType && { actionType: fa.FormalActionType }),
+                });
+            }
+        }
+        // Extract air compliance
+        let airCompliance;
+        if (airResult.status === 'fulfilled' && airResult.value) {
+            const ac = airResult.value?.Results?.AirComplianceSummary;
+            if (ac) {
+                airCompliance = {
+                    ...(ac.ProgramID && { programId: ac.ProgramID }),
+                    ...(ac.Status && { status: ac.Status }),
+                    ...(ac.StatusDate && { statusDate: ac.StatusDate }),
+                };
+            }
+        }
+        // Extract water compliance
+        let waterCompliance;
+        if (waterResult.status === 'fulfilled' && waterResult.value) {
+            const wc = waterResult.value?.Results?.WaterCompliance;
+            if (wc) {
+                waterCompliance = {
+                    ...(wc.ProgramID && { programId: wc.ProgramID }),
+                    ...(wc.Status && { status: wc.Status }),
+                    ...(wc.PermitID && { permitId: wc.PermitID }),
+                };
+            }
+        }
+        return {
+            ...base,
+            ...(compliance && { compliance }),
+            inspections,
+            formalActions,
+            ...(airCompliance && { airCompliance }),
+            ...(waterCompliance && { waterCompliance }),
+        };
+    }
+    /**
+     * Search EPA enforcement cases using ECHO case_rest_services.
+     */
+    async searchViolations(params, ctx) {
+        const qparams = {
+            output: 'JSON',
+            p_limit: params.limit ?? 50,
+        };
+        if (params.state)
+            qparams.p_state = params.state;
+        if (params.zipCode)
+            qparams.p_zip = params.zipCode;
+        if (params.program)
+            qparams.p_act = params.program;
+        if (params.dateFiledStart)
+            qparams.p_date_filed_from = params.dateFiledStart;
+        if (params.dateFiledEnd)
+            qparams.p_date_filed_to = params.dateFiledEnd;
+        // Case type filter
+        if (params.caseType && params.caseType !== 'all') {
+            qparams.p_case_category = params.caseType === 'criminal' ? 'C' : 'V';
+        }
+        const url = this.buildUrl('case_rest_services.get_case_info', qparams);
+        ctx.log.debug('ECHO case search', { url });
+        const data = await this.fetchJson(url, ctx);
+        const raw = data.Results?.Cases ?? [];
+        const totalCount = parseInt(data.Results?.TotalCount ?? '0', 10) || raw.length;
+        const cases = raw.map((c) => ({
+            ...(c.CaseID && { caseId: c.CaseID }),
+            ...(c.CaseName && { caseName: c.CaseName }),
+            ...(c.FacName && { facilityName: c.FacName }),
+            ...(c.RegistryID && { registryId: c.RegistryID }),
+            ...(c.ProgramsViolated && { programsViolated: String(c.ProgramsViolated) }),
+            ...(c.CaseType && { caseType: String(c.CaseType) }),
+            ...(c.PenaltyAssessed !== undefined &&
+                !Number.isNaN(Number(c.PenaltyAssessed)) && {
+                penaltyAssessedInDollars: Number(c.PenaltyAssessed),
+            }),
+            ...(c.SettlementDate && { settlementDate: String(c.SettlementDate) }),
+            ...(c.FiledDate && { filedDate: String(c.FiledDate) }),
+            ...(c.State && { state: String(c.State) }),
+        }));
+        return { cases, totalCount };
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initEchoService(config, storage) {
+    _service = new EchoService(config, storage);
+}
+export function getEchoService() {
+    if (!_service) {
+        throw new Error('EchoService not initialized — call initEchoService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=echo-service.js.map

package/dist/services/echo/echo-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo-service.js","sourceRoot":"","sources":["../../../src/services/echo/echo-service.ts"],"names":[],"mappings":"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"}

package/dist/services/echo/types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * @fileoverview ECHO API response types and normalized domain types for facility compliance data.
+ * @module services/echo/types
+ */
+/** Raw ECHO get_facility_info response facility record. Fields may be absent or empty string. */
+export interface RawEchoFacility {
+    AIRFlag?: string;
+    AIRPenalties?: string;
+    CWAFlag?: string;
+    CWAPenalties?: string;
+    FacCity?: string;
+    FacComplianceStatus?: string;
+    FacCounty?: string;
+    FacFIPSCode?: string;
+    FacLat?: string;
+    FacLon?: string;
+    FacName?: string;
+    FacState?: string;
+    FacStreet?: string;
+    FacZip?: string;
+    InspectionCount?: string;
+    RCRFlag?: string;
+    RCRPenalties?: string;
+    RegistryID?: string;
+    SDWAFlag?: string;
+    TRIFlag?: string;
+    TRIReleasesTransfers?: string;
+    [key: string]: string | undefined;
+}
+/** Raw ECHO get_facility_info top-level response envelope. */
+export interface RawEchoFacilityResponse {
+    Results?: {
+        Facilities?: RawEchoFacility[];
+        QueryID?: string;
+        PageNo?: string;
+        TotalPagesAvailable?: string;
+        TotalCount?: string;
+    };
+}
+/** Raw ECHO DFR compliance summary response envelope. */
+export interface RawEchoDfrComplianceSummary {
+    Results?: {
+        ComplianceSummary?: {
+            MediaStatusCode?: string;
+            MediaStatusDesc?: string;
+            QtrsInViol?: string | number;
+            QtrsInNC?: string | number;
+        };
+    };
+}
+/** Raw inspection/enforcement record from ECHO DFR. */
+export interface RawEchoInspection {
+    ActivityDate?: string;
+    ActivityType?: string;
+    ActivityTypeDescription?: string;
+}
+/** Raw formal action/penalty record from ECHO DFR. */
+export interface RawEchoFormalAction {
+    CaseID?: string;
+    FormalActionType?: string;
+    PenaltyAssessed?: string | number;
+    SettlementDate?: string;
+}
+/** Raw ECHO DFR inspection and enforcement response. */
+export interface RawEchoDfrInspectionEnforcement {
+    Results?: {
+        Inspections?: RawEchoInspection[];
+        FormalActions?: RawEchoFormalAction[];
+    };
+}
+/** Raw ECHO DFR air compliance record. */
+export interface RawEchoDfrAir {
+    Results?: {
+        AirComplianceSummary?: {
+            ProgramID?: string;
+            Status?: string;
+            StatusDate?: string;
+        };
+    };
+}
+/** Raw ECHO DFR water compliance record. */
+export interface RawEchoDfrWater {
+    Results?: {
+        WaterCompliance?: {
+            ProgramID?: string;
+            Status?: string;
+            PermitID?: string;
+        };
+    };
+}
+/** Raw ECHO enforcement case from case_rest_services. */
+export interface RawEchoCase {
+    CaseID?: string;
+    CaseName?: string;
+    CaseType?: string;
+    FacName?: string;
+    FiledDate?: string;
+    PenaltyAssessed?: string | number;
+    ProgramsViolated?: string;
+    RegistryID?: string;
+    SettlementDate?: string;
+    State?: string;
+    [key: string]: string | number | undefined;
+}
+/** Raw ECHO case search response envelope. */
+export interface RawEchoCaseResponse {
+    Results?: {
+        Cases?: RawEchoCase[];
+        QueryID?: string;
+        TotalCount?: string;
+    };
+}
+/** Normalized EPA facility record for tool responses. */
+export interface EpaFacility {
+    city?: string;
+    complianceStatus?: string;
+    county?: string;
+    fipsCode?: string;
+    inspectionCount?: number;
+    latitude?: number;
+    longitude?: number;
+    name: string;
+    programs: {
+        air: boolean;
+        water: boolean;
+        rcra: boolean;
+        tri: boolean;
+        sdwa: boolean;
+    };
+    registryId: string;
+    state?: string;
+    street?: string;
+    totalPenaltiesInDollars?: number;
+    triReleasesTransfersInLbs?: number;
+    zip?: string;
+}
+/** Normalized enforcement case. */
+export interface EpaCase {
+    caseId?: string;
+    caseName?: string;
+    caseType?: string;
+    facilityName?: string;
+    filedDate?: string;
+    penaltyAssessedInDollars?: number;
+    programsViolated?: string;
+    registryId?: string;
+    settlementDate?: string;
+    state?: string;
+}
+/** Full facility compliance profile aggregated from multiple DFR endpoints. */
+export interface EpaFacilityProfile {
+    airCompliance?: {
+        programId?: string;
+        status?: string;
+        statusDate?: string;
+    };
+    city?: string;
+    compliance?: {
+        mediaStatusCode?: string;
+        mediaStatusDescription?: string;
+        quartersInViolation?: number;
+    };
+    complianceStatus?: string;
+    county?: string;
+    fipsCode?: string;
+    formalActions: Array<{
+        caseId?: string;
+        settlementDate?: string;
+        penaltyAssessedInDollars?: number;
+        actionType?: string;
+    }>;
+    inspections: Array<{
+        activityType?: string;
+        activityDate?: string;
+        description?: string;
+    }>;
+    latitude?: number;
+    longitude?: number;
+    name: string;
+    programs: {
+        air: boolean;
+        water: boolean;
+        rcra: boolean;
+        tri: boolean;
+        sdwa: boolean;
+    };
+    registryId: string;
+    state?: string;
+    street?: string;
+    triReleasesTransfersInLbs?: number;
+    waterCompliance?: {
+        programId?: string;
+        status?: string;
+        permitId?: string;
+    };
+    zip?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/echo/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/echo/types.ts"],"names":[],"mappings":"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"}

package/dist/services/echo/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview ECHO API response types and normalized domain types for facility compliance data.
+ * @module services/echo/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/echo/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/echo/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@cyanheads/epa-mcp-server",
+  "version": "0.1.1",
+  "description": "Access EPA environmental data — facility compliance (ECHO), toxic releases (TRI), Superfund sites, drinking water systems, and real-time air quality (AirNow) via MCP. STDIO or Streamable HTTP.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "epa-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "changelog/",
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CLAUDE.md",
+    "Dockerfile",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "tsx scripts/build.ts",
+    "rebuild": "tsx scripts/clean.ts && tsx scripts/build.ts",
+    "clean": "tsx scripts/clean.ts",
+    "devcheck": "tsx scripts/devcheck.ts",
+    "audit:refresh": "rm -f bun.lock && bun install && bun audit",
+    "tree": "tsx scripts/tree.ts",
+    "list-skills": "tsx scripts/list-skills.ts",
+    "format": "biome check --write --unsafe .",
+    "lint:mcp": "tsx scripts/lint-mcp.ts",
+    "lint:packaging": "tsx scripts/lint-packaging.ts",
+    "bundle": "npm run build && npx -y @anthropic-ai/mcpb pack . dist/epa-mcp-server.mcpb",
+    "changelog:build": "tsx scripts/build-changelog.ts",
+    "changelog:check": "tsx scripts/build-changelog.ts --check",
+    "test": "vitest run",
+    "start": "node dist/index.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "epa",
+    "environmental",
+    "air-quality",
+    "toxic-release-inventory",
+    "superfund",
+    "drinking-water",
+    "compliance",
+    "echo-epa",
+    "airnow"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/epa-mcp-server.git"
+  },
+  "license": "Apache-2.0",
+  "engines": {
+    "bun": ">=1.3.0",
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.9.9",
+    "pino-pretty": "^13.1.3",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.15",
+    "@types/node": "^25.9.1",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.17",
+    "tsx": "^4.22.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  }
+}