# mailx-tools

Mailx Tools is an MCP server that gives AI agents a complete email-deliverability diagnostics toolkit. Verify your domain's

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add mailwarm/mailx-tools

# Browse available tools
npx -y @smithery/cli@latest tool list mailwarm/mailx-tools

# Get full schema for a tool
npx -y @smithery/cli@latest tool get mailwarm/mailx-tools spf_check

# Call a tool
npx -y @smithery/cli@latest tool call mailwarm/mailx-tools spf_check '{}'
```

## Direct MCP Connection

Endpoint: `https://mailx-tools--mailwarm.run.tools`

**Optional config:**
- `default_dkim_selector` (query) — Default selector used by dkim_check when the call omits dkim_selector. Common values: google, selector1, selector2, k1, default.
- `preferred_provider` (query) — Default provider used by spf_generate and the setup-dns prompt when the call omits provider.
- `dmarc_aggregate_email` (query) — Default rua= address used by dmarc_generate when the call omits email. Aggregate DMARC reports from mailbox providers will be sent to this address.

## Tools (17)

- `spf_check` — Check if a domain has a valid SPF (Sender Policy Framework) DNS record. SPF specifies which mail servers are authorized…
- `dkim_check` — Check if a domain has a valid DKIM (DomainKeys Identified Mail) DNS record for a given selector. DKIM allows the receiv…
- `dmarc_check` — Check if a domain has a valid DMARC (Domain-based Message Authentication, Reporting & Conformance) DNS record. DMARC te…
- `bimi_check` — Check if a domain has a valid BIMI (Brand Indicators for Message Identification) DNS record. BIMI allows brands to disp…
- `dmarc_generate` — Generate a DMARC DNS record for a domain. Returns the record name, value, and type ready to be added to DNS.
- `spf_generate` — Generate an SPF DNS record for a domain based on the email provider being used. Returns the record name, value, and typ…
- `smtp_check` — Test an SMTP server connection by attempting to connect and authenticate. Optionally sends a test email to verify full …
- `imap_check` — Test an IMAP server connection by attempting to connect and authenticate. Use this to verify email receiving configurat…
- `smtp_finder` — Look up SMTP server settings (host, port, encryption) for a given email provider. Use this to find the correct SMTP con…
- `imap_finder` — Look up IMAP server settings (host, port, encryption) for a given email provider. Use this to find the correct IMAP con…
- `blacklist_check` — Check if a domain or IP address is listed in popular email blacklists (DNSBLs). Being blacklisted can severely impact e…
- `bimi_host` — Host and serve your BIMI SVG file for email authentication
- `mx_lookup` — Look up MX (Mail Exchanger) records for a domain. Returns the mail servers and their priorities.
- `txt_lookup` — Look up all TXT records for a domain. TXT records contain SPF policies, domain verification tokens, DKIM keys, and othe…
- `cname_lookup` — Look up CNAME (Canonical Name) records for a domain. Shows where a hostname aliases to.
- `ptr_lookup` — Reverse DNS lookup. Find the hostname associated with an IP address. A valid PTR record is important for email sending …
- `dns_lookup` — Look up all DNS records for a domain in one query. Returns A, AAAA, CNAME, MX, NS, TXT, and SOA records.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get mailwarm/mailx-tools <tool-name>
```

## Resources

- `mailx://skills/email-deliverability` — Guide for diagnosing and fixing email deliverability: SPF, DKIM, DMARC, BIMI, blacklists, SMTP/IMAP. Includes audit wor…
- `mailx://skills/email-deliverability/diagnosis` — Detailed reference for interpreting combined SPF/DKIM/DMARC/blacklist results and mapping failures to fixes per provide…

## Prompts (2)

- `audit-deliverability` (domain, dkim_selector) — Run a full deliverability audit on a domain: SPF, DMARC, DKIM, and blacklist checks. Produces a pass/fail summary with …
- `setup-dns` (domain, provider) — Generate SPF and DMARC DNS records for a domain based on its email provider, with copy-pasteable values ready to add to…