@cyanheads/epa-mcp-server 0.1.1

package/README.md

@@ -0,0 +1,322 @@
+<div align="center">
+  <h1>@cyanheads/epa-mcp-server</h1>
+  <p><b>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.</b>
+  <div>8 Tools • 2 Resources</div>
+  </p>
+</div>
+
+<div align="center">
+
+[![Version](https://img.shields.io/badge/Version-0.1.1-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.2-blueviolet.svg?style=flat-square)](https://bun.sh/)
+
+</div>
+
+<div align="center">
+
+[![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)
+
+</div>
+
+---
+
+## Tools
+
+8 tools spanning EPA facility compliance, toxic chemical releases, Superfund cleanup sites, drinking water safety, and real-time air quality:
+
+| Tool | Description |
+|:---|:---|
+| `epa_search_facilities` | Search EPA-regulated facilities by location, industry, or compliance status across all environmental programs (CAA, CWA, RCRA, TRI, SDWA). Returns facility name, EPA Registry ID, coordinates, county FIPS, per-program compliance flags, inspection counts, penalty totals, and TRI release totals. |
+| `epa_get_facility` | Retrieve a full compliance profile for a single EPA-regulated facility: compliance status per program, inspection dates, formal enforcement actions, penalty amounts, and TRI annual release totals. Aggregates multiple ECHO DFR endpoints in parallel. |
+| `epa_search_violations` | Search EPA civil and criminal enforcement cases by state, regulatory program, or date range. Returns case identifier, facility name and Registry ID, programs involved, penalty assessed, settlement date, and case type. |
+| `epa_get_air_quality` | Get AQI observations or forecasts for a location. Returns per-pollutant AQI values (PM2.5, ozone, CO, SO2, NO2), AQI category (Good through Hazardous), reporting area name, and observation timestamp. |
+| `epa_get_tri_releases` | Query Toxic Release Inventory annual chemical release data for a specific facility by medium (air, water, land, underground injection) and reporting year. |
+| `epa_search_tri_releases` | Search Toxic Release Inventory data across facilities in a state or county for a given year. Returns facility name, TRI ID, chemical name, total releases by medium, and facility coordinates. |
+| `epa_search_superfund` | Search Superfund (CERCLA/SEMS) sites by location or NPL listing status. Accepts state/city/ZIP or lat/lng + radius for proximity searches. Returns site name, EPA ID, NPL status, cleanup status, and coordinates. |
+| `epa_search_water_systems` | Search drinking water systems (SDWIS) by state or ZIP code. Returns system name, PWSID, population served, primary water source, and active violation status. |
+
+### `epa_search_facilities`
+
+Search for EPA-regulated facilities with cross-program compliance data.
+
+- Geographic filters: ZIP code, state, city (city requires state)
+- Program filter: narrow to CAA, CWA, RCRA, TRI, or SDWA registrants
+- Compliance filter: `has_violation` flag to surface only non-compliant facilities
+- Returns `RegistryID` (key for `epa_get_facility`), `FacFIPSCode` (county FIPS for Census chaining), and coordinates
+- Results cap enforced — unscoped searches are prohibited at the input validation layer
+
+---
+
+### `epa_get_facility`
+
+Retrieve a comprehensive compliance profile by EPA Registry ID.
+
+- Aggregates 3–5 ECHO DFR endpoints in parallel: program flags and TRI totals, compliance summary, inspection/enforcement history, CAA details (if registered), CWA/NPDES permit details (if registered)
+- Uses `Promise.allSettled` — partial data returned even if one upstream endpoint fails
+- Includes formal enforcement actions, penalty amounts, and inspection dates across all programs
+
+---
+
+### `epa_search_violations`
+
+Search area-level EPA enforcement cases — distinct from per-facility history in `epa_get_facility`.
+
+- Program filter: CAA, CWA, RCRA, SDWA, CERCLA, FIFRA, or TSCA
+- Case type: civil, criminal, or all
+- Date range filtering by filing date (ISO 8601)
+- Returns case identifier, affected facility name and Registry ID for downstream `epa_get_facility` lookup
+
+---
+
+### `epa_get_air_quality`
+
+Get current AQI observations or daily forecasts from AirNow.
+
+- Accepts ZIP code or latitude/longitude coordinates
+- `mode: current` returns the latest observed AQI per pollutant; `mode: forecast` returns daily AQI forecasts (requires `forecast_date`)
+- AQI categories: Good (1) through Hazardous (6) with numeric and text category
+- Data is preliminary — suitable for awareness, not regulatory or enforcement decisions
+- AirNow responses cached at ~1 hour TTL to respect rate limits
+
+---
+
+### `epa_get_tri_releases`
+
+Query per-chemical release breakdown for a single TRI facility.
+
+- Accepts TRI facility ID from `epa_search_facilities` results
+- Returns release quantities by medium: air, water, land, underground injection
+- Optional year filter (defaults to most recent available); optional chemical name filter
+- TRI data lags ~18 months — most recent available year is typically 2 years prior to current
+
+---
+
+### `epa_search_tri_releases`
+
+Identify top polluters in a region via TRI data.
+
+- State and optional county scope; required year parameter
+- Optional chemical name filter to focus on a specific substance
+- Returns facility coordinates for downstream map or proximity analysis
+- Complement to `epa_get_tri_releases` — use this for area discovery, then drill into a specific facility
+
+---
+
+### `epa_search_superfund`
+
+Search Superfund (CERCLA/SEMS) sites by location or proximity.
+
+- Two input shapes: state/city/ZIP for administrative filters, or lat/lng + radius for proximity
+- NPL status filter: listed, not-listed, proposed, or all
+- Returns site cleanup status and coordinates for downstream spatial analysis
+
+---
+
+### `epa_search_water_systems`
+
+Identify drinking water systems with active or recent violations.
+
+- State and optional ZIP code scope
+- `has_violation` flag surfaces only systems with current violations
+- PWS type filter: community (`CWS`), non-transient non-community (`NTNCWS`), or transient non-community (`TNCWS`)
+
+## Resources and prompts
+
+| Type | Name | Description |
+|:---|:---|:---|
+| Resource | `epa://facility/{registry_id}` | Full compliance profile for a facility by EPA Registry ID (same data as `epa_get_facility`) |
+| Resource | `epa://superfund/{site_id}` | Superfund site record by SEMS site ID |
+
+All resource data is also reachable via tools. Use `epa_get_facility` and `epa_search_superfund` for programmatic access in tool-only MCP clients.
+
+## Features
+
+Built on [`@cyanheads/mcp-ts-core`](https://www.npmjs.com/package/@cyanheads/mcp-ts-core):
+
+- Declarative tool and resource definitions — single file per primitive, framework handles registration and validation
+- Unified error handling — handlers throw, framework catches, classifies, and formats
+- Pluggable auth: `none`, `jwt`, `oauth`
+- Swappable storage backends: `in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`
+- Structured logging with optional OpenTelemetry tracing
+- STDIO and Streamable HTTP transports
+
+EPA-specific:
+
+- Three complementary EPA APIs unified behind a single `epa_` tool surface: ECHO (facility compliance), Envirofacts DMAP (TRI, Superfund, SDWIS), and AirNow (real-time air quality)
+- Parallel ECHO DFR aggregation in `epa_get_facility` — 3–5 upstream calls resolved concurrently with `Promise.allSettled`
+- AirNow response caching (~1 hour TTL) to stay within per-key rate limits
+- DMAP coordinate normalization — `tri.tri_facility` DDMMSS integers converted to decimal degrees
+
+Agent-friendly output:
+
+- Cross-tool join keys surfaced on every response — `RegistryID` and `FacFIPSCode` from facility search feed directly into compliance, TRI, and Census API workflows
+- Typed enforcement and compliance status fields — agents branch on data values, not string parsing
+- Structured partial failure — `epa_get_facility` returns available program data even when one DFR endpoint is unavailable, with per-section status
+
+## Getting started
+
+Add the following to your MCP client configuration file. An AirNow API key is required for `epa_get_air_quality` — register free at [docs.airnowapi.org](https://docs.airnowapi.org/account/request/). ECHO and DMAP tools work without authentication.
+
+```json
+{
+  "mcpServers": {
+    "epa": {
+      "type": "stdio",
+      "command": "bunx",
+      "args": ["@cyanheads/epa-mcp-server@latest"],
+      "env": {
+        "MCP_TRANSPORT_TYPE": "stdio",
+        "MCP_LOG_LEVEL": "info",
+        "AIRNOW_API_KEY": "your-airnow-key"
+      }
+    }
+  }
+}
+```
+
+Or with npx (no Bun required):
+
+```json
+{
+  "mcpServers": {
+    "epa": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@cyanheads/epa-mcp-server@latest"],
+      "env": {
+        "MCP_TRANSPORT_TYPE": "stdio",
+        "MCP_LOG_LEVEL": "info",
+        "AIRNOW_API_KEY": "your-airnow-key"
+      }
+    }
+  }
+}
+```
+
+For Streamable HTTP, set the transport and start the server:
+
+```sh
+MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 AIRNOW_API_KEY=... bun run start:http
+# Server listens at http://localhost:3010/mcp
+```
+
+### Prerequisites
+
+- [Bun v1.3.0](https://bun.sh/) or higher (or Node.js v24+).
+- An AirNow API key for `epa_get_air_quality` — register free at [docs.airnowapi.org/account/request](https://docs.airnowapi.org/account/request/). ECHO and DMAP tools require no API key.
+
+### Installation
+
+1. **Clone the repository:**
+
+```sh
+git clone https://github.com/cyanheads/epa-mcp-server.git
+```
+
+2. **Navigate into the directory:**
+
+```sh
+cd epa-mcp-server
+```
+
+3. **Install dependencies:**
+
+```sh
+bun install
+```
+
+4. **Configure environment:**
+
+```sh
+cp .env.example .env
+# edit .env and set AIRNOW_API_KEY
+```
+
+## Configuration
+
+All configuration is validated at startup via Zod schemas in `src/config/`. Key environment variables:
+
+| Variable | Description | Default |
+|:---|:---|:---|
+| `AIRNOW_API_KEY` | **Required for `epa_get_air_quality`.** Free registration at [docs.airnowapi.org](https://docs.airnowapi.org/account/request/). ECHO and DMAP tools work without it. | — |
+| `EPA_ECHO_BASE_URL` | ECHO API base URL | `https://echodata.epa.gov/echo` |
+| `EPA_DMAP_BASE_URL` | Envirofacts DMAP API base URL | `https://data.epa.gov/dmapservice` |
+| `EPA_AIRNOW_BASE_URL` | AirNow API base URL | `https://www.airnowapi.org/aq` |
+| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http` | `stdio` |
+| `MCP_HTTP_PORT` | HTTP server port | `3010` |
+| `MCP_HTTP_ENDPOINT_PATH` | HTTP endpoint path | `/mcp` |
+| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth` | `none` |
+| `MCP_LOG_LEVEL` | Log level (RFC 5424) | `info` |
+| `LOGS_DIR` | Directory for log files (Node.js only) | `<project-root>/logs` |
+| `STORAGE_PROVIDER_TYPE` | Storage backend: `in-memory`, `filesystem`, `supabase`, `cloudflare-kv/r2/d1` | `in-memory` |
+| `OTEL_ENABLED` | Enable [OpenTelemetry](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry) tracing and metrics | `false` |
+
+See [`.env.example`](./.env.example) for the full list of optional overrides.
+
+## Running the server
+
+### Local development
+
+- **Build and run:**
+
+  ```sh
+  # One-time build
+  bun run rebuild
+
+  # Run the built server
+  bun run start:stdio
+  # or
+  bun run start:http
+  ```
+
+- **Run checks and tests:**
+
+  ```sh
+  bun run devcheck   # Lint, format, typecheck, security
+  bun run test       # Vitest test suite
+  bun run lint:mcp   # Validate MCP definitions against spec
+  ```
+
+### Docker
+
+```sh
+docker build -t epa-mcp-server .
+docker run --rm -e AIRNOW_API_KEY=your-key -p 3010:3010 epa-mcp-server
+```
+
+The Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/epa-mcp-server`. OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them.
+
+## Project structure
+
+| Directory | Purpose |
+|:---|:---|
+| `src/index.ts` | `createApp()` entry point — registers tools/resources and inits services. |
+| `src/config` | Server-specific environment variable parsing and validation with Zod. |
+| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). Eight tools across ECHO, DMAP, and AirNow. |
+| `src/mcp-server/resources` | Resource definitions (`*.resource.ts`). Facility and Superfund URI handlers. |
+| `src/services/echo` | ECHO REST API service layer — facility search, facility detail, enforcement cases. |
+| `src/services/dmap` | Envirofacts DMAP service layer — TRI releases, Superfund sites, drinking water systems. |
+| `src/services/airnow` | AirNow service layer — current and forecast AQI observations. |
+| `tests/` | Unit and integration tests mirroring `src/`. |
+
+## Development guide
+
+See [`CLAUDE.md`](./CLAUDE.md) for development guidelines and architectural rules. The short version:
+
+- Handlers throw, framework catches — no `try/catch` in tool logic
+- Use `ctx.log` for request-scoped logging, `ctx.state` for tenant-scoped storage
+- Register new tools and resources via the barrels in `src/mcp-server/*/definitions/index.ts`
+- Wrap external API calls: validate raw → normalize to domain type → return output schema; never fabricate missing fields
+- ECHO searches must enforce at least one geographic parameter — unscoped queries time out against the live API
+
+## Contributing
+
+Issues and pull requests are welcome. Run checks and tests before submitting:
+
+```sh
+bun run devcheck
+bun run test
+```
+
+## License
+
+Apache-2.0 — see [LICENSE](LICENSE) for details.

package/changelog/0.1.x/0.1.0.md

@@ -0,0 +1,22 @@
+---
+summary: "Initial release — EPA environmental data server (ECHO, TRI, Superfund, SDWIS, AirNow)"
+breaking: false
+security: false
+---
+
+# 0.1.0 — 2026-05-25
+
+## Added
+
+- **`epa_search_facilities`** — search EPA-regulated facilities by location, program, and compliance status via ECHO `get_facility_info`; returns `RegistryID`, county FIPS, coordinates, per-program flags, and TRI totals
+- **`epa_get_facility`** — full compliance profile aggregated from 3–5 parallel ECHO DFR endpoints; uses `Promise.allSettled` for partial-success resilience
+- **`epa_search_violations`** — area-level civil and criminal enforcement case search via ECHO `case_rest_services`
+- **`epa_get_air_quality`** — current and forecast AQI by ZIP or lat/lng via AirNow; ~1 hour response cache
+- **`epa_get_tri_releases`** — per-chemical release breakdown by medium for a single TRI facility via DMAP `tri.tri_reporting_form`
+- **`epa_search_tri_releases`** — area TRI emitter search by state/county and year
+- **`epa_search_superfund`** — Superfund site search by location or lat/lng + radius via DMAP `sems.envirofacts_site`
+- **`epa_search_water_systems`** — drinking water system search by state/ZIP via DMAP `sdwis.water_system`
+- **`epa://facility/{registry_id}`** resource — compliance profile by EPA Registry ID
+- **`epa://superfund/{site_id}`** resource — Superfund site record by SEMS site ID
+- `EchoService`, `DmapService`, `AirNowService` — service layers for ECHO, Envirofacts DMAP, and AirNow APIs
+- `AIRNOW_API_KEY` env var (required for air quality tool); ECHO and DMAP are unauthenticated

package/changelog/0.1.x/0.1.1.md

@@ -0,0 +1,18 @@
+---
+summary: "Bug fixes from field testing — TRI field mapping, Superfund site lookup, SDWIS query, AirNow cache keys, ECHO headers, and server.json env var config"
+breaking: false
+security: false
+---
+
+# 0.1.1 — 2026-05-25
+
+## Fixed
+
+- **`epa_get_tri_releases` / `epa_search_tri_releases`** — corrected field name mappings from `tri_reporting_form`; chemical names and release quantities (air, water, land, underground injection) were always empty due to wrong column names ([#3](https://github.com/cyanheads/epa-mcp-server/issues/3))
+- **`epa_search_superfund`** — `site_name` was always empty; fixed wrong field name in `normalizeSemsSite()` ([#4](https://github.com/cyanheads/epa-mcp-server/issues/4))
+- **`epa://superfund/{site_id}` resource** — site lookup heuristic was wrong; resource never found sites by ID; fixed ID matching logic ([#6](https://github.com/cyanheads/epa-mcp-server/issues/6))
+- **`epa_search_water_systems`** — `has_violation` filter crashed because `violation_flag` column does not exist in SDWIS; switched to correct column; city field was always missing and is now populated ([#5](https://github.com/cyanheads/epa-mcp-server/issues/5))
+- **`epa_get_air_quality`** — cache key generation produced invalid characters (slashes from lat/lng), crashing every call; replaced with a safe `key-value` join ([#1](https://github.com/cyanheads/epa-mcp-server/issues/1))
+- **`epa_search_facilities` / `epa_search_violations`** — ECHO API bot-blocking returned empty results silently; added `User-Agent` header to all ECHO requests ([#2](https://github.com/cyanheads/epa-mcp-server/issues/2))
+- **`AIRNOW_API_KEY`** — env var was missing from `server.json` `environmentVariables` and `manifest.json` `user_config`; added to both ([#7](https://github.com/cyanheads/epa-mcp-server/issues/7))
+- **`epa_get_facility`** — tool description no longer leaks internal "ECHO DFR endpoints in parallel" implementation detail ([#8](https://github.com/cyanheads/epa-mcp-server/issues/8))

package/changelog/template.md

@@ -0,0 +1,119 @@
+---
+# FORMAT REFERENCE — do not edit. Copy this file to
+# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
+# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
+# with a concrete date.
+
+# Required. One-line GitHub Release-style headline. 350 character cap.
+# Default short and scannable. Don't pad, don't stitch unrelated changes with
+# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
+# inside the value as a key separator and fails GitHub's strict parser.
+summary: ""
+
+# Set `true` when consumers must change code to upgrade: API removals,
+# signature changes, config renames, behavior changes that break existing
+# usage. Flagged as `Breaking` in the rollup.
+breaking: false
+
+# Set `true` if this release contains any security fix. Pairs with the
+# `## Security` section below. Flagged as `Security` in the rollup so
+# users can triage upgrade urgency at a glance.
+security: false
+---
+
+# <version> — YYYY-MM-DD
+
+<!--
+  AUTHORING GUIDE — applies to the new per-version file you create from this
+  template.
+
+  Audience: someone scanning release notes to decide what affects them. Lead
+  each bullet with the symbol or concept name in **bold** so they can skip
+  what's irrelevant and zoom in on what's not.
+
+  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
+  name the symbol, state what changed, stop. Use a second sentence only when
+  it carries weight. If a bullet feels long, it is.
+
+  Cut: mechanism walkthroughs (those belong in JSDoc, AGENTS.md, or the
+  relevant skill), ceremonial framings ("This release introduces…",
+  backwards-compat paragraphs), file-by-file test enumerations, internal
+  implementation notes. Prefer code/symbol names over English re-explanations.
+
+  Narrative intro: skip by default. Add one short sentence only when the
+  release theme genuinely needs framing the bullets can't carry.
+
+  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
+  Fixed, Security. Include only sections with entries; delete the rest
+  (including the commented-out scaffolding below). Don't ship empty headers.
+
+  Include: every distinct fact a reader needs to adopt or audit the release —
+  new exports, signatures, lint rule IDs, env vars, breaking changes, version
+  bumps on shipped skills. Nothing more.
+
+  Links: link issues, PRs, docs, or skills where they help a reader jump to
+  context. Once per item per entry — don't re-link the same issue in summary,
+  narrative, and bullet. Skip links for inline symbol names; code spans speak
+  for themselves.
+
+  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
+  inside its own UI, not in npm reads or local editors.
+
+      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
+      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
+
+  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
+  Never speculate on a future number — `#42` for an upcoming PR silently
+  resolves to whatever real item already owns 42, and timeline previews pull
+  in that unrelated item's metadata.
+
+  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
+  via `gh release create --notes-from-tag`. The tag is a derivative of this
+  changelog entry — a condensed, scannable version, not a copy. Format:
+
+    <theme — omit version number, GitHub prepends it>
+                                                          ← blank line
+    <1-2 sentence context: what this release does>
+                                                          ← blank line
+    Dependency bumps:                                     ← section header
+                                                          ← blank line
+    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
+                                                          ← blank line
+    Changed:                                              ← only sections with entries
+                                                          ← blank line
+    - `format()` output includes `query` in text mode
+                                                          ← blank line
+    Added:
+                                                          ← blank line
+    - `manifest.json` scaffolded for MCPB bundle support
+    - Install badges (Claude Desktop, Cursor, VS Code)
+                                                          ← blank line
+    <N> tests pass; `bun run devcheck` clean.             ← footer
+
+  Never a flat comma-separated string. Always structured markdown with
+  sections. The tag must scan well as a rendered GitHub Release page.
+-->
+
+## Added
+
+-
+
+## Changed
+
+-
+
+<!-- ## Deprecated
+
+- -->
+
+<!-- ## Removed
+
+- -->
+
+## Fixed
+
+-
+
+<!-- ## Security
+
+- -->

package/dist/config/server-config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Server-specific environment variable configuration for epa-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    airNowApiKey: z.ZodString;
+    echoBaseUrl: z.ZodDefault<z.ZodString>;
+    dmapBaseUrl: z.ZodDefault<z.ZodString>;
+    airNowBaseUrl: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+export declare function getServerConfig(): ServerConfig;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;;;;iBAoBtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAQ9C"}

package/dist/config/server-config.js

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Server-specific environment variable configuration for epa-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const ServerConfigSchema = z.object({
+    airNowApiKey: z
+        .string()
+        .min(1)
+        .describe('AirNow API key (free registration at docs.airnowapi.org)'),
+    echoBaseUrl: z
+        .string()
+        .url()
+        .default('https://echodata.epa.gov/echo')
+        .describe('ECHO API base URL'),
+    dmapBaseUrl: z
+        .string()
+        .url()
+        .default('https://data.epa.gov/dmapservice')
+        .describe('DMAP API base URL'),
+    airNowBaseUrl: z
+        .string()
+        .url()
+        .default('https://www.airnowapi.org/aq')
+        .describe('AirNow API base URL'),
+});
+let _config;
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        airNowApiKey: 'AIRNOW_API_KEY',
+        echoBaseUrl: 'EPA_ECHO_BASE_URL',
+        dmapBaseUrl: 'EPA_DMAP_BASE_URL',
+        airNowBaseUrl: 'EPA_AIRNOW_BASE_URL',
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0DAA0D,CAAC;IACvE,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,+BAA+B,CAAC;SACxC,QAAQ,CAAC,mBAAmB,CAAC;IAChC,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,kCAAkC,CAAC;SAC3C,QAAQ,CAAC,mBAAmB,CAAC;IAChC,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,8BAA8B,CAAC;SACvC,QAAQ,CAAC,qBAAqB,CAAC;CACnC,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,mBAAmB;QAChC,aAAa,EAAE,qBAAqB;KACrC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview epa-mcp-server MCP server entry point.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview epa-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { allResourceDefinitions } from './mcp-server/resources/definitions/index.js';
+import { allToolDefinitions } from './mcp-server/tools/definitions/index.js';
+import { initAirNowService } from './services/airnow/airnow-service.js';
+import { initDmapService } from './services/dmap/dmap-service.js';
+import { initEchoService } from './services/echo/echo-service.js';
+await createApp({
+    tools: [...allToolDefinitions],
+    resources: [...allResourceDefinitions],
+    prompts: [],
+    instructions: 'EPA environmental data server covering facility compliance (ECHO), toxic releases (TRI), Superfund sites, drinking water systems (SDWIS), and real-time air quality (AirNow).\n' +
+        '- All tools are read-only. All APIs are US federal government public domain data.\n' +
+        '- ECHO tools require at least one geographic filter (zip_code, state, or city) — unscoped searches time out.\n' +
+        '- TRI data lags ~18 months — most recent available year is typically 2 years prior to current.\n' +
+        '- AirNow data is preliminary and not valid for regulatory, trend, or enforcement purposes.\n' +
+        '- Typical workflows: epa_search_facilities → epa_get_facility → epa_search_violations (compliance audit); epa_search_superfund (proximity); epa_search_water_systems + has_violation=true (drinking water safety).',
+    setup(core) {
+        initEchoService(core.config, core.storage);
+        initDmapService(core.config, core.storage);
+        initAirNowService(core.config, core.storage);
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,SAAS,CAAC;IACd,KAAK,EAAE,CAAC,GAAG,kBAAkB,CAAC;IAC9B,SAAS,EAAE,CAAC,GAAG,sBAAsB,CAAC;IACtC,OAAO,EAAE,EAAE;IACX,YAAY,EACV,iLAAiL;QACjL,qFAAqF;QACrF,gHAAgH;QAChH,kGAAkG;QAClG,8FAA8F;QAC9F,oNAAoN;IACtN,KAAK,CAAC,IAAI;QACR,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Resource for fetching a full EPA facility compliance profile by Registry ID.
+ * @module mcp-server/resources/definitions/facility.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const facilityResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    registry_id: z.ZodString;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=facility.resource.d.ts.map

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

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

package/dist/mcp-server/resources/definitions/facility.resource.js

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Resource for fetching a full EPA facility compliance profile by Registry ID.
+ * @module mcp-server/resources/definitions/facility.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getEchoService } from '../../../services/echo/echo-service.js';
+export const facilityResource = resource('epa://facility/{registry_id}', {
+    name: 'epa-facility',
+    description: 'Full compliance profile for an EPA-regulated facility by EPA FRS Registry ID. Returns the same data as epa_get_facility.',
+    mimeType: 'application/json',
+    params: z.object({
+        registry_id: z.string().describe('EPA FRS Registry ID for the facility'),
+    }),
+    async handler(params, ctx) {
+        ctx.log.info('epa://facility resource', { registryId: params.registry_id });
+        const profile = await getEchoService().getFacility(params.registry_id, ctx);
+        if (!profile.registryId) {
+            throw notFound(`No facility found for Registry ID "${params.registry_id}". Use epa_search_facilities to discover valid Registry IDs.`, { registryId: params.registry_id });
+        }
+        return profile;
+    },
+});
+//# sourceMappingURL=facility.resource.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"facility.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/facility.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,8BAA8B,EAAE;IACvE,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,0HAA0H;IAC5H,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACzE,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAE5E,MAAM,OAAO,GAAG,MAAM,cAAc,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAE5E,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,QAAQ,CACZ,sCAAsC,MAAM,CAAC,WAAW,8DAA8D,EACtH,EAAE,UAAU,EAAE,MAAM,CAAC,WAAW,EAAE,CACnC,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Barrel export for all EPA MCP server resource definitions.
+ * @module mcp-server/resources/definitions/index
+ */
+export { facilityResource } from './facility.resource.js';
+export { superfundSiteResource } from './superfund-site.resource.js';
+export declare const allResourceDefinitions: readonly [import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
+    registry_id: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, undefined, undefined>, import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
+    site_id: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, undefined, undefined>];
+//# sourceMappingURL=index.d.ts.map

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

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