Skip to main content
Glama

Get EPA Facility Compliance Profile

epa_echo_get_facility
Read-onlyIdempotent

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.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "registry_id": "<registry_id>"
    },
    "name": "epa_echo_get_facility"
  }
}

Input Schema

NameRequiredDescriptionDefault
registry_idYesEPA FRS Registry ID for the facility (from epa_echo_search_facilities), or an EPA program ID ECHO resolves to one: a public water system PWSID (from epa_water_search_systems, e.g. WA5300484), a TRI facility ID, an NPDES permit, or a RCRA handler ID. The profile carries the resolved registryId.
inspections_limitNoNumber of inspections to return in one call. Default 25; a larger value returns at most 5,000 and says so. Page past it with inspections_offset and inspectionsNextOffset.
inspections_offsetNoNumber of inspections to skip before this page (default 0). Pass the previous call's inspectionsNextOffset to continue; a value past the end returns an empty page.
rcra_violations_limitNoNumber of RCRA violations to return in one call. Default 25; a larger value returns the rest of the list. Page past it with rcra_violations_offset and rcraViolationsNextOffset.
rcra_violations_offsetNoNumber of RCRA violations to skip before this page (default 0). Pass the previous call's rcraViolationsNextOffset to continue; a value past the end returns an empty page.
effluent_exceedances_limitNoNumber of effluent exceedance series to return in one call. Default 10; a larger value returns the rest of the list. Page past it with effluent_exceedances_offset and effluentExceedancesNextOffset.
effluent_exceedances_offsetNoNumber of effluent exceedance series to skip before this page (default 0). Pass the previous call's effluentExceedancesNextOffset to continue; a value past the end returns an empty page.
drinking_water_violations_limitNoNumber of drinking-water violations to return in one call. Default 25; a larger value returns at most 3,000 and says so. Page past it with drinking_water_violations_offset and drinkingWaterViolationsNextOffset.
drinking_water_violations_offsetNoNumber of drinking-water violations to skip before this page (default 0). Pass the previous call's drinkingWaterViolationsNextOffset to continue; a value past the end returns an empty page.

Output Schema

