Skip to main content
Glama

Search EPA Facilities

epa_echo_search_facilities
Read-onlyIdempotent

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.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "epa_echo_search_facilities"
  }
}

Input Schema

NameRequiredDescriptionDefault
cityNoCity name, case-insensitive; matches cities that begin with it ("TACOMA", or "SEAT" for SEATTLE and SEATAC). Pair with state.
limitNoNumber of facilities to return in one call. Default 25; a larger value returns at most 2,500 and says so. Page past it with offset and nextOffset.
naicsNoNAICS industry code, 2–6 digits; fewer than six match every code that begins with them ("3364" for aerospace product and parts manufacturing). Pair with a geographic filter.
stateNo2-letter state or territory codes (e.g. "WA", "PR"), case-insensitive, matching any of them. Required with county. ECHO also files facilities under codes outside the USPS set, such as DM for offshore Gulf of Mexico platforms; any 2-character code is searched as written.
countyNoCounty name, case-insensitive. A trailing County, Parish, Borough, City and Borough, Census Area, or Municipality is dropped ("King County" searches KING), then it matches recorded county names that begin with it, so KING in VA also matches KING GEORGE. Requires state, and matches in each state listed. Covers every registration ECHO places in the county, including ones with no program record that county_fips leaves out.
offsetNoNumber of facilities to skip before this page (default 0). Pass the previous call's nextOffset to continue; a value past the end returns an empty page.
latitudeNoLatitude in decimal degrees. Pair with longitude and radius_miles for proximity search.
programsNoRestrict results to facilities registered in one environmental program — ECHO filters on a single program per search, so pass one value. CAA=air, CWA=water, RCRA=hazardous waste, TRI=toxic releases, SDWA=drinking water.
zip_codeNo5-digit ZIP codes to search within, matching any of them; a ZIP+4 such as "98108-1234" searches its first five digits
longitudeNoLongitude in decimal degrees. Pair with latitude and radius_miles for proximity search.
active_onlyNoWhen true, return only facilities with an active permit
county_fipsNo5-digit county FIPS code, state + county (e.g. "53033" for King County, WA); matches it exactly and scopes a search on its own. Leaves out registrations with no program record, which county includes.
radius_milesNoSearch radius in miles around the given latitude/longitude (max 100). Requires latitude and longitude.
facility_nameNoFacility name words, case-insensitive: every word must appear as a whole word, in any order, in a name ECHO records for the facility, so "BOEING" matches BOEING PLANT 2 and "OEING" matches nothing. A match can come from another name ECHO records for the facility, so a returned name can lack the words. No commas. Pair with a geographic filter.
has_violationNoWhen true, return only facilities with at least one program in significant noncompliance (complianceStatus "Significant Violation")

Output Schema

