# io.github.cyanheads/epa-mcp-server (npm · @cyanheads/epa-mcp-server)

EPA data: ECHO facility compliance, TRI releases, Superfund, drinking water, and AirNow air quality.

- Trust score: 67/100 (medium)
- Change this week: +52
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-07

## Components

- npm · `@cyanheads/epa-mcp-server`: 67/100 (this document), [markdown](https://verifymcp.io/servers/cyanheads-epa-mcp-server/cyanheads-epa-mcp-server.md), [page](https://verifymcp.io/servers/cyanheads-epa-mcp-server/cyanheads-epa-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `@cyanheads/epa-mcp-server`
- Version: `0.3.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-07.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 40 of 127 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 27 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 65/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2137 tokens (~267/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add cyanheads-epa-mcp-server -- npx -y @cyanheads/epa-mcp-server
```

### Codex

```bash
codex mcp add cyanheads-epa-mcp-server -- npx -y @cyanheads/epa-mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-epa-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@cyanheads/epa-mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cyanheads-epa-mcp-server --command npx --arg -y --arg @cyanheads/epa-mcp-server
```

### Hermes

```yaml
mcp_servers:
  cyanheads-epa-mcp-server:
    command: "npx"
    args: ["-y", "@cyanheads/epa-mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "cyanheads-epa-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/epa-mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-07 (score 67, +4)

- [security improvement] Known CVEs: partial → pass
- [functional improvement] Security disclosure: fail → pass
- [functional] Dependency health: partial → 0.85

### 2026-08-06 (score 63, +28)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: excellent
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 100

### 2026-08-05 (score 35, +1)

- [security improvement] CVE-2026-69207 no longer affects this package
- [security improvement] Known CVEs: fail → partial

### 2026-08-04 (score 34, −1)

- [security regression] CVE-2026-69207 affects this package: medium
- [security regression] Known CVEs: partial → fail

### 2026-08-03 (score 35, +15)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional] Licence: Apache-2.0

### 2026-08-01 (score 20, +5)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 15, −9)

- [security regression] Provenance: unverified → fail
- [security regression] Malware scan: pass → unverified
- [security improvement] Install scripts: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] License: unverified → pass
- [functional] Licence: Apache-2.0

### 2026-07-29 (score 24, −1)

- [functional regression] Dependency health: partial → unverified
- [functional] Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess.
- [functional] Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess.

## MCP tools (8)

### `epa_search_facilities` (~361 tokens)

Search EPA Facilities

Search EPA-regulated facilities by location, industry program, or compliance status across all environmental programs (CAA, CWA, RCRA, TRI, SDWA). Returns facility name, EPA Registry ID, coordinates, county FIPS code, per-program registration flags, inspection counts, penalty totals, and TRI release totals. Registry IDs returned here feed epa_get_facility and epa_get_tri_releases. Supports proximity search via latitude + longitude + radius_miles. At least one geographic filter (zip_code, state, city, or a complete latitude+longitude+radius_miles triple) is required — unscoped searches time out.

Input parameters:

- `active_only` (boolean): When true, return only active facilities
- `city` (string): City name. Pair with state for best results.
- `has_violation` (boolean): When true, return only facilities with recent significant violations
- `latitude` (number): Latitude in decimal degrees. Pair with longitude and radius_miles for proximity search.
- `limit` (integer): Maximum number of facilities to return (1–100)
- `longitude` (number): Longitude in decimal degrees. Pair with latitude and radius_miles for proximity search.
- `programs` (array): Restrict results to facilities registered in these environmental programs. CAA=air, CWA=water, RCRA=waste, TRI=toxic releases, SDWA=drinking water.
- `radius_miles` (number): Search radius in miles around the given latitude/longitude (max 100). Requires latitude and longitude.
- `state` (string): 2-letter US state abbreviation (e.g. "WA", "CA")
- `zip_code` (string): 5-digit ZIP code to search within

Output parameters:

- `facilities` (array): Matching EPA facilities
- `message` (string): Recovery hint when no results are found — echoes applied filters and suggests how to broaden the search. Absent when results are returned.
- `totalCount` (number): Total facilities matched before the limit was applied

### `epa_get_facility` (~102 tokens)

Get EPA Facility Compliance Profile

Retrieve a full compliance profile for a single EPA-regulated facility by EPA Registry ID. Returns facility metadata, per-program compliance status, inspection history, formal enforcement actions, penalty totals, and TRI release summary. Use epa_search_facilities to discover Registry IDs. For area-level enforcement discovery use epa_search_violations instead.

Input parameters:

- `registry_id` (string, required): EPA FRS Registry ID for the facility (obtained from epa_search_facilities)

Output parameters:

- `airCompliance` (object): CAA-specific compliance details. Present only when facility is registered under CAA (programs.air=true).
- `city` (string): City
- `compliance` (object): Compliance summary from DFR. Absent when ECHO DFR compliance endpoint unavailable.
- `complianceStatus` (string): Overall compliance status text
- `county` (string): County name
- `fipsCode` (string): 5-digit county FIPS code
- `formalActions` (array): Formal enforcement actions on record
- `inspections` (array): Inspection history records
- `latitude` (number): Latitude in decimal degrees
- `longitude` (number): Longitude in decimal degrees
- `name` (string): Facility name
- `programs` (object): Program registration flags
- `registryId` (string): EPA FRS Registry ID
- `state` (string): 2-letter state abbreviation
- `street` (string): Street address
- `triReleasesTransfersInLbs` (number): Total TRI on/off-site releases and transfers in pounds
- `waterCompliance` (object): CWA/NPDES permit and compliance details. Present only when facility is registered under CWA (programs.water=true).
- `zip` (string): ZIP code

### `epa_search_violations` (~286 tokens)

Search EPA Enforcement Cases

Search EPA civil and criminal enforcement cases by state, regulatory program, or date range. Returns case identifier, regulated facility name and Registry ID, programs involved, penalty assessed, settlement date, and case type. Designed for area-level violation discovery — for a single known facility's enforcement history use epa_get_facility instead. At least one of state or zip_code is required.

Input parameters:

- `case_type` (string): Filter by case type: civil (regulatory violations), criminal (willful violations), or all
- `date_filed_end` (string): End date for case filing date range (ISO 8601: YYYY-MM-DD)
- `date_filed_start` (string): Start date for case filing date range (ISO 8601: YYYY-MM-DD)
- `limit` (integer): Maximum number of cases to return (1–100)
- `program` (string): Filter by regulatory program: CAA=Clean Air Act, CWA=Clean Water Act, RCRA=hazardous waste, SDWA=drinking water, CERCLA=Superfund, FIFRA=pesticides, TSCA=toxic substances
- `state` (string): 2-letter US state abbreviation to filter cases (e.g. "TX", "CA")
- `zip_code` (string): 5-digit ZIP code to filter cases near that area

Output parameters:

- `cases` (array): Matching enforcement cases
- `message` (string): Recovery hint when no cases are found — echoes filters and suggests broadening. Absent when cases are returned.
- `totalCount` (number): Total cases matched before the limit was applied

### `epa_get_tri_releases` (~180 tokens)

Get TRI Chemical Releases for Facility

Query Toxic Release Inventory annual chemical release data for a specific facility. Returns per-chemical release records with chemical name, total release quantity, and reporting year. TRI data lags ~18 months — the most recent available year is typically 2 years prior to the current calendar year. Obtain facility_id (TRI facility ID) from epa_search_facilities. Use epa_search_tri_releases to identify top emitters across a region.

Input parameters:

- `chemical_name` (string): Optional filter to restrict results to a specific chemical (partial match, case-insensitive)
- `facility_id` (string, required): TRI facility ID (from the RegistryID field returned by epa_search_facilities)
- `year` (integer): Reporting year to retrieve. Defaults to all available years. TRI data is typically available through ~2 years prior to the current year.

Output parameters:

- `facilityId` (string): TRI facility ID queried
- `message` (string): Recovery hint when no releases are found — suggests alternative years or checking the facility ID. Absent when releases are returned.
- `releases` (array): Per-chemical annual TRI release records for the queried facility

### `epa_search_tri_releases` (~199 tokens)

Search TRI Releases by Region

Search Toxic Release Inventory data across facilities in a state or county for a given reporting year. Returns facility name, TRI ID, chemical name, and release quantity. Use to identify top polluters in an area or build an environmental exposure profile. Use epa_get_tri_releases for detailed release records for a single facility. TRI data lags ~18 months from the current calendar year.

Input parameters:

- `chemical_name` (string): Optional filter to restrict results to a specific chemical (partial match, case-insensitive)
- `county` (string): County name to narrow results within the state (partial match)
- `limit` (integer): Maximum number of release records to return (1–200)
- `state` (string, required): 2-letter US state abbreviation (required, e.g. "WA", "TX")
- `year` (integer): Reporting year. Defaults to all available years in the state. TRI data lags ~18 months.

Output parameters:

- `cap` (number): The limit that was applied.
- `message` (string): Recovery hint when no releases are found. Absent when releases are returned.
- `releases` (array): TRI release records for facilities in the queried state and filters
- `shown` (number): Number of release records returned.
- `state` (string): State queried
- `truncated` (boolean): True when the result list was capped at the limit — more records may exist.

### `epa_search_superfund` (~261 tokens)

Search Superfund Sites

Search Superfund (CERCLA/SEMS) sites by location or NPL listing status. Returns site name, EPA site ID, NPL status (listed/not listed/proposed), cleanup status, coordinates, and county FIPS code. Accepts either state/city/ZIP or latitude+longitude+radius for proximity searches. Use for "are there Superfund sites near X" questions.

Input parameters:

- `city` (string): City name (partial match within state)
- `latitude` (number): Latitude for proximity search (use with longitude and radius_miles)
- `limit` (integer): Maximum number of sites to return (1–200)
- `longitude` (number): Longitude for proximity search (use with latitude and radius_miles)
- `npl_status` (string): Filter by NPL (National Priorities List) status: listed=final NPL, not-listed=not on NPL, proposed=proposed for listing, all=include all
- `radius_miles` (number): Search radius in miles from the given coordinates. Required when using latitude+longitude.
- `state` (string): 2-letter US state abbreviation to filter sites
- `zip_code` (string): 5-digit ZIP code to filter sites

Output parameters:

- `message` (string): Recovery hint when no sites are found. Absent when sites are returned.
- `sites` (array): Matching Superfund sites
- `totalCount` (number): Number of sites returned (may be less than available if limit applied)

### `epa_search_water_systems` (~188 tokens)

Search Drinking 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. Use to identify community water systems with current or recent compliance violations. At least one of state or zip_code is required.

Input parameters:

- `has_violation` (boolean): When true, return only systems with active violations
- `limit` (integer): Maximum number of systems to return (1–200)
- `pws_type` (string): Filter by public water system type: community=permanent residences, non-transient=regular non-residents (schools, businesses), transient=occasional users (campgrounds)
- `state` (string): 2-letter US state abbreviation (e.g. "WA", "CA")
- `zip_code` (string): 5-digit ZIP code to search within

Output parameters:

- `message` (string): Recovery hint when no systems are found. Absent when systems are returned.
- `systems` (array): Matching public water systems
- `totalCount` (number): Number of systems returned

### `epa_get_ejscreen` (~307 tokens)

Get EJScreen Environmental Justice Indicators

Get EJScreen environmental-justice indicators for a point and surrounding buffer. Returns the 13 EJScreen environmental indicators (PM2.5, ozone, diesel particulate, NO2, lead paint, traffic proximity, Superfund/RMP/hazardous-waste/wastewater proximity, underground storage tanks, drinking-water non-compliance, and RSEI toxic air releases) and 6 demographic indicators (people of color, low income, limited English, less than high school, under 5, over 64), each with national and state percentiles plus EJ Index values, along with the Demographic Index and Supplemental Demographic Index. Data is EJScreen v2.2 (2022) served via the community-maintained EJAM API (api.ejanalysis.com, Public Environmental Data Partners), which rehosts EJScreen after EPA discontinued public access in 2025 — not a live EPA endpoint. Provide latitude, longitude, and a buffer distance (default 1 mile, max 15 miles). Points outside US coverage return a coverage note instead of indicators.

Input parameters:

- `distance` (number): Buffer radius around the point, in the given unit (default 1). The miles-equivalent must be 15 or less.
- `latitude` (number, required): Latitude in decimal degrees.
- `longitude` (number, required): Longitude in decimal degrees.
- `unit` (string): Unit for distance. Kilometers are converted to miles (× 0.621371) before the request.

Output parameters:

- `coverage` (object): Whether EJScreen data was available for the point.
- `dataSource` (string): Provenance and vintage of the data.
- `demographic` (array): EJScreen demographic indicators present for the area. Empty when out of coverage.
- `demographicIndex` (object): EJScreen Demographic Index. Absent when out of coverage.
- `environmental` (array): EJScreen environmental indicators present for the area. Empty when out of coverage.
- `location` (object): The queried location and buffer context.
- `notice` (string): Guidance when the point is outside EJScreen coverage and no indicators were returned.
- `reportUrl` (string): Link (absolute URL) to the full EJScreen report for this point and buffer.
- `supplementalDemographicIndex` (object): EJScreen Supplemental Demographic Index. Absent when out of coverage.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/cyanheads-epa-mcp-server/cyanheads-epa-mcp-server#diagnostics

## Score history

- 2026-08-07: 67
- 2026-08-06: 63
- 2026-08-05: 35
- 2026-08-04: 34
- 2026-08-03: 35
- 2026-08-02: 20
- 2026-08-01: 20
- 2026-07-31: 15
- 2026-07-29: 24
- 2026-07-28: 25
- 2026-07-27: 24

## Links

- npm package: https://www.npmjs.com/package/@cyanheads/epa-mcp-server
- Socket report: https://socket.dev/npm/package/@cyanheads/epa-mcp-server
- Repository: https://github.com/cyanheads/epa-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/cyanheads-epa-mcp-server/cyanheads-epa-mcp-server.xml
- Changelog JSON feed: https://verifymcp.io/servers/cyanheads-epa-mcp-server/cyanheads-epa-mcp-server.json
- HTML version of this page: https://verifymcp.io/servers/cyanheads-epa-mcp-server/cyanheads-epa-mcp-server