Mailx Tools

by Mailwarm

248 downloads

Not rated

GitHub

Other

About

Email deliverability tools for AI agents. Check SPF, DKIM, DMARC, BIMI, blacklists, SMTP/IMAP connectivity, and generate DNS records.

Details

Author: Mailwarm
Downloads: 248
Categories: Other

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": {
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

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

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "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": {
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

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

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "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": {
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

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

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "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": {
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

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

JSON

{
    "mcpServers": {
        "mailx tools": {
            "mailx": {
                "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": {
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

JSON

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

JSON

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

From the repository

Install the mailx-skills plugin in Claude Code with /plugin marketplace add Mailwarm/mailx-skills then /plugin install email-deliverability@mailx-skills. For Claude.ai, download the SKILL.md file and upload it under Settings → Skills. You must also configure the MailX MCP server endpoint (https://tools.themailx.com/mcp) in your MCP client.

`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": {
                "url": "https://themailx.com/mcp"
            }
        }
    }
}

McpServers

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

MailX Skills

Free Agent Skills from MailX that teach AI agents how to diagnose and fix email deliverability issues using the MailX MCP server.

> What's a Skill? A SKILL.md file with workflow instructions an AI agent loads on demand. The format is an open standard adopted by Anthropic (Claude) and OpenAI (Codex CLI, ChatGPT). Learn more at agentskills.io.

Available Skills

email-deliverability

Diagnoses and fixes email deliverability issues by checking SPF, DKIM, DMARC, BIMI records, blacklist status, and SMTP/IMAP server connectivity. Generates DNS records for email authentication.

Activates when the user asks about: email going to spam, domain reputation, DNS authentication setup, mail server configuration, sender verification, or email infrastructure troubleshooting.

Installation

Claude Code (recommended)

/plugin marketplace add Mailwarm/mailx-skills
/plugin install email-deliverability@mailx-skills

That's it. The skill activates automatically when relevant.

Claude.ai

1. Download SKILL.md
2. Go to Claude.ai → Settings → Skills
3. Upload the file and enable it

Claude API

curl -X POST https://api.anthropic.com/v1/skills \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-beta: skills-2025-10-02" \
  -F "display_title=Email Deliverability" \
  -F "files[]=@plugins/email-deliverability/skills/email-deliverability/SKILL.md"

Then reference the returned skill_id when calling the Messages API.

Requirements

The skill requires the MailX MCP server for the actual tool execution. To install the MCP server in Claude Desktop / Cursor / Claude Code:

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

Full setup guide: tools.themailx.com/mcp/docs

What the agent can do once installed

- Audit a domain's email deliverability — checks SPF, DKIM, DMARC, BIMI, and blacklists in one shot
- Generate DNS records — produces ready-to-paste SPF and DMARC records for any provider
- Diagnose mail server issues — tests SMTP and IMAP connections with credentials
- Look up provider settings — finds SMTP and IMAP configs for Gmail, Outlook, SendGrid, Mailgun, etc.

Repository Structure

mailx-skills/
├── .claude-plugin/
│   └── marketplace.json                              ← Claude Code marketplace catalog
└── plugins/
    └── email-deliverability/
        ├── .claude-plugin/
        │   └── plugin.json                           ← Plugin manifest
        └── skills/
            └── email-deliverability/
                ├── SKILL.md                          ← The skill content
                └── references/
                    └── diagnosis.md                  ← Diagnosis decision tree

Versioning

The current SKILL.md is dynamically generated from the live MailX tool catalog at tools.themailx.com/skills/email-deliverability/SKILL.md. This repo is the static, versioned distribution snapshot used by Claude Code marketplace installs.

License

MIT — see LICENSE

Links

- MailX Tools: tools.themailx.com
- MCP Integration Docs: tools.themailx.com/mcp/docs
- Live SKILL.md: tools.themailx.com/skills/email-deliverability/SKILL.md
- Skill discovery: tools.themailx.com/.well-known/skills.json
- Agent Skills spec: agentskills.io

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 Skills

Available Skills

email-deliverability

Installation

Claude Code (recommended)

Claude.ai

Claude API

Requirements

What the agent can do once installed

Repository Structure

Versioning

License

Links

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

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