NameRequiredDescriptionDefault
errorNoPresent when the call failed. Absent on success.
noticeNoPresent when more facilities follow: the continuing offset.
messageNoRecovery hint on an empty page; absent otherwise.
facilitiesNoMatching facilities, ECHO's order
nextOffsetNoNext offset; absent on the last page.
totalCountNoMatches before limit and offset
limitNoticeNoPresent when a smaller limit than requested applied; says why.
effectiveQueryNoThe search as sent upstream, in input names: values, match modes, and result-changing defaults, "; "-joined.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed40 schema fields changed
    • changedInput schema / properties / county / description
      Previous value: -"County name, case-insensitive. A trailing County, Parish, Borough, City and Borough, Census Area, or Municipality is dropped (\"King County\" searches KING), then it matches recorded county names that begin with it, so KING in VA also matches KING GEORGE. Requires state. Covers every registration ECHO places in the county, including ones with no program record that county_fips leaves out."New value: +"County name, case-insensitive. A trailing County, Parish, Borough, City and Borough, Census Area, or Municipality is dropped (\"King County\" searches KING), then it matches recorded county names that begin with it, so KING in VA also matches KING GEORGE. Requires state, and matches in each state listed. Covers every registration ECHO places in the county, including ones with no program record that county_fips leaves out."
    • changedInput schema / properties / limit / default
      Previous value: -50New value: +25
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum number of facilities to return in one call (1–100, default 50). A larger value, up to 5,000, returns 100 with a notice. Page past it with offset and nextOffset."New value: +"Number of facilities to return in one call. Default 25; a larger value returns at most 2,500 and says so. Page past it with offset and nextOffset."
    • changedInput schema / properties / limit / maximum
      Previous value: -5000New value: +9007199254740991
    • changedInput schema / properties / state / description
      Previous value: -"2-letter state or territory code (e.g. \"WA\", \"PR\"), case-insensitive. Required with county. ECHO also files facilities under codes outside the USPS set, such as DM for offshore Gulf of Mexico platforms; any 2-character code is searched as written."New value: +"2-letter state or territory codes (e.g. \"WA\", \"PR\"), case-insensitive, matching any of them. Required with county. ECHO also files facilities under codes outside the USPS set, such as DM for offshore Gulf of Mexico platforms; any 2-character code is searched as written."
    • addedInput schema / properties / state / items
      Added value: +{
      +  "pattern": "^\\s*[A-Za-z0-9]{2}\\s*$",
      +  "type": "string"
      +}
    • addedInput schema / properties / state / maxItems
      Added value: +100
    • removedInput schema / properties / state / pattern
      Removed value: -"^\\s*(?:[A-Za-z0-9]{2}\\s*)?$"
    • changedInput schema / properties / state / type
      Previous value: -"string"New value: +"array"
    • changedInput schema / properties / zip_code / description
      Previous value: -"5-digit ZIP code to search within; a ZIP+4 such as \"98108-1234\" searches its first five digits"New value: +"5-digit ZIP codes to search within, matching any of them; a ZIP+4 such as \"98108-1234\" searches its first five digits"
    • addedInput schema / properties / zip_code / items
      Added value: +{
      +  "pattern": "^\\s*\\d{5}(?:-?\\d{4})?\\s*$",
      +  "type": "string"
      +}
    • addedInput schema / properties / zip_code / maxItems
      Added value: +200
    • removedInput schema / properties / zip_code / pattern
      Removed value: -"^\\s*(?:\\d{5}(?:-?\\d{4})?\\s*)?$"
    • changedInput schema / properties / zip_code / type
      Previous value: -"string"New value: +"array"
    • changedOutput schema / properties / effectiveQuery / description
      Previous value: -"The search as the server sent it upstream, in this tool's input names: normalized values, how each text filter matched (\"=\" exact, \"contains\", \"begins with\", \"has words\"), and defaults that change what comes back. Terms are separated by \"; \"."New value: +"The search as sent upstream, in input names: values, match modes, and result-changing defaults, \"; \"-joined."
    • changedOutput schema / properties / error / properties / data / properties / reason / description
      Previous value: -"Machine-readable failure mode. Declared by this tool: `no_geographic_filter`: No geographic filter (zip_code, state, city, county_fips, or a latitude+longitude+radius_miles triple) was provided. `incomplete_proximity`: A proximity search was started but latitude, longitude, and radius_miles were not all provided. `county_requires_state`: county was provided without state. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_geographic_filter`: No zip_code, state, city, county_fips, or latitude+longitude+radius_miles. `incomplete_proximity`: Only part of latitude, longitude, and radius_miles. `county_requires_state`: county without state. Other values are possible when a failure originates below the handler."
    • changedOutput schema / properties / facilities / description
      Previous value: -"One page of matching EPA facilities, in ECHO's order: limit facilities from offset"New value: +"Matching facilities, ECHO's order"
    • changedOutput schema / properties / facilities / items / description
      Previous value: -"EPA facility record with Registry ID, location, program flags, and compliance summary"New value: +"One facility"
    • changedOutput schema / properties / facilities / items / properties / complianceStatus / description
      Previous value: -"Overall compliance status text from ECHO"New value: +"ECHO compliance status"
    • addedOutput schema / properties / facilities / items / properties / distanceMiles
      Added value: +{
      +  "description": "Great-circle miles from the search point, to two decimals; absent without a search point or row coordinates.",
      +  "type": "number"
      +}
    • changedOutput schema / properties / facilities / items / properties / fipsCode / description
      Previous value: -"5-digit county FIPS code — use with Census API for demographics"New value: +"5-digit county FIPS code"
    • changedOutput schema / properties / facilities / items / properties / inspectionCount / description
      Previous value: -"Inspections over the last five years, across programs"New value: +"Last five years, all programs"
    • changedOutput schema / properties / facilities / items / properties / latitude / description
      Previous value: -"Latitude in decimal degrees"New value: +"Decimal degrees"
    • changedOutput schema / properties / facilities / items / properties / longitude / description
      Previous value: -"Longitude in decimal degrees"New value: +"Decimal degrees"
    • changedOutput schema / properties / facilities / items / properties / programs / description
      Previous value: -"Program registration flags — the same programs the programs filter selects"New value: +"Flags for the programs the programs filter selects"
    • changedOutput schema / properties / facilities / items / properties / programs / properties / air / description
      Previous value: -"Has a Clean Air Act (CAA) stationary-source record in ICIS-Air"New value: +"Has an ICIS-Air (CAA) record"
    • changedOutput schema / properties / facilities / items / properties / programs / properties / rcra / description
      Previous value: -"Has an RCRA hazardous waste handler record"New value: +"Has an RCRA handler record"
    • changedOutput schema / properties / facilities / items / properties / programs / properties / sdwa / description
      Previous value: -"Has a Safe Drinking Water Act (SDWA) public water system record"New value: +"Has an SDWA water system record"
    • changedOutput schema / properties / facilities / items / properties / programs / properties / tri / description
      Previous value: -"Has a Toxics Release Inventory (TRI) facility ID (triFacilityIds is non-empty), whether or not it reported in the latest year"New value: +"triFacilityIds is non-empty, whether or not it reported in the latest year"
    • changedOutput schema / properties / facilities / items / properties / programs / properties / water / description
      Previous value: -"Has a Clean Water Act (CWA) discharge permit record in ICIS-NPDES"New value: +"Has an ICIS-NPDES (CWA) permit record"
    • changedOutput schema / properties / facilities / items / properties / registryId / description
      Previous value: -"EPA FRS Registry ID — use as input to epa_echo_get_facility"New value: +"FRS Registry ID; pass it as registry_id to epa_echo_get_facility"
    • changedOutput schema / properties / facilities / items / properties / state / description
      Previous value: -"2-letter state abbreviation"New value: +"State code"
    • changedOutput schema / properties / facilities / items / properties / totalPenaltiesInDollars / description
      Previous value: -"Penalties from formal enforcement actions over the last five years, across programs, in dollars"New value: +"Formal-action penalties in dollars, last five years, all programs"
    • changedOutput schema / properties / facilities / items / properties / triFacilityIds / description
      Previous value: -"15-character TRI facility IDs ECHO records for this facility, in ECHO's order, which is not reporting-year order — 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 facility ID."New value: +"15-character IDs in ECHO's order, not reporting-year order; pass one as facility_id to epa_tri_get_facility_releases. Several mean successive operators."
    • changedOutput schema / properties / facilities / items / properties / triReleasesTransfersInLbs / description
      Previous value: -"Total TRI on/off-site releases and transfers in pounds for ECHO's latest TRI year (summary). For the per-chemical breakdown, pass one of triFacilityIds to epa_tri_get_facility_releases — the Registry ID is not a TRI facility ID."New value: +"TRI releases and transfers in pounds, ECHO's latest TRI year; for per-chemical detail pass a triFacilityIds entry, not the Registry ID, to epa_tri_get_facility_releases"
    • 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 / message / description
      Previous value: -"Recovery hint when the page is empty: no facility matched, or offset is past the last match. Absent when facilities are returned."New value: +"Recovery hint on an empty page; absent otherwise."
    • changedOutput schema / properties / nextOffset / description
      Previous value: -"Offset of the next page: present exactly when more records follow, absent on the last page. Pass it as offset to continue."New value: +"Next offset; absent on the last page."
    • changedOutput schema / properties / notice / description
      Previous value: -"Present when more facilities follow: names the offset that continues the list."New value: +"Present when more facilities follow: the continuing offset."
    • changedOutput schema / properties / totalCount / description
      Previous value: -"Facilities matched before limit and offset were applied"New value: +"Matches before limit and offset"
  2. Changed24 schema fields changed
    • addedInput schema / properties / county
      Added value: +{
      +  "description": "County name, case-insensitive. A trailing County, Parish, Borough, City and Borough, Census Area, or Municipality is dropped (\"King County\" searches KING), then it matches recorded county names that begin with it, so KING in VA also matches KING GEORGE. Requires state. Covers every registration ECHO places in the county, including ones with no program record that county_fips leaves out.",
      +  "type": "string"
      +}
    • addedInput schema / properties / county_fips
      Added value: +{
      +  "description": "5-digit county FIPS code, state + county (e.g. \"53033\" for King County, WA); matches it exactly and scopes a search on its own. Leaves out registrations with no program record, which county includes.",
      +  "pattern": "^\\s*(?:\\d{5}\\s*)?$",
      +  "type": "string"
      +}
    • addedInput schema / properties / facility_name
      Added value: +{
      +  "description": "Facility name words, case-insensitive: every word must appear as a whole word, in any order, in a name ECHO records for the facility, so \"BOEING\" matches BOEING PLANT 2 and \"OEING\" matches nothing. A match can come from another name ECHO records for the facility, so a returned name can lack the words. No commas. Pair with a geographic filter.",
      +  "pattern": "^[^,]*$",
      +  "type": "string"
      +}
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum number of facilities to return (1–100)"New value: +"Maximum number of facilities to return in one call (1–100, default 50). A larger value, up to 5,000, returns 100 with a notice. Page past it with offset and nextOffset."
    • changedInput schema / properties / limit / maximum
      Previous value: -100New value: +5000
    • addedInput schema / properties / naics
      Added value: +{
      +  "description": "NAICS industry code, 2–6 digits; fewer than six match every code that begins with them (\"3364\" for aerospace product and parts manufacturing). Pair with a geographic filter.",
      +  "pattern": "^\\s*(?:\\d{2,6}\\s*)?$",
      +  "type": "string"
      +}
    • addedInput schema / properties / offset
      Added value: +{
      +  "default": 0,
      +  "description": "Number of facilities to skip before this page (default 0). Pass the previous call's nextOffset to continue; a value past the end returns an empty page.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedInput schema / properties / state / description
      Previous value: -"2-letter US state abbreviation (e.g. \"WA\", \"CA\")"New value: +"2-letter state or territory code (e.g. \"WA\", \"PR\"), case-insensitive. Required with county. ECHO also files facilities under codes outside the USPS set, such as DM for offshore Gulf of Mexico platforms; any 2-character code is searched as written."
    • addedInput schema / properties / state / pattern
      Added value: +"^\\s*(?:[A-Za-z0-9]{2}\\s*)?$"
    • changedInput schema / properties / zip_code / description
      Previous value: -"5-digit ZIP code to search within"New value: +"5-digit ZIP code to search within; a ZIP+4 such as \"98108-1234\" searches its first five digits"
    • addedInput schema / properties / zip_code / pattern
      Added value: +"^\\s*(?:\\d{5}(?:-?\\d{4})?\\s*)?$"
    • addedOutput schema / properties / effectiveQuery
      Added value: +{
      +  "description": "The search as the server sent it upstream, in this tool's input names: normalized values, how each text filter matched (\"=\" exact, \"contains\", \"begins with\", \"has words\"), and defaults that change what comes back. Terms are separated by \"; \".",
      +  "type": "string"
      +}
    • changedOutput schema / properties / error / properties / data / properties / reason / description
      Previous value: -"Machine-readable failure mode. Declared by this tool: `no_geographic_filter`: No geographic filter (zip_code, state, city, or a latitude+longitude+radius_miles triple) was provided. `incomplete_proximity`: A proximity search was started but latitude, longitude, and radius_miles were not all provided. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_geographic_filter`: No geographic filter (zip_code, state, city, county_fips, or a latitude+longitude+radius_miles triple) was provided. `incomplete_proximity`: A proximity search was started but latitude, longitude, and radius_miles were not all provided. `county_requires_state`: county was provided without state. Other values are possible when a failure originates below the handler."
    • changedOutput schema / properties / error / properties / data / properties / reason / examples
      Previous value: -[
      -  "no_geographic_filter",
      -  "incomplete_proximity"
      -]New value: +[
      +  "no_geographic_filter",
      +  "incomplete_proximity",
      +  "county_requires_state"
      +]
    • changedOutput schema / properties / facilities / description
      Previous value: -"Matching EPA facilities"New value: +"One page of matching EPA facilities, in ECHO's order: limit facilities from offset"
    • changedOutput schema / properties / facilities / items / properties / programs / properties / tri / description
      Previous value: -"Has a Toxics Release Inventory (TRI) facility ID, whether or not it reported in the latest year"New value: +"Has a Toxics Release Inventory (TRI) facility ID (triFacilityIds is non-empty), whether or not it reported in the latest year"
    • addedOutput schema / properties / facilities / items / properties / triFacilityIds
      Added value: +{
      +  "description": "15-character TRI facility IDs ECHO records for this facility, in ECHO's order, which is not reporting-year order — 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 facility ID.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / facilities / items / properties / triReleasesTransfersInLbs / description
      Previous value: -"Total TRI on/off-site releases and transfers in pounds for ECHO's latest TRI year (summary). For the per-chemical breakdown, call epa_tri_get_facility_releases with the TRI facility ID that epa_tri_search_releases returns as facilityId — the Registry ID is not a TRI facility ID."New value: +"Total TRI on/off-site releases and transfers in pounds for ECHO's latest TRI year (summary). For the per-chemical breakdown, pass one of triFacilityIds to epa_tri_get_facility_releases — the Registry ID is not a TRI facility ID."
    • changedOutput schema / properties / facilities / items / required
      Previous value: -[
      -  "registryId",
      -  "name",
      -  "programs"
      -]New value: +[
      +  "registryId",
      +  "name",
      +  "programs",
      +  "triFacilityIds"
      +]
    • addedOutput schema / properties / limitNotice
      Added value: +{
      +  "description": "Present when limit was above the cap and the call returned the cap instead.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / message / description
      Previous value: -"Recovery hint when no results are found — echoes applied filters and suggests how to broaden the search. Absent when results are returned."New value: +"Recovery hint when the page is empty: no facility matched, or offset is past the last match. Absent when facilities are returned."
    • addedOutput schema / properties / nextOffset
      Added value: +{
      +  "description": "Offset of the next page: present exactly when more records follow, absent on the last page. Pass it as offset to continue.",
      +  "type": "number"
      +}
    • addedOutput schema / properties / notice
      Added value: +{
      +  "description": "Present when more facilities follow: names the offset that continues the list.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / totalCount / description
      Previous value: -"Total facilities matched before the limit was applied"New value: +"Facilities matched before limit and offset were applied"
  3. Added

TDQS

A4.4/5.0
Behavior5/5

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

Annotations only declare read-only/open-world/idempotent, but the description adds real behavioral facts: unscoped searches time out, oversized limits are silently capped at 2,500 with a notice, pagination continues via offset/nextOffset, and proximity rows carry an extra distanceMiles field. These are operational traits an agent cannot derive from the structured fields.

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

Conciseness4/5

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

Front-loaded with purpose, then scope, then the critical constraint, then pagination — a sensible ordering. The one weak stretch is the long enumeration of return fields, which partly duplicates the output schema that already exists.

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

Completeness5/5

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

For a 15-parameter tool with zero required parameters, the description supplies exactly the missing piece: which filter combinations are valid and that at least one geographic anchor is mandatory. Return shape is covered by the output schema, so nothing an agent needs to call this correctly is absent.

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%, so per-parameter meaning is already fully documented and the baseline is 3. The description does add cross-parameter constraints the schema cannot express (the geographic-filter requirement and the complete lat+lon+radius triple), but it adds no per-parameter semantics beyond what the schema already states.

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?

Opens with a specific verb+resource ("Search EPA-regulated facilities") and enumerates the searchable dimensions (location, county, name, NAICS, program, compliance status) plus the program scope (CAA, CWA, RCRA, TRI, SDWA). It also names the downstream consumers (epa_echo_get_facility, epa_tri_get_facility_releases), so an agent can place it in a workflow without opening the schema.

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

Usage Guidelines4/5

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

Gives an explicit hard precondition — at least one geographic filter from zip_code, state, city, county_fips, or the lat+lon+radius triple — and warns that unscoped searches time out, plus pairing rules for naics and proximity mode. What it lacks is routing to sibling search tools (e.g. epa_echo_search_violations) when the goal is violation-centric rather than facility-centric.

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.