Documentation

Tools exposed by Email List Cleaner and the limits that apply.

Connect

Server URL: https://listclean.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.

Tools

`clean_email_list`

Starts cleaning a list given as a public CSV URL or as up to 500 pasted addresses. Large lists are processed in batches.

Inputs: csv_url or emails, optional email_column, has_header, dedupe_gmail_aliases
Limits: Each address checked counts toward the monthly allowance. Per-list limit by plan. No mail server is contacted.

Clean the email column of https://example.com/subscribers.csv.

`get_list_clean`

Progress for a clean; advances it by one batch. When done, returns counts, reasons, the report URL and the cleaned CSV URL.

Inputs: clean_id
Limits: One batch per call.

How is clean abc going?

`check_email`

Checks one address immediately: syntax, domain DNS, disposable, role and typo checks.

Inputs: email
Limits: Counts one address.

Is jane@gmial.com a good address?

`list_list_cleans`

Lists the latest 20 cleans for the account.

Inputs: none
Limits: Latest 20.

List my list cleans.

`account_status`

Shows the account email, plan, usage and limits.

Inputs: none
Limits: none

Show my account status.

`activate_license`

Binds a licence key to the account.

Inputs: license_key (string)
Limits: Key must belong to this product.

Activate licence key XXXX-XXXX.

Plan limits

Limit	Free	Pro
addresses	1000	100000
addresses per list	1000	50000

Network behaviour

Outbound requests use the user agent TidyButtonBot/1.0 (+https://listclean.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.