> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rallied.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MXToolbox

> Connect MXToolbox so the agent can check email blacklists, test a mail server from the internet, analyze MX, SPF, DKIM and DMARC records and probe a host from outside, from a ticket.

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):

| Plan | DNS lookups (MX, SPF, DKIM, DMARC, A, TXT, ...) | Network lookups (blacklist, SMTP test, HTTP, ping, TCP, traceroute) | Monitors |
| - | - | - | - |
| Free | 64 a day | None | None |
| Paid (Delivery Center) | Per plan | Per plan | Included |

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](https://docs.rallied.ai/integrations/rallied-tools.md#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**.

> [!NOTE]
>
> 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.

> [!NOTE]
>
> 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](https://docs.rallied.ai/dashboard/chat.md) 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](https://docs.rallied.ai/dashboard/policies.md).

| Tool | Default policy | Quota | Description |
| - | - | - | - |
| `mxtoolbox-check-blacklist` | Auto | Network | Check an IP or domain against the public email blacklists; lists the ones it is on |
| `mxtoolbox-check-mail-server` | Auto | Network | Test a domain's mail server from the internet (reverse DNS, banner, TLS, open relay, timing) |
| `mxtoolbox-check-email-health` | Auto | DNS (3 to 5 lookups) | MX, SPF, DMARC and optional DKIM analysis for a domain in one call, with an overall verdict |
| `mxtoolbox-lookup-dns` | Auto | DNS | One DNS lookup with MXToolbox's analysis: mx, a, aaaa, txt, soa, spf, dkim, dmarc, bimi, mta-sts, tlsrpt, ptr, asn or dns |
| `mxtoolbox-check-network` | Auto | Network | Probe a host from the internet: http, https, ping, tcp (with a port) or trace |
| `mxtoolbox-list-monitors` | Auto | None | List the account's monitors and which are failing. Admin chat only, paid plans |
| `mxtoolbox-get-usage` | Auto | None | Read today's DNS and network lookups used and allowed. Admin chat only |

## See also

* [Rallied tools: domain lookups](https://docs.rallied.ai/integrations/rallied-tools.md#domain-lookups)
* [Approval settings](https://docs.rallied.ai/dashboard/policies.md)
* [Chat](https://docs.rallied.ai/dashboard/chat.md)
* [Integrations overview](https://docs.rallied.ai/integrations/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.