Documentation
Tools exposed by Facility Compliance Check and the limits that apply.
Connect
Server URL: https://facility.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
search_facilities
Finds EPA-regulated facilities by name, street, city, state, ZIP or NAICS code, with current compliance status per program, enforcement counts and penalty totals.
- Inputs: name, street, city, state, zip, naics, programs, limit (all optional, at least a name, ZIP or NAICS with a state)
- Limits: Counts one lookup. Up to 25 results per call; the program filter applies to the returned page.
facility_report
Detailed compliance record of one facility: programs, current status, quarters in noncompliance, significant violator flags, inspections, formal enforcement actions and penalty totals with dates, and the ECHO link.
- Inputs: registry_id (FRS id or an ECHO report URL)
- Limits: Counts one lookup.
check_suppliers
Matches suppliers (name and address) to ECHO facilities, with a confidence level and the red flags of the best match.
- Inputs: suppliers (name, address, city, state, zip), offset (optional)
- Limits: Up to 5 suppliers per call on Free and 25 on Pro, processed in slices of 10 (next_offset continues). One lookup per supplier searched.
add_watch
Adds a facility to the watchlist and records its current state as the baseline.
- Inputs: registry_id
- Limits: Counts one lookup. Watched-facility limit by plan. Checked weekly on Pro, every two weeks on Free.
list_watches
Lists watched facilities with last check and next check times.
- Inputs: none
- Limits: No quota.
remove_watch
Removes a facility from the watchlist.
- Inputs: registry_id
- Limits: No quota.
check_now
Checks one watched facility immediately and reports and records any changes.
- Inputs: registry_id
- Limits: Counts one lookup.
get_alerts
Recorded alerts, unseen first; marks the returned alerts as seen.
- Inputs: limit (optional), include_seen (optional)
- Limits: No quota.
account_status
Shows the account email, plan, usage and limits.
- Inputs: none
- Limits: none
activate_license
Binds a licence key to the account.
- Inputs: license_key (string)
- Limits: Key must belong to this product.
Plan limits
| Limit | Free | Pro |
|---|---|---|
| facility lookups | 25 | 3000 |
| watched facilities | 5 | 300 |
| batch_size | 5 | 25 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://facility.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.