Mailx Tools
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 recordsblacklist_check— check a domain or IP against popular DNSBLssmtp_check,imap_check— test mail server connectivity with credentialssmtp_finder,imap_finder— look up server settings by provider namespf_generate,dmarc_generate— produce copy-pasteable DNS recordsmx_lookup,txt_lookup,cname_lookup,ptr_lookup,dns_lookup— DNS queriesbimi_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 fixessetup-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
Server Config
{
"mcpServers": {
"mailx": {
"type": "http",
"url": "https://themailx.com/mcp"
}
}
}