{"report":{"v":1,"package":"@cyanheads/epa-mcp-server","version":"0.8.1","ranAt":"2026-11-16T11:45:19.532Z","install":{"ok":true,"integrity":"sha512-Q/VTaYUxiukojCFUxdsjNEx338Ka0CaW5Np+Jfk5frwa1MflY0Zm12J/S1pit20m1qfyMAx4vj07Oo6qgpoiDg==","deps":36,"scripts":[],"bins":["epa-mcp-server"],"license":"Apache-2.0","engines":"node >=24.0.0","repository":"git+https://github.com/cyanheads/epa-mcp-server.git","bin":"epa-mcp-server"},"start":{"ok":true,"ms":440,"serverName":"epa-mcp-server","serverVersion":"0.8.1","protocol":"2025-06-18","stderr":":\"no_geographic_filter\",\"recovery\":{\"hint\":\"Provide at least one of state or zip_code to search drinking water systems.\"},\"originalErrorName\":\"McpError\",\"originalMessage\":\"At least one of state or zip_code is required.\"},\"stack\":\"McpError: At least one of state or zip_code is required.\\n    at Object.handler (file:///app/node_modules/@cyanheads/epa-mcp-server/dist/mcp-server/tools/definitions/water-search-systems.tool.js:141:23)\\n    at measureToolExecution (file:///app/node_modules/@cyanheads/mcp-ts-core/dist/mcp-server/tools/utils/toolHandlerFactory.js:84:53)\\n    at file:///app/node_modules/@cyanheads/mcp-ts-core/dist/utils/internal/performance.js:197:34\\n    at NoopContextManager.with (file:///app/node_modules/@opentelemetry/api/dist/context/NoopContextManager.mjs:8:13)\\n    at ContextAPI.with (file:///app/node_modules/@opentelemetry/api/dist/api/context.mjs:46:40)\\n    at NoopTracer.startActiveSpan (file:///app/node_modules/@opentelemetry/api/dist/trace/NoopTracer.mjs:35:25)\\n    at ProxyTracer.startActiveSpan (file:///app/node_modules/@opentelemetry/api/dist/trace/ProxyTracer.mjs:21:18)\\n    at measure (file:///app/node_modules/@cyanheads/mcp-ts-core/dist/utils/internal/performance.js:166:25)\\n    at measureToolExecution (file:///app/node_modules/@cyanheads/mcp-ts-core/dist/utils/internal/performance.js:305:18)\\n    at file:///app/node_modules/@cyanheads/mcp-ts-core/dist/mcp-server/tools/utils/toolHandlerFactory.js:79:26\",\"jsonRpcId\":6,\"toolName\":\"epa_water_search_systems\",\"msg\":\"Error in tool:epa_water_search_systems: At least one of state or zip_code is required.\"}\n"},"tools":[{"name":"epa_echo_search_facilities","description":"ECHO: Search EPA-regulated facilities by location, county, facility name, NAICS industry code, environmental program, or compliance status across CAA, CWA, RCRA, TRI, and SDWA. Returns facility name, EPA Registry ID, coordinates, county FIPS code, per-program registration flags, TRI facility IDs, five-year inspection and penalty totals, and TRI release totals. Registry IDs returned here feed epa_echo_get_facility; TRI facility IDs feed epa_tri_get_facility_releases. Supports proximity search via latitude + longitude + radius_miles, whose rows add distanceMiles from that point. At least one geographic filter (zip_code, state, city, county_fips, or a complete latitude+longitude+radius_miles triple) is required — unscoped searches time out. Page past limit with offset and nextOffset.","params":["zip_code","state","city","county","county_fips","facility_name","naics","latitude","longitude","radius_miles","active_only","programs","has_violation","limit","offset"]},{"name":"epa_echo_get_facility","description":"ECHO: Retrieve a full compliance profile for a single EPA-regulated facility by EPA Registry ID or EPA program ID. Returns facility metadata, the NAICS industry codes its programs record, ECHO's facility-level compliance status, a per-statute (CAA, CWA, RCRA, SDWA, and others ECHO tracks) compliance summary, inspections and other compliance monitoring records from the last five years (newest first, paged), five years of formal enforcement actions with penalties, five years of drinking-water violations with contaminant, measure, MCL, status, and enforcement actions (paged), Clean Water Act effluent limit exceedances by pollutant and outfall and RCRA violations (both paged), Clean Air Act High Priority Violations, every program ID linked to the facility, the latest TRI release total, and the facility's TRI facility IDs for epa_tri_get_facility_releases. Use epa_echo_search_facilities to discover Registry IDs; pass a public water system's PWSID from epa_water_search_systems to get its drinking-water violations. For area-level enforcement discovery use epa_echo_search_violations instead.","params":["registry_id","drinking_water_violations_limit","drinking_water_violations_offset","inspections_limit","inspections_offset","effluent_exceedances_limit","effluent_exceedances_offset","rcra_violations_limit","rcra_violations_offset"]},{"name":"epa_echo_search_violations","description":"ECHO: Search EPA civil and criminal enforcement cases by state, ZIP code, regulatory program, case type, or filing-date range. Returns case identifier, case type and status, lead agency (EPA or state), primary law and section, enforcement outcome, federal and state penalties, cost recovery, compliance action and SEP costs, and filing, settlement, and closing dates. Case rows name no facility: pass a civil caseId to epa_echo_get_case for the facilities, defendants, and settlements behind it. Designed for area-level violation discovery — for a single known facility's enforcement history use epa_echo_get_facility instead. At least one of state or zip_code is required. Page past limit with offset and nextOffset.","params":["state","zip_code","program","case_type","date_filed_start","date_filed_end","limit","offset"]},{"name":"epa_echo_get_case","description":"ECHO: Retrieve one civil enforcement case by case number, with the facilities, defendants, and settlements behind it. Returns the case's category, enforcement type, status, lead agency, relief sought, outcome, court and DOJ docket numbers, summary, and penalty, cost-recovery, compliance-action, and SEP totals; the laws and sections cited; the facilities the case names, one per EPA Registry ID, with address, NAICS and SIC codes, and the program IDs the case links (pass a registryId to epa_echo_get_facility for its compliance profile); defendants; pollutants; milestones; and the enforcement conclusions (orders, consent decrees, or other settlements), each with its facilities, dates, penalties and costs, complying actions, pollutant reductions, and Supplemental Environmental Projects. Facilities and enforcement conclusions come a page at a time and everything else whole on every page; each call re-reads the whole case report, so one call with a larger limit costs less than several pages. Take the case number from epa_echo_search_violations or from a formal action's caseId in epa_echo_get_facility. Civil cases only: a criminal CR_ case number fails before any request.","params":["case_id","facilities_limit","facilities_offset","enforcement_conclusions_limit","enforcement_conclusions_offset"]},{"name":"epa_tri_get_facility_releases","description":"TRI: Query Toxic Release Inventory annual chemical release data for a specific facility. Returns per-chemical release records with chemical name, TRI chemical ID and CAS number, reporting year, on-site releases by medium (air, water, land, underground injection) and their total, and the Form R one-time release quantity, newest reporting year first; page through them with offset and nextOffset. Quantities are in pounds; dioxin and dioxin-like compounds, which TRI has facilities report in grams, are converted and marked with reportedUnit. TRI data lags ~18 months — the most recent available year is typically 2 years prior to the current calendar year. facility_id is the 15-character TRI facility ID: take it from the facilityId field of epa_tri_search_releases, or from the triFacilityIds of epa_echo_get_facility for a facility you already hold a Registry ID for. A 12-digit EPA Registry ID is a different identifier and fails validation.","params":["facility_id","year","chemical_name","chemical_id","limit","offset"]},{"name":"epa_tri_search_releases","description":"TRI: Search Toxic Release Inventory data across facilities in a state or county, for one reporting year or, without year, every available year newest first. Returns facility name and county, TRI facility ID, EPA Registry ID (the registry_id epa_echo_get_facility takes), parent company, chemical name and TRI chemical ID with its CAS number, and the Form R one-time release quantity; set include_release_breakdown to add on-site releases by medium (air, water, land, and underground-injection) and their total, at the cost of a slower call. Quantities are in pounds; dioxin and dioxin-like compounds, which TRI has facilities report in grams, are converted and marked with reportedUnit. Records come in reporting-year order, not ranked by quantity; page through a large match with offset and nextOffset. Use to build an environmental exposure profile for an area. Use epa_tri_get_facility_releases for detailed release records for a single facility. TRI data lags ~18 months from the current calendar year.","params":["state","county","year","chemical_name","chemical_id","limit","offset","include_release_breakdown"]},{"name":"epa_superfund_search_sites","description":"Superfund: Search Superfund (CERCLA/SEMS) sites by location, site name, or NPL listing status. Returns site identifiers, source NPL status labels, non-NPL assessment and archive metadata when available, coordinates, and county FIPS code. A state, city, ZIP, or name search returns sites in SEMS site ID order; latitude+longitude+radius returns them nearest first with each site's distanceMiles, and name narrows either. Page through a large match with offset and nextOffset. Proximity searches match only sites with usable coordinates and share a 50-second deadline; narrow the radius or add filters if the search times out. Use epa_superfund_get_site with a returned siteId for contaminant associations.","params":["state","city","name","zip_code","latitude","longitude","radius_miles","npl_status","exclude_archived","limit","offset"]},{"name":"epa_superfund_get_site","description":"Superfund: Retrieve a site by exact SEMS site ID from epa_superfund_search_sites or by EPA ID, the SEMS program ID epa_echo_get_case lists, with all recorded contaminant associations and their media, operable units, and EPA actions. Repeated chemicals in different contexts and duplicate source rows are retained. An existing site without contaminant records returns an empty array. Associations do not establish current exposure, concentrations, or current risk. Site and contaminant requests share a 50-second deadline.","params":["site_id"]},{"name":"epa_water_search_systems","description":"Drinking water (SDWIS): Search public water systems by state, ZIP code, or county served. Returns system name, PWSID, population served, primary water source, and activity status, in PWSID order; page through a large match with offset and nextOffset. zip_code matches a system's address of record, often an owner's or operator's office far from the area it serves; county (with state) finds the systems serving an area. With has_violation, returns only systems with a current SDWA violation in EPA's ECHO, which applies EPA's Enforcement Response Policy, so it flags fewer systems than SDWIS's unresolved violation records. At least one of state or zip_code is required. Pass a returned pwsid as registry_id to epa_echo_get_facility for the system's drinking-water violations: contaminant, measured level, MCL, status, and enforcement actions.","params":["state","zip_code","county","has_violation","pws_type","active_only","limit","offset"]},{"name":"epa_ejscreen_get_scores","description":"EJScreen: 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 and their national averages. Data is EJAM's ACS 2018–2022 release of EJScreen (EJScreen 2.3 method), 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). When EJScreen has no indicators — the point is outside its US bounds, the buffer holds no Census block, or its blocks have no residents — coverage.valid is false and coverage.note says which, and whether a larger distance may help.","params":["latitude","longitude","distance","unit"]}],"toolsHash":"6368653ca9cc5f9a15deb07b2d45c5b716bec1a669105431aa770b1170bf607a","wrote":[],"callsAt":"2026-11-16T11:45:30.994Z","calls":[{"tool":"epa_echo_search_facilities","ok":false,"ms":12,"bytes":0,"error":"tool reported an error: Error: At least one geographic filter (zip_code, state, city, county_fips, or a latitude+longitude+radius_miles triple) is required.\n\nRecovery: Provide at least one of zip_code, state, city, or county"},{"tool":"epa_echo_search_violations","ok":false,"ms":5,"bytes":0,"error":"tool reported an error: Error: At least one of state or zip_code is required to search enforcement cases.\n\nRecovery: Provide at least one of state or zip_code to scope the enforcement case search.\n\n(reason no_geographic_filt"},{"tool":"epa_superfund_search_sites","ok":false,"ms":3,"bytes":0,"error":"tool reported an error: Error: At least one of state, city, zip_code, name, or latitude+longitude is required to search Superfund sites.\n\nRecovery: Provide at least one of state, city, zip_code, name, or latitude+longitude+r"},{"tool":"epa_water_search_systems","ok":false,"ms":3,"bytes":0,"error":"tool reported an error: Error: At least one of state or zip_code is required.\n\nRecovery: Provide at least one of state or zip_code to search drinking water systems.\n\n(reason no_geographic_filter · request TT3KO-C8LX7)"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":10,"wrote":0,"callsTried":4,"callsAnswered":0,"callContacts":[]},"history":[{"package":"@cyanheads/epa-mcp-server","version":"0.8.1","ranAt":"2026-11-16T11:45:19.532Z","outcome":"started","tools":10,"contacts":0,"flags":0,"serious":0,"toolsHash":"6368653ca9cc5f9a15deb07b2d45c5b716bec1a669105431aa770b1170bf607a"},{"package":"@cyanheads/epa-mcp-server","version":"0.8.0","ranAt":"2026-11-12T18:00:07.829Z","outcome":"started","tools":10,"contacts":0,"flags":0,"serious":0,"toolsHash":"2d7115fd066b2f767e9d5e391b0312db4973334b47be8679eddb983ef6116940"}],"page":"https://bragproof.smaverk.com/r/%40cyanheads/epa-mcp-server"}