NameRequiredDescriptionDefault
zipNoZIP code
cityNoCity
nameNoFacility name
errorNoPresent when the call failed. Absent on success.
naicsNoFrom the program records, each code once, ascending; programs can differ
stateNoState code
countyNoCounty name
noticeNoPresent when ECHO's facility search failed, leaving out complianceStatus and compliance.
streetNoStreet address
fipsCodeNo5-digit county FIPS code
latitudeNoDecimal degrees
programsNoFrom the systems in the facility's detailed report
longitudeNoDecimal degrees
truncatedNoTrue when inspections, drinkingWaterViolations, effluentExceedances, or rcraViolations has more pages; absent otherwise.
complianceNoFrom ECHO's facility search; absent when it reports none or fails
programIdsNoFRS-linked program IDs besides the Registry ID, ECHO's order
registryIdNoFRS Registry ID
inspectionsNoInspections and other compliance monitoring, 5-year window, newest first
limitNoticeNoPresent when a smaller limit than requested applied; says why.
airComplianceNoPresent only when programs.air is true and ECHO reports a CAA status
formalActionsNo5-year window, newest first
rcraViolationsNo12-quarter window, newest determination first
triFacilityIdsNo15-character IDs, most recently reported first; pass one as facility_id to epa_tri_get_facility_releases. Several mean successive operators.
waterComplianceNoPresent only when programs.water is true and ECHO reports a CWA status
complianceStatusNoFacility-level status; absent when ECHO assigns none (as for TRI-only facilities) or its facility search failed (see notice)
inspectionsTotalNoAcross every page
programComplianceNoPer-statute summary; empty outside compliance-tracked programs, as for TRI-only facilities
effluentExceedancesNoCWA effluent limit exceedances, 13-quarter window, one per permit, outfall, parameter, location, and measurement type, in that order
rcraViolationsTotalNoAcross every page
inspectionsNextOffsetNoNext inspections_offset; absent on the last page
highPriorityViolationsNoCAA High Priority Violations, 12-quarter window
drinkingWaterViolationsNoECHO's 5-year SDWIS report for a public water system, newest compliance period first
effluentExceedancesTotalNoAcross every page
rcraViolationsNextOffsetNoNext rcra_violations_offset; absent on the last page
triReleasesTransfersYearNoECHO's latest TRI year for the facility
triReleasesTransfersInLbsNoTRI releases and transfers in pounds for triReleasesTransfersYear; absent without TRI history
drinkingWaterViolationsTotalNoAcross every page
effluentExceedancesNextOffsetNoNext effluent_exceedances_offset; absent on the last page
drinkingWaterViolationsNextOffsetNoNext drinking_water_violations_offset; absent on the last page

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed106 schema fields changed
    • changedInput schema / properties / drinking_water_violations_limit / default
      Previous value: -50New value: +25
    • changedInput schema / properties / drinking_water_violations_limit / description
      Previous value: -"Maximum number of drinking-water violations to return in one call (1–200, default 50). A larger value, up to 5,000, returns 200 with a notice. Page past it with drinking_water_violations_offset and drinkingWaterViolationsNextOffset."New value: +"Number of drinking-water violations to return in one call. Default 25; a larger value returns at most 3,000 and says so. Page past it with drinking_water_violations_offset and drinkingWaterViolationsNextOffset."
    • changedInput schema / properties / drinking_water_violations_limit / maximum
      Previous value: -5000New value: +9007199254740991
    • addedInput schema / properties / effluent_exceedances_limit
      Added value: +{
      +  "default": 10,
      +  "description": "Number of effluent exceedance series to return in one call. Default 10; a larger value returns the rest of the list. Page past it with effluent_exceedances_offset and effluentExceedancesNextOffset.",
      +  "maximum": 9007199254740991,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / effluent_exceedances_offset
      Added value: +{
      +  "default": 0,
      +  "description": "Number of effluent exceedance series to skip before this page (default 0). Pass the previous call's effluentExceedancesNextOffset to continue; a value past the end returns an empty page.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedInput schema / properties / inspections_limit / default
      Previous value: -100New value: +25
    • changedInput schema / properties / inspections_limit / description
      Previous value: -"Maximum number of inspections to return in one call (1–100, default 100). A larger value, up to 5,000, returns 100 with a notice. Page past it with inspections_offset and inspectionsNextOffset."New value: +"Number of inspections to return in one call. Default 25; a larger value returns at most 5,000 and says so. Page past it with inspections_offset and inspectionsNextOffset."
    • changedInput schema / properties / inspections_limit / maximum
      Previous value: -5000New value: +9007199254740991
    • addedInput schema / properties / rcra_violations_limit
      Added value: +{
      +  "default": 25,
      +  "description": "Number of RCRA violations to return in one call. Default 25; a larger value returns the rest of the list. Page past it with rcra_violations_offset and rcraViolationsNextOffset.",
      +  "maximum": 9007199254740991,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / rcra_violations_offset
      Added value: +{
      +  "default": 0,
      +  "description": "Number of RCRA violations to skip before this page (default 0). Pass the previous call's rcraViolationsNextOffset to continue; a value past the end returns an empty page.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "not": {
      -      "required": [
      -        "error"
      -      ]
      -    },
      -    "required": [
      -      "registryId",
      -      "name",
      -      "programs",
      -      "triFacilityIds",
      -      "naics",
      -      "programCompliance",
      -      "inspections",
      -      "inspectionsTotal",
      -      "drinkingWaterViolations",
      -      "drinkingWaterViolationsTotal",
      -      "formalActions"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "error"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "not": {
      +      "required": [
      +        "error"
      +      ]
      +    },
      +    "required": [
      +      "registryId",
      +      "name",
      +      "programs",
      +      "triFacilityIds",
      +      "naics",
      +      "programCompliance",
      +      "inspections",
      +      "inspectionsTotal",
      +      "drinkingWaterViolations",
      +      "drinkingWaterViolationsTotal",
      +      "formalActions",
      +      "effluentExceedances",
      +      "effluentExceedancesTotal",
      +      "rcraViolations",
      +      "rcraViolationsTotal",
      +      "highPriorityViolations",
      +      "programIds"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "error"
      +    ]
      +  }
      +]
    • changedOutput schema / properties / airCompliance / description
      Previous value: -"Clean Air Act status. Present only when programs.air is true and ECHO reports a CAA status."New value: +"Present only when programs.air is true and ECHO reports a CAA status"
    • changedOutput schema / properties / airCompliance / properties / programId / description
      Previous value: -"ICIS-Air ID when the facility has exactly one; absent when it has several"New value: +"ICIS-Air ID if exactly one; absent when several (see programIds)"
    • changedOutput schema / properties / airCompliance / properties / status / description
      Previous value: -"Current Clean Air Act compliance status"New value: +"Current CAA status"
    • changedOutput schema / properties / airCompliance / properties / statusDate / description
      Previous value: -"End of the latest quarter the status covers (MM/DD/YYYY)"New value: +"End of the latest quarter covered, MM/DD/YYYY"
    • changedOutput schema / properties / compliance / description
      Previous value: -"Facility-level noncompliance count from ECHO's facility search record. Absent when ECHO reports none or the facility search request fails."New value: +"From ECHO's facility search; absent when it reports none or fails"
    • changedOutput schema / properties / compliance / properties / quartersInViolation / description
      Previous value: -"Quarters (of the last 12) in which any program found the facility in noncompliance"New value: +"Of the last 12, with noncompliance under any program"
    • changedOutput schema / properties / complianceStatus / description
      Previous value: -"ECHO's facility-level compliance status, the same value epa_echo_search_facilities returns (e.g. \"Significant Violation\"). Absent when ECHO assigns none, as for TRI-only facilities, or when ECHO's facility search request fails (the notice field then says so)."New value: +"Facility-level status; absent when ECHO assigns none (as for TRI-only facilities) or its facility search failed (see notice)"
    • changedOutput schema / properties / drinkingWaterViolations / description
      Previous value: -"Drinking-water (SDWIS) violations in ECHO's 5-year report for a public water system, newest compliance period first: one page of drinking_water_violations_limit entries from drinking_water_violations_offset. Empty for a facility with no SDWIS record."New value: +"ECHO's 5-year SDWIS report for a public water system, newest compliance period first"
    • changedOutput schema / properties / drinkingWaterViolations / items / description
      Previous value: -"Single drinking-water violation; fields ECHO leaves empty are absent, never defaulted"New value: +"One violation; empty fields absent, never defaulted"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / compliancePeriodBeginDate / description
      Previous value: -"Start of the compliance period (MM/DD/YYYY)"New value: +"MM/DD/YYYY"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / compliancePeriodEndDate / description
      Previous value: -"End of the compliance period (MM/DD/YYYY); absent when ECHO records none, as for an open period"New value: +"MM/DD/YYYY; absent for an open period"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / contaminantName / description
      Previous value: -"Contaminant or rule group, e.g. \"TTHM\", \"Arsenic\", \"Lead and Copper Rule\""New value: +"Contaminant or rule group"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / enforcementActions / description
      Previous value: -"Enforcement actions ECHO links to the violation; absent when it lists none"New value: +"Linked enforcement actions; absent when none"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / enforcementActions / items / description
      Previous value: -"Enforcement action ECHO links to the violation"New value: +"One action"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / enforcementActions / items / properties / agency / description
      Previous value: -"Agency that took it, e.g. State, EPA"New value: +"Agency that took it"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / enforcementActions / items / properties / date / description
      Previous value: -"Action date (MM/DD/YYYY)"New value: +"MM/DD/YYYY"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / enforcementActions / items / properties / description / description
      Previous value: -"Action, e.g. \"State Administrative/Compliance Order without penalty issued\""New value: +"Action"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / enforcementActions / items / properties / type / description
      Previous value: -"Action type: \"Formal\", \"Informal\", or \"Resolving\""New value: +"\"Formal\", \"Informal\", or \"Resolving\""
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / federalMcl / description
      Previous value: -"Federal maximum contaminant level as ECHO writes it, units included (e.g. \"0.080 mg/L\")"New value: +"Federal MCL, units included"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / federalRule / description
      Previous value: -"Federal rule violated, e.g. \"Lead and Copper Rule\", \"Stage 2 Disinfectants and Disinfection Byproducts Rule\""New value: +"Federal rule violated"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / resolvedDate / description
      Previous value: -"Date ECHO records the violation as resolved (MM/DD/YYYY)"New value: +"MM/DD/YYYY"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / sourceId / description
      Previous value: -"Public water system ID (PWSID) the violation is recorded against"New value: +"PWSID recorded against"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / stateMcl / description
      Previous value: -"State maximum contaminant level as ECHO writes it, units included"New value: +"State MCL, units included"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / status / description
      Previous value: -"ECHO's violation status: Resolved, Archived (no longer counts toward the system's current compliance status; an Archived entry can still carry a resolvedDate), Addressed (not resolved, with formal enforcement), or Unaddressed (not resolved, no formal enforcement)"New value: +"Resolved; Archived (no longer counts toward current compliance, can still carry resolvedDate); Addressed (unresolved, formal enforcement); Unaddressed (unresolved, none)"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / violationCategory / description
      Previous value: -"Violation category, e.g. \"Maximum Contaminant Level Violation\""New value: +"Category name"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / violationCategoryCode / description
      Previous value: -"Violation category code, e.g. MCL (maximum contaminant level), MR (monitoring and reporting), MON (monitoring), TT (treatment technique)"New value: +"Code that violationCategory names"
    • changedOutput schema / properties / drinkingWaterViolations / items / properties / violationMeasure / description
      Previous value: -"Measured level as ECHO writes it, units included (e.g. \"148.37 UG/L\"); absent when ECHO records none, as for monitoring violations"New value: +"Measured level, units included; absent when unrecorded, as for monitoring violations"
    • changedOutput schema / properties / drinkingWaterViolationsNextOffset / description
      Previous value: -"Offset of the next page of drinkingWaterViolations: present exactly when more follow, absent on the last page. Pass it as drinking_water_violations_offset."New value: +"Next drinking_water_violations_offset; absent on the last page"
    • changedOutput schema / properties / drinkingWaterViolationsTotal / description
      Previous value: -"Drinking-water violations in ECHO's report for this facility, across every page; 0 when it has no SDWIS record"New value: +"Across every page"
    • addedOutput schema / properties / effluentExceedances
      Added value: +{
      +  "description": "CWA effluent limit exceedances, 13-quarter window, one per permit, outfall, parameter, location, and measurement type, in that order",
      +  "items": {
      +    "additionalProperties": false,
      +    "description": "One series; empty fields absent",
      +    "properties": {
      +      "measurementType": {
      +        "description": "Mthly: monthly-average limit; NMth: non-monthly, usually a maximum; Neither: another kind",
      +        "type": "string"
      +      },
      +      "monitoringLocation": {
      +        "description": "Where it is measured",
      +        "type": "string"
      +      },
      +      "outfall": {
      +        "description": "Outfall code",
      +        "type": "string"
      +      },
      +      "parameterCode": {
      +        "description": "5-digit NPDES code",
      +        "type": "string"
      +      },
      +      "parameterName": {
      +        "description": "Pollutant name",
      +        "type": "string"
      +      },
      +      "permitId": {
      +        "description": "NPDES permit ID",
      +        "type": "string"
      +      },
      +      "quarters": {
      +        "description": "Quarters with an exceedance, oldest first",
      +        "items": {
      +          "additionalProperties": false,
      +          "description": "One quarter; omitted dates absent",
      +          "properties": {
      +            "end": {
      +              "description": "MM/DD/YYYY; the 13th ends at ECHO's last refresh",
      +              "type": "string"
      +            },
      +            "start": {
      +              "description": "MM/DD/YYYY",
      +              "type": "string"
      +            },
      +            "status": {
      +              "description": "ECHO's code, S or R; absent when unsent",
      +              "type": "string"
      +            },
      +            "value": {
      +              "description": "Highest percent over the limit as ECHO writes it, or LIMIT VIOLATION where that percent is not representative",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "value"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "quarters"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / effluentExceedancesNextOffset
      Added value: +{
      +  "description": "Next effluent_exceedances_offset; absent on the last page",
      +  "type": "number"
      +}
    • addedOutput schema / properties / effluentExceedancesTotal
      Added value: +{
      +  "description": "Across every page",
      +  "type": "number"
      +}
    • changedOutput schema / properties / error / properties / data / properties / reason / description
      Previous value: -"Machine-readable failure mode. Declared by this tool: `facility_not_found`: ECHO has no facility for the given Registry ID or program ID. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `facility_not_found`: ECHO has no facility for registry_id. Other values are possible when a failure originates below the handler."
    • changedOutput schema / properties / formalActions / description
      Previous value: -"Formal enforcement actions over the 5-year window, newest first"New value: +"5-year window, newest first"
    • changedOutput schema / properties / formalActions / items / description
      Previous value: -"Single formal enforcement action"New value: +"One formal action"
    • changedOutput schema / properties / formalActions / items / properties / actionDate / description
      Previous value: -"Date of the action (MM/DD/YYYY)"New value: +"MM/DD/YYYY"
    • changedOutput schema / properties / formalActions / items / properties / actionType / description
      Previous value: -"Type of formal enforcement action, e.g. \"Administrative Order\""New value: +"Action type"
    • changedOutput schema / properties / formalActions / items / properties / caseId / description
      Previous value: -"Enforcement case identifier; pass it to epa_echo_get_case for the civil case report (facilities, defendants, conclusions). Absent when ECHO records the action without one, as for RCRA and SDWA actions"New value: +"Pass to epa_echo_get_case for the civil case report; absent when none, as for RCRA and SDWA actions"
    • changedOutput schema / properties / formalActions / items / properties / leadAgency / description
      Previous value: -"Lead agency: EPA, State, or Local"New value: +"EPA, State, or Local"
    • changedOutput schema / properties / formalActions / items / properties / penaltyAssessedInDollars / description
      Previous value: -"Penalty amount assessed in dollars"New value: +"In dollars"
    • changedOutput schema / properties / formalActions / items / properties / settlementDate / description
      Previous value: -"Settlement date of the enforcement case (MM/DD/YYYY)"New value: +"Case settlement, MM/DD/YYYY"
    • changedOutput schema / properties / formalActions / items / properties / sourceId / description
      Previous value: -"Program ID the action concerns"New value: +"Program ID concerned"
    • changedOutput schema / properties / formalActions / items / properties / statute / description
      Previous value: -"Statute the action was under"New value: +"Statute"
    • addedOutput schema / properties / highPriorityViolations
      Added value: +{
      +  "description": "CAA High Priority Violations, 12-quarter window",
      +  "items": {
      +    "additionalProperties": false,
      +    "description": "One violation; empty fields absent",
      +    "properties": {
      +      "agency": {
      +        "description": "State code or EPA",
      +        "type": "string"
      +      },
      +      "airProgramId": {
      +        "description": "ICIS-Air ID",
      +        "type": "string"
      +      },
      +      "beginDate": {
      +        "description": "MM/DD/YYYY; can precede the window",
      +        "type": "string"
      +      },
      +      "pollutants": {
      +        "description": "Comma-separated",
      +        "type": "string"
      +      },
      +      "programs": {
      +        "description": "Air program codes, comma-separated",
      +        "type": "string"
      +      },
      +      "resolvedDate": {
      +        "description": "MM/DD/YYYY; absent while unresolved",
      +        "type": "string"
      +      },
      +      "violationId": {
      +        "description": "ICIS-Air activity ID",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / inspections / description
      Previous value: -"Inspections, evaluations, investigations, and other compliance monitoring records over the 5-year window, newest first: one page of inspections_limit entries from inspections_offset."New value: +"Inspections and other compliance monitoring, 5-year window, newest first"
    • changedOutput schema / properties / inspections / items / description
      Previous value: -"Single inspection or other compliance monitoring record"New value: +"One monitoring record"
    • changedOutput schema / properties / inspections / items / properties / activityDate / description
      Previous value: -"Date of the record (MM/DD/YYYY)"New value: +"MM/DD/YYYY"
    • changedOutput schema / properties / inspections / items / properties / activityType / description
      Previous value: -"Inspection or evaluation type, e.g. \"FCE On-Site\", \"PCE Stack Test\", \"Compliance Evaluation Inspection\""New value: +"Inspection or evaluation type"
    • changedOutput schema / properties / inspections / items / properties / category / description
      Previous value: -"Kind of record, e.g. \"Inspection/Evaluation\", \"Compliance Investigation\", \"Information Request\", \"Offsite Record Review\"; absent for RCRA and SDWA records"New value: +"Kind of record; absent for RCRA and SDWA records"
    • changedOutput schema / properties / inspections / items / properties / description / description
      Previous value: -"Finding ECHO records for the inspection, when it records one"New value: +"Finding, if recorded"
    • changedOutput schema / properties / inspections / items / properties / leadAgency / description
      Previous value: -"Lead agency: EPA, State, or Local"New value: +"EPA, State, or Local"
    • changedOutput schema / properties / inspections / items / properties / sourceId / description
      Previous value: -"Program ID inspected, e.g. an ICIS-Air ID, NPDES permit, RCRA handler ID, or public water system ID"New value: +"Program ID inspected"
    • changedOutput schema / properties / inspections / items / properties / statute / description
      Previous value: -"Statute the record was under"New value: +"Statute"
    • changedOutput schema / properties / inspectionsNextOffset / description
      Previous value: -"Offset of the next page of inspections: present exactly when more follow, absent on the last page. Pass it as inspections_offset."New value: +"Next inspections_offset; absent on the last page"
    • changedOutput schema / properties / inspectionsTotal / description
      Previous value: -"Compliance monitoring records in ECHO's 5-year history for this facility, across every page"New value: +"Across every page"
    • changedOutput schema / properties / latitude / description
      Previous value: -"Latitude in decimal degrees"New value: +"Decimal degrees"
    • changedOutput schema / properties / limitNotice / description
      Previous value: -"Present when limit was above the cap and the call returned the cap instead."New value: +"Present when a smaller limit than requested applied; says why."
    • changedOutput schema / properties / longitude / description
      Previous value: -"Longitude in decimal degrees"New value: +"Decimal degrees"
    • changedOutput schema / properties / naics / description
      Previous value: -"NAICS industry codes the facility's program records carry, each code once, ascending by code. Programs can record different codes for one site. Empty when no program records one."New value: +"From the program records, each code once, ascending; programs can differ"
    • changedOutput schema / properties / naics / items / properties / code / description
      Previous value: -"NAICS code, 2–6 digits, e.g. \"331110\""New value: +"2–6 digits"
    • changedOutput schema / properties / naics / items / properties / description / description
      Previous value: -"NAICS title as ECHO records it, e.g. \"Iron and Steel Mills and Ferroalloy Manufacturing\""New value: +"Title as ECHO records it"
    • changedOutput schema / properties / notice / description
      Previous value: -"Present when ECHO's facility search request failed, so complianceStatus and compliance are missing; every other field comes from the facility's detailed report."New value: +"Present when ECHO's facility search failed, leaving out complianceStatus and compliance."
    • changedOutput schema / properties / programCompliance / description
      Previous value: -"ECHO's per-statute enforcement and compliance summary. Empty when the facility is in no compliance-tracked program, as for TRI-only facilities."New value: +"Per-statute summary; empty outside compliance-tracked programs, as for TRI-only facilities"
    • changedOutput schema / properties / programCompliance / items / description
      Previous value: -"One statute's enforcement and compliance summary"New value: +"One statute's summary"
    • changedOutput schema / properties / programCompliance / items / properties / currentStatus / description
      Previous value: -"Current compliance status under this statute, e.g. \"No Violation Identified\""New value: +"Current status"
    • changedOutput schema / properties / programCompliance / items / properties / fiveYearPeriodStart / description
      Previous value: -"Start of the 5-year window (MM/DD/YYYY)"New value: +"MM/DD/YYYY"
    • changedOutput schema / properties / programCompliance / items / properties / formalActions / description
      Previous value: -"Formal enforcement actions over the 5-year window"New value: +"5-year window"
    • changedOutput schema / properties / programCompliance / items / properties / informalActions / description
      Previous value: -"Informal enforcement actions over the 5-year window"New value: +"5-year window"
    • changedOutput schema / properties / programCompliance / items / properties / inspections / description
      Previous value: -"Inspections or full compliance evaluations over the 5-year window"New value: +"Inspections or full evaluations, 5-year window"
    • changedOutput schema / properties / programCompliance / items / properties / lastInspectionDate / description
      Previous value: -"Date of the latest inspection (MM/DD/YYYY)"New value: +"MM/DD/YYYY"
    • changedOutput schema / properties / programCompliance / items / properties / periodEnd / description
      Previous value: -"End of both windows (MM/DD/YYYY)"New value: +"End of both windows, MM/DD/YYYY"
    • changedOutput schema / properties / programCompliance / items / properties / quartersInNoncompliance / description
      Previous value: -"Quarters in noncompliance over the 3-year window (of 12)"New value: +"Of 12, 3-year window"
    • changedOutput schema / properties / programCompliance / items / properties / quartersInSignificantNoncompliance / description
      Previous value: -"Quarters in significant noncompliance over the 3-year window (of 12)"New value: +"Of 12, 3-year window"
    • changedOutput schema / properties / programCompliance / items / properties / statute / description
      Previous value: -"Statute ECHO summarizes, e.g. CAA, CWA, RCRA, SDWA, TSCA, EPCRA"New value: +"Statute"
    • changedOutput schema / properties / programCompliance / items / properties / threeYearPeriodStart / description
      Previous value: -"Start of the 3-year window (MM/DD/YYYY)"New value: +"MM/DD/YYYY"
    • changedOutput schema / properties / programCompliance / items / properties / totalPenaltiesInDollars / description
      Previous value: -"Penalties from formal enforcement actions over the 5-year window, in dollars"New value: +"Formal-action penalties, 5-year window, in dollars"
    • addedOutput schema / properties / programIds
      Added value: +{
      +  "description": "FRS-linked program IDs besides the Registry ID, ECHO's order",
      +  "items": {
      +    "additionalProperties": false,
      +    "description": "One program ID; empty fields absent",
      +    "properties": {
      +      "expirationDate": {
      +        "description": "Permit expiration, MM/DD/YYYY",
      +        "type": "string"
      +      },
      +      "id": {
      +        "description": "Program ID",
      +        "type": "string"
      +      },
      +      "status": {
      +        "description": "Permit, operating, activity, or reporting status",
      +        "type": "string"
      +      },
      +      "statute": {
      +        "description": "Statute",
      +        "type": "string"
      +      },
      +      "system": {
      +        "description": "EPA data system, as ECHO names it",
      +        "type": "string"
      +      },
      +      "universe": {
      +        "description": "Classification within the system",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "system",
      +      "id"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / programs / description
      Previous value: -"Program registration flags, from the ECHO systems in the facility's detailed report"New value: +"From the systems in the facility's detailed report"
    • changedOutput schema / properties / programs / properties / air / description
      Previous value: -"Has an ICIS-Air record (Clean Air Act stationary-source compliance). Emissions-inventory, risk-management, and greenhouse-gas reporting entries alone do not count."New value: +"Has an ICIS-Air (CAA) record; emissions-inventory, risk-management, or greenhouse-gas entries alone do not count"
    • changedOutput schema / properties / programs / properties / rcra / description
      Previous value: -"Has an RCRAInfo record (RCRA hazardous waste handler)"New value: +"Has an RCRAInfo record"
    • changedOutput schema / properties / programs / properties / sdwa / description
      Previous value: -"Has an SDWIS record (Safe Drinking Water Act public water system)"New value: +"Has an SDWIS record"
    • changedOutput schema / properties / programs / properties / tri / description
      Previous value: -"Has a Toxics Release Inventory record — true exactly when triFacilityIds is non-empty"New value: +"True exactly when triFacilityIds is non-empty"
    • changedOutput schema / properties / programs / properties / water / description
      Previous value: -"Has an ICIS-NPDES record (Clean Water Act discharge permit)"New value: +"Has an ICIS-NPDES (CWA) record"
    • addedOutput schema / properties / rcraViolations
      Added value: +{
      +  "description": "12-quarter window, newest determination first",
      +  "items": {
      +    "additionalProperties": false,
      +    "description": "One violation; empty fields absent",
      +    "properties": {
      +      "agency": {
      +        "description": "State code or EPA",
      +        "type": "string"
      +      },
      +      "determinedDate": {
      +        "description": "MM/DD/YYYY; can precede the window",
      +        "type": "string"
      +      },
      +      "handlerId": {
      +        "description": "RCRA handler ID",
      +        "type": "string"
      +      },
      +      "reportUrl": {
      +        "description": "ECHO report URL",
      +        "type": "string"
      +      },
      +      "returnedToComplianceDate": {
      +        "description": "MM/DD/YYYY; absent while open",
      +        "type": "string"
      +      },
      +      "violation": {
      +        "description": "Type name",
      +        "type": "string"
      +      },
      +      "violationType": {
      +        "description": "National violation type code",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / rcraViolationsNextOffset
      Added value: +{
      +  "description": "Next rcra_violations_offset; absent on the last page",
      +  "type": "number"
      +}
    • addedOutput schema / properties / rcraViolationsTotal
      Added value: +{
      +  "description": "Across every page",
      +  "type": "number"
      +}
    • changedOutput schema / properties / registryId / description
      Previous value: -"EPA FRS Registry ID"New value: +"FRS Registry ID"
    • changedOutput schema / properties / state / description
      Previous value: -"2-letter state abbreviation"New value: +"State code"
    • changedOutput schema / properties / triFacilityIds / description
      Previous value: -"15-character TRI facility IDs recorded for this facility, most recently reported first — pass one as facility_id to epa_tri_get_facility_releases for per-chemical releases. A site can carry several from successive operators. Empty when the facility has no TRI record."New value: +"15-character IDs, most recently reported first; pass one as facility_id to epa_tri_get_facility_releases. Several mean successive operators."
    • changedOutput schema / properties / triReleasesTransfersInLbs / description
      Previous value: -"Total TRI on- and off-site releases and transfers in pounds for triReleasesTransfersYear, ECHO's latest TRI year for this facility. Absent when ECHO holds no TRI history for it."New value: +"TRI releases and transfers in pounds for triReleasesTransfersYear; absent without TRI history"
    • changedOutput schema / properties / triReleasesTransfersYear / description
      Previous value: -"TRI reporting year triReleasesTransfersInLbs covers"New value: +"ECHO's latest TRI year for the facility"
    • changedOutput schema / properties / truncated / description
      Previous value: -"True when a list was cut at its limit: more drinking-water violations or inspections follow this page, and drinkingWaterViolationsNextOffset or inspectionsNextOffset continues it. Absent when neither list has more."New value: +"True when inspections, drinkingWaterViolations, effluentExceedances, or rcraViolations has more pages; absent otherwise."
    • changedOutput schema / properties / waterCompliance / description
      Previous value: -"Clean Water Act status. Present only when programs.water is true and ECHO reports a CWA status."New value: +"Present only when programs.water is true and ECHO reports a CWA status"
    • changedOutput schema / properties / waterCompliance / properties / permitId / description
      Previous value: -"NPDES permit ID when the facility has exactly one; absent when it has several"New value: +"NPDES permit ID if exactly one; absent when several (see programIds)"
    • changedOutput schema / properties / waterCompliance / properties / status / description
      Previous value: -"Current Clean Water Act compliance status"New value: +"Current CWA status"
  2. Changed20 schema fields changed
    • addedInput schema / properties / drinking_water_violations_limit
      Added value: +{
      +  "default": 50,
      +  "description": "Maximum number of drinking-water violations to return in one call (1–200, default 50). A larger value, up to 5,000, returns 200 with a notice. Page past it with drinking_water_violations_offset and drinkingWaterViolationsNextOffset.",
      +  "maximum": 5000,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / drinking_water_violations_offset
      Added value: +{
      +  "default": 0,
      +  "description": "Number of drinking-water violations to skip before this page (default 0). Pass the previous call's drinkingWaterViolationsNextOffset to continue; a value past the end returns an empty page.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedInput schema / properties / inspections_limit
      Added value: +{
      +  "default": 100,
      +  "description": "Maximum number of inspections to return in one call (1–100, default 100). A larger value, up to 5,000, returns 100 with a notice. Page past it with inspections_offset and inspectionsNextOffset.",
      +  "maximum": 5000,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / inspections_offset
      Added value: +{
      +  "default": 0,
      +  "description": "Number of inspections to skip before this page (default 0). Pass the previous call's inspectionsNextOffset to continue; a value past the end returns an empty page.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedInput schema / properties / registry_id / description
      Previous value: -"EPA FRS Registry ID for the facility (obtained from epa_echo_search_facilities)"New value: +"EPA FRS Registry ID for the facility (from epa_echo_search_facilities), or an EPA program ID ECHO resolves to one: a public water system PWSID (from epa_water_search_systems, e.g. WA5300484), a TRI facility ID, an NPDES permit, or a RCRA handler ID. The profile carries the resolved registryId."
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "not": {
      -      "required": [
      -        "error"
      -      ]
      -    },
      -    "required": [
      -      "registryId",
      -      "name",
      -      "programs",
      -      "triFacilityIds",
      -      "programCompliance",
      -      "inspections",
      -      "inspectionsTotal",
      -      "formalActions"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "error"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "not": {
      +      "required": [
      +        "error"
      +      ]
      +    },
      +    "required": [
      +      "registryId",
      +      "name",
      +      "programs",
      +      "triFacilityIds",
      +      "naics",
      +      "programCompliance",
      +      "inspections",
      +      "inspectionsTotal",
      +      "drinkingWaterViolations",
      +      "drinkingWaterViolationsTotal",
      +      "formalActions"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "error"
      +    ]
      +  }
      +]
    • removedOutput schema / properties / compliance / properties / mediaStatusCode
      Removed value: -{
      -  "description": "Not populated: no ECHO response this tool reads carries a media status code.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / compliance / properties / mediaStatusDescription
      Removed value: -{
      -  "description": "Not populated: no ECHO response this tool reads carries a media status description. See complianceStatus and programCompliance.",
      -  "type": "string"
      -}
    • addedOutput schema / properties / drinkingWaterViolations
      Added value: +{
      +  "description": "Drinking-water (SDWIS) violations in ECHO's 5-year report for a public water system, newest compliance period first: one page of drinking_water_violations_limit entries from drinking_water_violations_offset. Empty for a facility with no SDWIS record.",
      +  "items": {
      +    "additionalProperties": false,
      +    "description": "Single drinking-water violation; fields ECHO leaves empty are absent, never defaulted",
      +    "properties": {
      +      "compliancePeriodBeginDate": {
      +        "description": "Start of the compliance period (MM/DD/YYYY)",
      +        "type": "string"
      +      },
      +      "compliancePeriodEndDate": {
      +        "description": "End of the compliance period (MM/DD/YYYY); absent when ECHO records none, as for an open period",
      +        "type": "string"
      +      },
      +      "contaminantName": {
      +        "description": "Contaminant or rule group, e.g. \"TTHM\", \"Arsenic\", \"Lead and Copper Rule\"",
      +        "type": "string"
      +      },
      +      "enforcementActions": {
      +        "description": "Enforcement actions ECHO links to the violation; absent when it lists none",
      +        "items": {
      +          "additionalProperties": false,
      +          "description": "Enforcement action ECHO links to the violation",
      +          "properties": {
      +            "agency": {
      +              "description": "Agency that took it, e.g. State, EPA",
      +              "type": "string"
      +            },
      +            "date": {
      +              "description": "Action date (MM/DD/YYYY)",
      +              "type": "string"
      +            },
      +            "description": {
      +              "description": "Action, e.g. \"State Administrative/Compliance Order without penalty issued\"",
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "Action type: \"Formal\", \"Informal\", or \"Resolving\"",
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "federalMcl": {
      +        "description": "Federal maximum contaminant level as ECHO writes it, units included (e.g. \"0.080 mg/L\")",
      +        "type": "string"
      +      },
      +      "federalRule": {
      +        "description": "Federal rule violated, e.g. \"Lead and Copper Rule\", \"Stage 2 Disinfectants and Disinfection Byproducts Rule\"",
      +        "type": "string"
      +      },
      +      "resolvedDate": {
      +        "description": "Date ECHO records the violation as resolved (MM/DD/YYYY)",
      +        "type": "string"
      +      },
      +      "sourceId": {
      +        "description": "Public water system ID (PWSID) the violation is recorded against",
      +        "type": "string"
      +      },
      +      "stateMcl": {
      +        "description": "State maximum contaminant level as ECHO writes it, units included",
      +        "type": "string"
      +      },
      +      "status": {
      +        "description": "ECHO's violation status: Resolved, Archived (no longer counts toward the system's current compliance status; an Archived entry can still carry a resolvedDate), Addressed (not resolved, with formal enforcement), or Unaddressed (not resolved, no formal enforcement)",
      +        "type": "string"
      +      },
      +      "violationCategory": {
      +        "description": "Violation category, e.g. \"Maximum Contaminant Level Violation\"",
      +        "type": "string"
      +      },
      +      "violationCategoryCode": {
      +        "description": "Violation category code, e.g. MCL (maximum contaminant level), MR (monitoring and reporting), MON (monitoring), TT (treatment technique)",
      +        "type": "string"
      +      },
      +      "violationId": {
      +        "description": "SDWIS violation ID",
      +        "type": "string"
      +      },
      +      "violationMeasure": {
      +        "description": "Measured level as ECHO writes it, units included (e.g. \"148.37 UG/L\"); absent when ECHO records none, as for monitoring violations",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / drinkingWaterViolationsNextOffset
      Added value: +{
      +  "description": "Offset of the next page of drinkingWaterViolations: present exactly when more follow, absent on the last page. Pass it as drinking_water_violations_offset.",
      +  "type": "number"
      +}
    • addedOutput schema / properties / drinkingWaterViolationsTotal
      Added value: +{
      +  "description": "Drinking-water violations in ECHO's report for this facility, across every page; 0 when it has no SDWIS record",
      +  "type": "number"
      +}
    • changedOutput schema / properties / error / properties / data / properties / reason / description
      Previous value: -"Machine-readable failure mode. Declared by this tool: `facility_not_found`: ECHO has no facility for the given Registry ID. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `facility_not_found`: ECHO has no facility for the given Registry ID or program ID. Other values are possible when a failure originates below the handler."
    • changedOutput schema / properties / formalActions / items / properties / caseId / description
      Previous value: -"Enforcement case identifier; absent when ECHO records the action without one, as for RCRA and SDWA actions"New value: +"Enforcement case identifier; pass it to epa_echo_get_case for the civil case report (facilities, defendants, conclusions). Absent when ECHO records the action without one, as for RCRA and SDWA actions"
    • changedOutput schema / properties / inspections / description
      Previous value: -"Inspections, evaluations, investigations, and other compliance monitoring records over the 5-year window, newest first; at most 100 (inspectionsTotal gives the full count)"New value: +"Inspections, evaluations, investigations, and other compliance monitoring records over the 5-year window, newest first: one page of inspections_limit entries from inspections_offset."
    • addedOutput schema / properties / inspectionsNextOffset
      Added value: +{
      +  "description": "Offset of the next page of inspections: present exactly when more follow, absent on the last page. Pass it as inspections_offset.",
      +  "type": "number"
      +}
    • changedOutput schema / properties / inspectionsTotal / description
      Previous value: -"Compliance monitoring records in ECHO's 5-year history for this facility; inspections lists the newest 100 when there are more"New value: +"Compliance monitoring records in ECHO's 5-year history for this facility, across every page"
    • addedOutput schema / properties / limitNotice
      Added value: +{
      +  "description": "Present when limit was above the cap and the call returned the cap instead.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / naics
      Added value: +{
      +  "description": "NAICS industry codes the facility's program records carry, each code once, ascending by code. Programs can record different codes for one site. Empty when no program records one.",
      +  "items": {
      +    "additionalProperties": false,
      +    "description": "One NAICS code",
      +    "properties": {
      +      "code": {
      +        "description": "NAICS code, 2–6 digits, e.g. \"331110\"",
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "NAICS title as ECHO records it, e.g. \"Iron and Steel Mills and Ferroalloy Manufacturing\"",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "code"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / truncated
      Added value: +{
      +  "description": "True when a list was cut at its limit: more drinking-water violations or inspections follow this page, and drinkingWaterViolationsNextOffset or inspectionsNextOffset continues it. Absent when neither list has more.",
      +  "type": "boolean"
      +}
    • removedOutput schema / properties / waterCompliance / properties / programId
      Removed value: -{
      -  "description": "Not populated: the CWA program ID is the NPDES permit ID, returned as permitId.",
      -  "type": "string"
      -}
  3. Added

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With readOnlyHint, idempotentHint, and openWorldHint already declared, the description still adds real substance: it discloses the five-year lookback windows, that inspections come newest first, that several sections are paged, and that lists are capped (5,000 for inspections, 3,000 for drinking-water violations). It does not cover error behavior or what happens when a program ID fails to resolve beyond noting the profile carries the resolved registryId.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and routing are front-loaded, but the body is a single run-on sentence enumerating a dozen returned sections, which duplicates what the output schema already carries. Trimming that enumeration would make the definition materially tighter without losing actionable guidance.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a nine-parameter, multi-section read tool, the definition covers addressing, pagination expectations, and cross-tool routing well, and an output schema handles return shapes. The remaining gap is minor: the description does not say what happens if the Registry ID is unknown or the program ID is ambiguous.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and the only parameter meaning the description adds (PWSID from epa_water_search_systems) is already spelled out in the registry_id schema text. It says nothing about the four limit/offset parameter pairs beyond what the schema already documents, so this is the baseline 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource ('Retrieve a full compliance profile for a single EPA-regulated facility') and immediately names the two addressing keys (EPA Registry ID or program ID). It is unmistakably distinct from epa_echo_search_facilities and epa_echo_search_violations because it states that this returns one facility's full profile rather than a list.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit routing: use epa_echo_search_facilities to discover Registry IDs, pass a PWSID from epa_water_search_systems for drinking-water violations, and use epa_echo_search_violations for area-level enforcement discovery. Both the when-to-use and the when-not-to-use paths are stated with the alternative tool named.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.