{"$schema":"https:\/\/modelcontextprotocol.io\/schemas\/server-card\/v1.0","version":"1.0","protocolVersion":"2025-11-25","serverInfo":{"name":"mailx-deliverability","title":"mailx-tools","version":"1.0.0","description":"Email deliverability tools for AI agents. Check SPF, DKIM, DMARC, BIMI, blacklists, SMTP\/IMAP connectivity, and generate DNS records.","homepage":"https:\/\/themailx.com","websiteUrl":"https:\/\/themailx.com"},"transport":{"type":"streamable-http","url":"https:\/\/themailx.com\/mcp"},"authentication":{"required":false,"schemes":[]},"capabilities":{"tools":{"listChanged":true},"resources":{},"prompts":{"listChanged":false}},"tools":[{"name":"spf_check","title":"SPF Check","description":"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.","inputSchema":{"type":"object","properties":{"domain_name":{"type":"string","description":"The domain to check SPF records for, e.g. example.com"}},"required":["domain_name"]},"annotations":{"title":"SPF Check","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dkim_check","title":"DKIM Check","description":"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.","inputSchema":{"type":"object","properties":{"domain_name":{"type":"string","description":"The domain to check DKIM records for, e.g. example.com"},"dkim_selector":{"type":"string","description":"The DKIM selector to look up, e.g. google, default, selector1"}},"required":["domain_name","dkim_selector"]},"annotations":{"title":"DKIM Check","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dmarc_check","title":"DMARC Check","description":"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.","inputSchema":{"type":"object","properties":{"domain_name":{"type":"string","description":"The domain to check DMARC records for, e.g. example.com"}},"required":["domain_name"]},"annotations":{"title":"DMARC Check","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"bimi_check","title":"BIMI Check","description":"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.","inputSchema":{"type":"object","properties":{"domain_name":{"type":"string","description":"The domain to check BIMI records for, e.g. example.com"}},"required":["domain_name"]},"annotations":{"title":"BIMI Check","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dmarc_generate","title":"DMARC Generator","description":"Generate a DMARC DNS record for a domain. Returns the record name, value, and type ready to be added to DNS.","inputSchema":{"type":"object","properties":{"domain_name":{"type":"string","description":"The domain to generate a DMARC record for, e.g. example.com"},"email":{"type":"string","description":"The email address to receive DMARC aggregate reports, e.g. dmarc@example.com"},"dmarc_policy":{"type":"string","description":"The DMARC policy: none (monitor only), quarantine (mark as spam), or reject (block entirely)","enum":["none","quarantine","reject"]}},"required":["domain_name","email","dmarc_policy"]},"annotations":{"title":"DMARC Generator","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"spf_generate","title":"SPF Generator","description":"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.","inputSchema":{"type":"object","properties":{"domain_name":{"type":"string","description":"The domain to generate an SPF record for, e.g. example.com"},"provider":{"type":"string","description":"The mail provider identifier, e.g. google, mailgun, sendgrid, postmark, amazon-ses"},"hard_fail_boolean":{"type":"boolean","description":"If true, uses strict -all policy (reject unauthorized senders). If false, uses soft ~all (mark but deliver)."}},"required":["domain_name","provider","hard_fail_boolean"]},"annotations":{"title":"SPF Generator","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"smtp_check","title":"SMTP Check","description":"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.","inputSchema":{"type":"object","properties":{"host":{"type":"string","description":"The SMTP server hostname, e.g. smtp.gmail.com"},"port":{"type":"integer","description":"The SMTP port number, e.g. 587 for TLS, 465 for SSL, 25 for unencrypted","minimum":1,"maximum":65535},"username":{"type":"string","description":"The SMTP username for authentication"},"password":{"type":"string","description":"The SMTP password or app-specific password"},"encryption":{"type":"string","description":"The encryption protocol: ssl, tls, or none","enum":["ssl","tls","none"]},"from_email":{"type":"string","description":"Optional sender email address for sending a test email"},"to_email":{"type":"string","description":"Optional recipient email address for sending a test email"}},"required":["host","port","username","password","encryption"]},"annotations":{"title":"SMTP Check","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"imap_check","title":"IMAP Check","description":"Test an IMAP server connection by attempting to connect and authenticate. Use this to verify email receiving configuration.","inputSchema":{"type":"object","properties":{"imap_host":{"type":"string","description":"The IMAP server hostname, e.g. imap.gmail.com"},"imap_port":{"type":"integer","description":"The IMAP port number, e.g. 993 for SSL, 143 for unencrypted","minimum":1,"maximum":65535},"username":{"type":"string","description":"The IMAP username for authentication"},"password":{"type":"string","description":"The IMAP password or app-specific password"},"imap_encryption":{"type":"string","description":"The encryption protocol: ssl, tls, or none","enum":["ssl","tls","none"]}},"required":["imap_host","imap_port","username","password","imap_encryption"]},"annotations":{"title":"IMAP Check","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"smtp_finder","title":"SMTP Finder","description":"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.","inputSchema":{"type":"object","properties":{"provider_name":{"type":"string","description":"The email provider name to look up, e.g. gmail, sendgrid, mailgun, outlook"}},"required":["provider_name"]},"annotations":{"title":"SMTP Finder","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"imap_finder","title":"IMAP Finder","description":"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.","inputSchema":{"type":"object","properties":{"imap_provider_name":{"type":"string","description":"The email provider name to look up, e.g. gmail, outlook, yahoo"}},"required":["imap_provider_name"]},"annotations":{"title":"IMAP Finder","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"blacklist_check","title":"Blacklist Check","description":"Check if a domain or IP address is listed in popular email blacklists (DNSBLs). Being blacklisted can severely impact email deliverability.","inputSchema":{"type":"object","properties":{"domain_name":{"type":"string","description":"The domain name or IP address to check against blacklists, e.g. example.com or 1.2.3.4"}},"required":["domain_name"]},"annotations":{"title":"Blacklist Check","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"mx_lookup","title":"MX Lookup","description":"Look up MX (Mail Exchanger) records for a domain. Returns the mail servers and their priorities.","inputSchema":{"type":"object","properties":{"domain_name":{"type":"string","description":"The domain to look up MX records for, e.g. example.com"}},"required":["domain_name"]},"annotations":{"title":"MX Lookup","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"txt_lookup","title":"TXT Lookup","description":"Look up all TXT records for a domain. TXT records contain SPF policies, domain verification tokens, DKIM keys, and other metadata.","inputSchema":{"type":"object","properties":{"domain_name":{"type":"string","description":"The domain to look up TXT records for, e.g. example.com"}},"required":["domain_name"]},"annotations":{"title":"TXT Lookup","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"cname_lookup","title":"CNAME Lookup","description":"Look up CNAME (Canonical Name) records for a domain. Shows where a hostname aliases to.","inputSchema":{"type":"object","properties":{"domain_name":{"type":"string","description":"The domain to look up CNAME records for, e.g. www.example.com"}},"required":["domain_name"]},"annotations":{"title":"CNAME Lookup","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"ptr_lookup","title":"PTR Lookup","description":"Reverse DNS lookup. Find the hostname associated with an IP address. A valid PTR record is important for email sending reputation.","inputSchema":{"type":"object","properties":{"ip_address":{"type":"string","description":"The IP address to look up, e.g. 8.8.8.8 or 142.250.80.46"}},"required":["ip_address"]},"annotations":{"title":"PTR Lookup","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dns_lookup","title":"DNS Lookup","description":"Look up all DNS records for a domain in one query. Returns A, AAAA, CNAME, MX, NS, TXT, and SOA records.","inputSchema":{"type":"object","properties":{"domain_name":{"type":"string","description":"The domain to look up all DNS records for, e.g. example.com"}},"required":["domain_name"]},"annotations":{"title":"DNS Lookup","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}}],"resources":[{"uri":"mailx:\/\/skills\/email-deliverability","name":"email-deliverability-skill","title":"Email Deliverability Skill","description":"Guide for diagnosing and fixing email deliverability: SPF, DKIM, DMARC, BIMI, blacklists, SMTP\/IMAP. Includes audit workflow, DNS setup, and troubleshooting.","mimeType":"text\/markdown"},{"uri":"mailx:\/\/skills\/email-deliverability\/diagnosis","name":"email-deliverability-diagnosis","title":"Deliverability Diagnosis Reference","description":"Detailed reference for interpreting combined SPF\/DKIM\/DMARC\/blacklist results and mapping failures to fixes per provider.","mimeType":"text\/markdown"}],"prompts":[{"name":"audit-deliverability","title":"Audit Email Deliverability","description":"Run a full deliverability audit on a domain: SPF, DMARC, DKIM, and blacklist checks. Produces a pass\/fail summary with copy-pasteable fixes.","arguments":[{"name":"domain","description":"The domain to audit, e.g. example.com","required":true},{"name":"dkim_selector","description":"DKIM selector to check (optional). Defaults to common selectors if omitted: google, selector1, selector2, k1, default.","required":false}]},{"name":"setup-dns","title":"Set Up Email Authentication DNS","description":"Generate SPF and DMARC DNS records for a domain based on its email provider, with copy-pasteable values ready to add to DNS.","arguments":[{"name":"domain","description":"The domain to configure, e.g. example.com","required":true},{"name":"provider","description":"The email provider identifier, e.g. google, mailgun, sendgrid, postmark, amazon-ses","required":true}]}],"configSchema":{"type":"object","properties":{"default_dkim_selector":{"type":"string","title":"Default DKIM Selector","description":"Default selector used by dkim_check when the call omits dkim_selector. Common values: google, selector1, selector2, k1, default.","examples":["google","selector1","k1"],"x-from":{"query":"default_dkim_selector"}},"preferred_provider":{"type":"string","title":"Preferred Email Provider","description":"Default provider used by spf_generate and the setup-dns prompt when the call omits provider.","enum":["google","mailgun","sendgrid","postmark","amazon-ses","outlook","zoho","fastmail"],"x-from":{"query":"preferred_provider"}},"dmarc_aggregate_email":{"type":"string","format":"email","title":"DMARC Aggregate Report Email","description":"Default rua= address used by dmarc_generate when the call omits email.","examples":["dmarc@example.com"],"x-from":{"query":"dmarc_aggregate_email"}}},"required":[],"additionalProperties":false},"exampleConfig":{"default_dkim_selector":"google","preferred_provider":"google","dmarc_aggregate_email":"dmarc@example.com"}}