# MailX - Email Deliverability Tools

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

## MCP Server

MailX exposes all tools via MCP (Model Context Protocol) for AI agent integration.

- Endpoint: https://tools.themailx.com/mcp
- Transport: Streamable HTTP (POST with JSON-RPC 2.0)
- Discovery: https://tools.themailx.com/.well-known/mcp.json

### Client Configuration

Claude Desktop / Cursor:
```json
{
  "mcpServers": {
    "mailx": {
      "type": "streamable-http",
      "url": "https://tools.themailx.com/mcp"
    }
  }
}
```

## Available Tools

- 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. Optionally sends a test email to verify 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.
- 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 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.

## Agent Skills

MailX exposes a dynamic Agent Skill that teaches AI agents how and when to use these tools.

- Skill index: https://tools.themailx.com/.well-known/skills.json
- Email Deliverability skill: https://tools.themailx.com/skills/email-deliverability/SKILL.md
- Diagnosis reference: https://tools.themailx.com/skills/email-deliverability/references/diagnosis.md

## API

All tools are also available as direct HTTP POST endpoints:

- Base: https://tools.themailx.com/api/v1/{tool-endpoint}
- Content-Type: application/json
- No authentication required

## Links

- Website: https://tools.themailx.com
- MCP Discovery: https://tools.themailx.com/.well-known/mcp.json
- Skills Index: https://tools.themailx.com/.well-known/skills.json