io.github.cyanheads/epa-mcp-server
NPM · @CYANHEADS/EPA-MCP-SERVER · SCANNED AUG 7
EPA data: ECHO facility compliance, TRI releases, Superfund, drinking water, and AirNow air quality.
Available components
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. How we score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 40 of 127 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (Apache-2.0).Pass
- Actively maintained (last published 27 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability65
- AI-judged instruction clarity (excellent).Pass
- 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. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
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.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @cyanheads/epa-mcp-server
claude mcp add cyanheads-epa-mcp-server -- npx -y @cyanheads/epa-mcp-server
codex mcp add cyanheads-epa-mcp-server -- npx -y @cyanheads/epa-mcp-server
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cyanheads-epa-mcp-server": {
"type": "local",
"command": [
"npx",
"-y",
"@cyanheads/epa-mcp-server"
],
"enabled": true
}
}
} openclaw mcp add cyanheads-epa-mcp-server --command npx --arg -y --arg @cyanheads/epa-mcp-server
mcp_servers:
cyanheads-epa-mcp-server:
command: "npx"
args: ["-y", "@cyanheads/epa-mcp-server"] {
"mcpServers": {
"cyanheads-epa-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/epa-mcp-server"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 7 Aug 26 +4
- Known CVEs: partial → pass ▲ security
- Security disclosure: fail → pass ▲ functional
- Dependency health: partial → 0.85 functional
- 6 Aug 26 +28
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- MCP protocol: unverified → pass ▲ functional
- 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 functional
- 5 Aug 26 +1
- CVE-2026-69207 no longer affects this package ▲ security
- Known CVEs: fail → partial ▲ security
- 4 Aug 26 −1
- CVE-2026-69207 affects this package: medium ▼ security
- Known CVEs: partial → fail ▼ security
- 3 Aug 26 +15
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Maintenance: unverified → pass ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Licence: Apache-2.0 functional
- 1 Aug 26 +5
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 31 Jul 26 −9
- Provenance: unverified → fail ▼ security
- Malware scan: pass → unverified ▼ security
- Install scripts: unverified → pass ▲ security
- Maintenance: unverified → pass ▲ functional
- License: unverified → pass ▲ functional
- Licence: Apache-2.0 functional
- 29 Jul 26 −1
- 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. functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 7 Aug 2026 · Analysed npm/@cyanheads/[email protected]
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Dependencies 127 packages
| Packages resolved | 127 |
|---|---|
| Stale | 40 |
| Tree resolution | Complete |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
epa_get_ejscreen Get EJScreen Environmental Justice Indicators ~307
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.
| Name | Type | Req | Description |
|---|---|---|---|
| distance | number | – | Buffer radius around the point, in the given unit (default 1). The miles-equivalent must be 15 or less. |
| latitude | number | yes | Latitude in decimal degrees. |
| longitude | number | yes | Longitude in decimal degrees. |
| unit | string | – | Unit for distance. Kilometers are converted to miles (× 0.621371) before the request. |
| Name | Type | Req | Description |
|---|---|---|---|
| coverage | object | yes | Whether EJScreen data was available for the point. |
| dataSource | string | yes | Provenance and vintage of the data. |
| demographic | array | yes | EJScreen demographic indicators present for the area. Empty when out of coverage. |
| demographicIndex | object | – | EJScreen Demographic Index. Absent when out of coverage. |
| environmental | array | yes | EJScreen environmental indicators present for the area. Empty when out of coverage. |
| location | object | yes | 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. |
No examples provided.
epa_get_facility Get EPA Facility Compliance Profile ~102
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.
| Name | Type | Req | Description |
|---|---|---|---|
| registry_id | string | yes | EPA FRS Registry ID for the facility (obtained from epa_search_facilities) |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Formal enforcement actions on record |
| inspections | array | yes | Inspection history records |
| latitude | number | – | Latitude in decimal degrees |
| longitude | number | – | Longitude in decimal degrees |
| name | string | yes | Facility name |
| programs | object | yes | Program registration flags |
| registryId | string | yes | 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 |
No examples provided.
epa_get_tri_releases Get TRI Chemical Releases for Facility ~180
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.
| Name | Type | Req | Description |
|---|---|---|---|
| chemical_name | string | – | Optional filter to restrict results to a specific chemical (partial match, case-insensitive) |
| facility_id | string | yes | 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| facilityId | string | yes | 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 | yes | Per-chemical annual TRI release records for the queried facility |
No examples provided.
epa_search_facilities Search EPA Facilities ~361
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 |
| Name | Type | Req | Description |
|---|---|---|---|
| facilities | array | yes | 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 | yes | Total facilities matched before the limit was applied |
No examples provided.
epa_search_superfund Search Superfund Sites ~261
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | – | Recovery hint when no sites are found. Absent when sites are returned. |
| sites | array | yes | Matching Superfund sites |
| totalCount | number | yes | Number of sites returned (may be less than available if limit applied) |
No examples provided.
epa_search_tri_releases Search TRI Releases by Region ~199
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| cap | number | yes | The limit that was applied. |
| message | string | – | Recovery hint when no releases are found. Absent when releases are returned. |
| releases | array | yes | TRI release records for facilities in the queried state and filters |
| shown | number | yes | Number of release records returned. |
| state | string | yes | State queried |
| truncated | boolean | yes | True when the result list was capped at the limit — more records may exist. |
No examples provided.
epa_search_violations Search EPA Enforcement Cases ~286
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 |
| Name | Type | Req | Description |
|---|---|---|---|
| cases | array | yes | Matching enforcement cases |
| message | string | – | Recovery hint when no cases are found — echoes filters and suggests broadening. Absent when cases are returned. |
| totalCount | number | yes | Total cases matched before the limit was applied |
No examples provided.
epa_search_water_systems Search Drinking Water Systems ~188
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | – | Recovery hint when no systems are found. Absent when systems are returned. |
| systems | array | yes | Matching public water systems |
| totalCount | number | yes | Number of systems returned |
No examples provided.