Documentation

Tools exposed by Mail Domain Doctor and the limits that apply.

Connect

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

Tools

`check_mail_domain`

Full email configuration check for one domain with a score and exact fix records.

Inputs: domain, dkim_selectors (optional list of selector names)
Limits: Counts one check. DKIM selectors tried: a built-in list of 12, or the ones supplied.

Check the email setup of example.com and tell me what to fix.

`suggest_dns_records`

Generates SPF, MX, DKIM guidance, DMARC, MTA-STS and TLS-RPT records for a mail provider.

Inputs: domain, provider (google_workspace, microsoft_365, zoho, ses, mailgun, sendgrid, postmark, brevo)
Limits: No quota. Values unique to your account are shown as placeholders.

What DNS records does example.com need for Google Workspace?

`check_mail_domains_bulk`

Checks MX, SPF and DMARC for several domains and returns a table.

Inputs: domains (list)
Limits: Counts one check per domain. Maximum list size by plan. At most 12 domains are processed per call; the rest are returned for a follow-up call.

Check these 10 client domains for SPF and DMARC.

`check_blocklists`

Looks up a domain mail servers or an IPv4 address on SpamCop, Barracuda, UCEPROTECT level 1 and PSBL. Spamhaus is not queried.

Inputs: domain_or_ip
Limits: Counts one check.

Is the mail server for example.com on any blocklist?

`watch_domain`

Adds a domain to the saved list that is re-checked weekly (Pro).

Inputs: domain
Limits: Saved domain limit by plan.

Watch example.com every week.

`unwatch_domain`

Removes a domain and its history from the saved list.

Inputs: domain
Limits: Deletes the saved record and change log for that domain.

Stop watching example.com.

`get_domain_history`

Shows the score and change log from the weekly re-checks of a saved domain.

Inputs: domain, limit (optional)
Limits: Latest 50 entries.

What changed on example.com in the last month?

`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
checks	10	1000
domains per bulk check	3	50
saved domains	0	25

Network behaviour

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