Skip to main content
Glama

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

Related MCP server: WolfTech DNS MCP Server

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

License

MIT — see LICENSE

Available Tools

17 tools
bimi_checkBIMI CheckA
Read-onlyIdempotent

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.

Inputs: domain_name (required).

bimi_hostBIMI HostA
Idempotent

Host and serve your BIMI SVG file for email authentication

Inputs: domain_name (required), bimi_file (required).

blacklist_checkBlacklist CheckA
Read-onlyIdempotent

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

Inputs: domain_name (required).

cname_lookupCNAME LookupA
Read-onlyIdempotent

Look up CNAME (Canonical Name) records for a domain. Shows where a hostname aliases to.

Inputs: domain_name (required).

dkim_checkDKIM CheckA
Read-onlyIdempotent

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.

Inputs: domain_name (required), dkim_selector (required).

dmarc_checkDMARC CheckA
Read-onlyIdempotent

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.

Inputs: domain_name (required).

dmarc_generateDMARC GeneratorA
Idempotent

Generate a DMARC DNS record for a domain. Returns the record name, value, and type ready to be added to DNS.

Inputs: domain_name (required), email (required), dmarc_policy (required).

dns_lookupDNS LookupA
Read-onlyIdempotent

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

Inputs: domain_name (required).

imap_checkIMAP CheckA
Read-onlyIdempotent

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

Inputs: imap_host (required), imap_port (required), username (required), password (required), +1 more.

imap_finderIMAP FinderA
Read-onlyIdempotent

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.

Inputs: imap_provider_name (required).

mx_lookupMX LookupA
Read-onlyIdempotent

Look up MX (Mail Exchanger) records for a domain. Returns the mail servers and their priorities.

Inputs: domain_name (required).

ptr_lookupPTR LookupA
Read-onlyIdempotent

Reverse DNS lookup. Find the hostname associated with an IP address. A valid PTR record is important for email sending reputation.

Inputs: ip_address (required).

smtp_checkSMTP CheckA
Read-onlyIdempotent

Test an SMTP server connection by attempting to connect and authenticate. Optionally sends a test email to verify full sending capability.

Inputs: host (required), port (required), username (required), password (required), +3 more.

smtp_finderSMTP FinderA
Read-onlyIdempotent

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.

Inputs: provider_name (required).

spf_checkSPF CheckB
Read-onlyIdempotent

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.

Inputs: domain_name (required).

spf_generateSPF GeneratorA
Idempotent

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.

Inputs: domain_name (required), provider (required), hard_fail_boolean (required).

txt_lookupTXT LookupA
Read-onlyIdempotent

Look up all TXT records for a domain. TXT records contain SPF policies, domain verification tokens, DKIM keys, and other metadata.

Inputs: domain_name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 17 tools

    Disambiguation5/5

    Each tool has a distinct purpose focused on specific email-related DNS checks, server testing, or configuration lookups. For example, dkim_check and spf_check target different authentication mechanisms, while imap_check and smtp_check test different server types, ensuring clear boundaries and no overlap.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern using snake_case, such as bimi_check, dmarc_generate, and smtp_finder. This uniformity makes the tool set predictable and easy to navigate, with no deviations in naming conventions.

    Tool Count4/5

    With 17 tools, the count is slightly high but reasonable for the comprehensive email diagnostics and configuration domain. It covers various aspects like DNS records, server checks, and lookups, though it might feel a bit heavy compared to more streamlined servers.

    Completeness5/5

    The tool set provides complete coverage for email infrastructure, including DNS-based authentication (SPF, DKIM, DMARC, BIMI), server testing (SMTP, IMAP), and lookup utilities (MX, CNAME, TXT). There are no obvious gaps, allowing agents to handle full email configuration and troubleshooting workflows.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP server for IntoDNS.ai providing 36 free tools for DNS, DMARC, SPF, DKIM, BIMI, DNSSEC, MTA-STS, FCrDNS, blacklist and email security checks. Citation-grade report snapshots with content hashes. No API key required.
      45
      156 npm
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      An MCP server that checks SPF, DKIM, DMARC, and MX records for a domain, returning a health verdict and specific DNS fixes to improve email deliverability.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Diagnoses a domain's email authentication — SPF, DMARC, DKIM, MX, blacklists and domain or SSL expiry - and returns copy-paste fix records generated by a validating engine, never a language model. The MCP server is hosted remotely; this repository carries the plugin manifest, connector config and bundled skill.
      27
      3
      Apache 2.0