Skip to main content
Connect MXToolbox and the agent runs the checks your technicians run by hand on mxtoolbox.com, from a ticket: is this mail server’s IP on a public blacklist, does the domain’s mail server answer correctly from the internet, what does MXToolbox flag in the MX, SPF, DKIM and DMARC records, is this website or port reachable from outside. Every MXToolbox tool is read-only. The agent reports what MXToolbox found; it never changes DNS, delists an IP or touches a server.

Plans and quotas

MXToolbox meters the API per account and per day (the counters reset at 00:00 UTC): On a free account the agent can analyze DNS records but not check blacklists or test a mail server. Those tools answer with the account’s usage for the day and say the plan does not include them, and the agent writes that on the ticket instead of retrying. For plain DNS records with no quota, the agent also has the built-in domain lookups.

How to connect

1

Find your API key

Sign in to mxtoolbox.com with the MSP’s account, the one that holds your monitors if you have any. Open Account → Settings and the API tab (mxtoolbox.com/user/api). Copy the API key shown there. It is a UUID such as 00000000-0000-0000-0000-000000000000.
2

Connect MXToolbox in Rallied

In Rallied, go to Settings → Integrations, find the MXToolbox card and click Connect. Paste the key into API key and click Connect.
3

Confirm

Rallied checks the key against MXToolbox’s usage endpoint, which costs no quota. When the key is accepted the card shows Connected.
One key per MXToolbox user account. Revoking a key on mxtoolbox.com cannot be undone; generate a new one and use Update connection in Rallied to replace it.

How the agent uses it

The agent decides from the ticket which check applies:
  • “Our emails are rejected / bouncing”, “550 … blocked using …”: it takes the sending IP from the bounce and checks it against the public blacklists. The note lists the blacklists the IP is on, each with the list’s own delisting page.
  • “Nobody can email us”, “mail server unreachable”: it tests the domain’s mail server from the internet: reverse DNS, banner, TLS, open relay, response time.
  • “Email goes to spam”, “SPF / DKIM / DMARC failure”: it runs MXToolbox’s MX, SPF and DMARC analysis for the domain in one call (DKIM too, when the ticket names the selector) and quotes the problems MXToolbox flags.
  • “Is our website or portal down for everyone?”: it probes the host over HTTPS, a TCP port, ping or traceroute from MXToolbox’s network.
It writes what it found as an internal note, quoting MXToolbox’s own wording for each problem and the time the check ran. A listing on a blacklist or a flagged record is reported as a finding for a technician; the agent does not propose DNS changes as fact.
The connection covers your whole MXToolbox account, not one customer. Every lookup spends the account’s daily quota, whichever client’s ticket it runs on. Only the MSP admin Chat can read the account’s usage for the day or list its monitors.

Tools

All tools default to Auto. To change a default, open the Policies tab on Settings → Integrations → MXToolbox. See Approval settings.

See also