Mailx Tools

by Mailwarm

321 downloads

Not rated

GitHub

Developer Tools

About

MCP server for email deliverability: validate SPF/DKIM/DMARC/BIMI, check blacklists, test SMTP/IMAP, look up DNS, and generate ready-to-deploy records for any major email provider. Ships with two one-click prompts (audit-deliverability, setup-dns). Public, no auth.

Details

Author: Mailwarm
Downloads: 321
Categories: Developer Tools

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Mailx Tools

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

From the repository

Install via npx -y @mailwarm/mailx-mcp and configure in your MCP client (e.g., Claude Desktop, Claude Code, Cursor). Optionally set default preferences like default_dkim_selector, preferred_provider, or dmarc_aggregate_email. Use built-in slash prompts audit-deliverability(domain) and setup-dns(domain, provider).

`spf_check`

Check if a domain has a valid SPF (Sender Policy Framework) DNS record. SPF specifies which mail servers are authorized to send email on behalf of a domain.

`dkim_check`

Check if a domain has a valid DKIM (DomainKeys Identified Mail) DNS record for a given selector. DKIM allows the receiver to verify that an email was sent by the domain owner.

`dmarc_check`

Check if a domain has a valid DMARC (Domain-based Message Authentication, Reporting & Conformance) DNS record. DMARC tells receiving servers what to do with emails that fail SPF or DKIM checks.

`bimi_check`

Check if a domain has a valid BIMI (Brand Indicators for Message Identification) DNS record. BIMI allows brands to display their logo next to authenticated emails in supporting email clients.

`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 type ready to be added to DNS.

`smtp_check`

Test an SMTP server connection by attempting to connect and authenticate. If from_email and to_email are provided, the tool may attempt to send a test email. Only provide these fields if you are authorized to send from the account and intentionally want to test full sending capability.

`imap_check`

Test an IMAP server connection by attempting to connect and authenticate. Use this to verify email receiving configuration.

`smtp_finder`

Look up SMTP server settings (host, port, encryption) for a given email provider. Use this to find the correct SMTP configuration for services like Gmail, Outlook, SendGrid, etc.

`imap_finder`

Look up IMAP server settings (host, port, encryption) for a given email provider. Use this to find the correct IMAP configuration for services like Gmail, Outlook, Yahoo, etc.

`blacklist_check`

Check if a domain or IP address is listed in popular email blacklists (DNSBLs). Being blacklisted can severely impact email deliverability.

`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 other metadata.

`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 reputation.

`dns_lookup`

Look up all DNS records for a domain in one query. Returns A, AAAA, CNAME, MX, NS, TXT, and SOA records.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "type": "http",
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

McpServers

{
    "mailx": {
        "type": "http",
        "url": "https://themailx.com/mcp"
    }
}

MailX MCP

Official MCP server for MailX email deliverability tools — SPF, DKIM, DMARC, BIMI validation, domain/IP blacklist checks, SMTP/IMAP connectivity tests, DNS lookups (MX, TXT, CNAME, PTR, full A/AAAA/NS/SOA), and ready-to-deploy record generation for any major email provider.

This package is a thin stdio bridge to the hosted MCP server at https://themailx.com/mcp. All tool logic runs server-side; this is ~50 lines of passthrough glue so clients that want stdio (Claude Desktop, local agents) can use it without hand-wiring a remote URL.

> Prefer the remote URL directly? Skip this package — point any streamable-HTTP MCP client straight at https://themailx.com/mcp. See install guide for per-client JSON snippets.

Tools

- spf_check, dkim_check, dmarc_check, bimi_check — validate authentication records
- blacklist_check — check a domain or IP against popular DNSBLs
- smtp_check, imap_check — test mail server connectivity with credentials
- smtp_finder, imap_finder — look up server settings by provider name
- spf_generate, dmarc_generate — produce copy-pasteable DNS records
- mx_lookup, txt_lookup, cname_lookup, ptr_lookup, dns_lookup — DNS queries
- bimi_host — host a BIMI SVG for email authentication

Full catalog + live descriptions: themailx.com/mcp/docs

Install

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on your OS:

{
  "mcpServers": {
    "mailx": {
      "command": "npx",
      "args": ["-y", "@mailwarm/mailx-mcp"]
    }
  }
}

Claude Code

claude mcp add mailx -- npx -y @mailwarm/mailx-mcp

Cursor / Windsurf / VS Code / Zed

Same npx -y @mailwarm/mailx-mcp pattern — see your client's MCP config docs for the exact JSON shape. Full examples at themailx.com/mcp/docs.

Direct remote (no install)

If your client supports streamable-HTTP, point it at https://themailx.com/mcp directly — this bridge is only needed for stdio clients.

Configuration

Optional session preferences (set once in your MCP client config, applied to every call):

| Variable | Effect |
|---|---|
| default_dkim_selector | Default selector used by dkim_check when the call omits dkim_selector |
| preferred_provider | Default provider for spf_generate (google, mailgun, sendgrid, postmark, amazon-ses, outlook, zoho, fastmail) |
| dmarc_aggregate_email | Default rua= address for dmarc_generate |

Override the upstream URL (staging/self-hosting):

{
  "mcpServers": {
    "mailx": {
      "command": "npx",
      "args": ["-y", "@mailwarm/mailx-mcp"],
      "env": { "MAILX_MCP_URL": "https://tools-stg.themailx.com/mcp" }
    }
  }
}

Prompts

Two one-click slash commands ship with the server:

- audit-deliverability(domain) — full deliverability audit (SPF + DMARC + DKIM + blacklist) with copy-pasteable fixes
- setup-dns(domain, provider) — greenfield DNS setup, generates SPF + DMARC for the chosen provider

Links

- Homepage: themailx.com
- Full docs: themailx.com/mcp/docs
- Skills repo (Claude Code plugin marketplace): Mailwarm/mailx-skills
- Official MCP Registry: com.themailx/email-deliverability
- Smithery: mailwarm/mailx-tools
- llms.txt: themailx.com/llms.txt

License

MIT — see LICENSE

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

spf_check

dkim_check

dmarc_check

bimi_check

dmarc_generate

spf_generate

smtp_check

imap_check

smtp_finder

imap_finder

blacklist_check

mx_lookup

txt_lookup

cname_lookup

ptr_lookup

dns_lookup

Claude Desktop / Cursor

McpServers

MailX MCP

Tools

Install

Claude Desktop

Claude Code

Cursor / Windsurf / VS Code / Zed

Direct remote (no install)

Configuration

Prompts

Links

License

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright

`spf_check`

`dkim_check`

`dmarc_check`

`bimi_check`

`dmarc_generate`

`spf_generate`

`smtp_check`

`imap_check`

`smtp_finder`

`imap_finder`

`blacklist_check`

`mx_lookup`

`txt_lookup`

`cname_lookup`

`ptr_lookup`

`dns_lookup`