> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MXToolbox

> MxToolbox provides a suite of network diagnostic and monitoring tools, including DNS lookups, blacklist checks, and email health analysis.

![MXToolbox logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/mx_toolbox.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=52c9d78b69dc39aec0eecac347b17066)

* **Category:** server monitoring
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 13
* **Triggers:** 0
* **Slug:** `MX_TOOLBOX`
* **Version:** 20261101\_00

## Tools

> [accordion] Lookup BIMI Record
>
> **Slug:** `MX_TOOLBOX_LOOKUP_BIMI_RECORD`
>
> Retrieves BIMI (Brand Indicators for Message Identification) record and diagnostic information for a domain. BIMI allows organizations to display verified logos in email clients. This tool checks: - Whether a BIMI record exists at default.\_bimi.\{domain} - DMARC policy requirements (quarantine or reject needed for BIMI) - DNS resolution details and nameserver information - Related diagnostic checks and recommendations Returns comprehensive lookup data including passed/failed checks, DMARC records, DNS transcript, and related lookups. Use when verifying email branding configuration or troubleshooting BIMI implementation.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> The domain to perform BIMI lookup on (e.g., 'example.com', 'google.com').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Lookup Blacklist
>
> **Slug:** `MX_TOOLBOX_LOOKUP_BLACKLIST`
>
> Tool to perform a blacklist check on a domain or IP. Use when you need to verify whether a domain or IP is listed in common blacklists.
>
> #### Input Parameters
>
> **domain\_or\_ip** `string` *required*
>
> The domain name or IP address to lookup in blacklists Must be a bare hostname or IP address without protocol prefixes (e.g., no 'http\://') or path suffixes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Lookup DKIM Record
>
> **Slug:** `MX_TOOLBOX_LOOKUP_DKIM`
>
> Runs a DKIM record lookup for a domain and selector to help verify email authentication configuration. The provider requires the lookup argument in domain:selector format; the supplied value is passed through without conversion.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> DKIM record name in DNS format: 'selector.\_domainkey.domain' (e.g., 'google.\_domainkey.google.com' where 'google' is the selector). This is the full DNS hostname for the DKIM TXT record. Common selectors include 'default', 'google', 'k1', 's1', 's2', or 'email'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Lookup DMARC Record
>
> **Slug:** `MX_TOOLBOX_LOOKUP_DMARC`
>
> Runs a DMARC record lookup and validation for a domain. Returns record information, passed checks and errors; failed checks and warnings from the lookup are not included in the returned result.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> The domain to lookup DMARC record for. Must be a bare hostname (e.g., 'example.com') without protocol prefixes ('https\://') or path components.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Lookup DNS Records
>
> **Slug:** `MX_TOOLBOX_LOOKUP_DNS`
>
> Performs comprehensive DNS health check and retrieves name server records for a domain. Returns detailed diagnostics including: - Name server (NS) records with IP addresses, TTL, and status - DNS configuration health checks (warnings, errors, passed tests) - Query transcripts showing DNS resolution path - Related lookup suggestions (A, MX, SPF records) Use this to diagnose DNS issues, verify name server configurations, or check DNS propagation status.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Domain to perform DNS lookup on, for example 'google.com' Bare hostname only — no protocols (e.g., 'http\://'), subpath, or trailing slashes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] HTTP Lookup
>
> **Slug:** `MX_TOOLBOX_LOOKUP_HTTP`
>
> Tool to perform an HTTP test on a domain. Use when you need to assess HTTP connectivity and status for a given domain.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> The domain to perform HTTP diagnostics on (e.g., 'example.com'). Do not include protocol or paths.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Lookup MTA-STS Record
>
> **Slug:** `MX_TOOLBOX_LOOKUP_MTA_STS_RECORD`
>
> Tool to lookup MTA-STS record for a domain. Use when validating mail transport security policy.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> The domain to perform MTA-STS lookup on.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Lookup MX Records
>
> **Slug:** `MX_TOOLBOX_LOOKUP_MX`
>
> Retrieves MX records for a domain, including mail server hostnames, priority, TTL and, when available, IP addresses. Missing or unparseable priority and TTL values are returned as zero.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Domain name to lookup MX records for (e.g., example.com) Bare hostname only — no protocol prefix (e.g., not '[http://example.com](http://example.com)') or path suffix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Ping Lookup
>
> **Slug:** `MX_TOOLBOX_LOOKUP_PING`
>
> Performs a ping test to check network connectivity and measure round-trip time to a domain or IP address. Returns detailed ping statistics including response time, TTL (Time-To-Live), packet size, and ASN (Autonomous System Number) information. Useful for diagnosing network connectivity issues, measuring latency, and verifying host availability.
>
> #### Input Parameters
>
> **domain\_or\_ip** `string` *required*
>
> The domain name or IP address to ping (e.g., 'google.com' or '8.8.8.8').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] SMTP Lookup
>
> **Slug:** `MX_TOOLBOX_LOOKUP_SMTP`
>
> Tool to perform an SMTP connectivity test on a domain. Returns diagnostic results including connection status, DNS checks, TLS support, and other email deliverability indicators. Use when verifying SMTP server configuration or troubleshooting email delivery issues for a domain.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Domain to perform SMTP test on (must be a valid hostname, e.g. 'google.com')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Lookup SPF Record
>
> **Slug:** `MX_TOOLBOX_LOOKUP_SPF`
>
> Tool to retrieve SPF records for a specified domain. Use when confirming email sender authorization policies.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> The domain to perform the SPF lookup on. Must be a bare hostname with no protocol prefix (e.g., not '[https://example.com](https://example.com)') or path suffixes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Monitor Status
>
> **Slug:** `MX_TOOLBOX_MONITOR_STATUS`
>
> Retrieves current statuses for all monitors in the authenticated MxToolbox account, including failing checks and warnings. No parameters are required; monitor queries require a paid API key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check Usage
>
> **Slug:** `MX_TOOLBOX_USAGE_CHECK`
>
> Retrieve API usage statistics for DNS and network lookups. Returns current request counts, maximum allowed requests, and any overage errors for both DNS lookups and network operations (HTTP, SMTP, Ping).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
