mxroute-cli 0.1.2 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # mxroute-cli
 
-A powerful CLI for managing [MXroute](https://mxroute.com) email hosting -- full account management, DNS verification, email sending, spam configuration, troubleshooting, and more via the DirectAdmin API.
+A comprehensive CLI and MCP server for managing [MXroute](https://mxroute.com) email hosting. Full account management, automated DNS configuration, email sending, spam control, security auditing, monitoring, and more -- all from your terminal.
 
 ```
    __  ____  __                _
@@ -12,65 +12,152 @@ A powerful CLI for managing [MXroute](https://mxroute.com) email hosting -- full
   Email Hosting Management CLI
 ```
 
+[![npm version](https://img.shields.io/npm/v/mxroute-cli)](https://www.npmjs.com/package/mxroute-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![CI](https://github.com/t-rhex/mxroute-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/t-rhex/mxroute-cli/actions)
+
+---
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Credentials](#credentials)
+- [Command Reference](#command-reference)
+  - [Core](#core)
+  - [Email Management](#email-management)
+  - [DNS Management](#dns-management)
+  - [Email Sending](#email-sending)
+  - [Spam and Security](#spam-and-security)
+  - [Monitoring and Operations](#monitoring-and-operations)
+  - [Data Management](#data-management)
+  - [Troubleshooting](#troubleshooting)
+  - [Connection Info](#connection-info)
+- [Configuration](#configuration)
+- [MCP Server](#mcp-server)
+- [Automated DNS Setup](#automated-dns-setup)
+- [Monitoring and Cron](#monitoring-and-cron)
+- [Shell Completions](#shell-completions)
+- [Development](#development)
+- [Requirements](#requirements)
+- [License](#license)
+
+---
+
 ## Features
 
-- **Full account management** -- domains, email accounts, forwarders, autoresponders, mailing lists, domain aliases
-- **DNS management** -- health checks (MX, SPF, DKIM, DMARC), record management via API, DKIM key retrieval, zone file generation
-- **Email sending** -- send emails via MXroute's SMTP API with interactive composer or CLI flags
-- **Spam control** -- SpamAssassin configuration, catch-all addresses, email filters
-- **Quota monitoring** -- disk usage, bandwidth, account counts with visual progress bars
-- **Troubleshooting** -- interactive wizard covering 10 common issue categories
-- **Connection reference** -- IMAP/SMTP/POP3 ports, webmail URLs, CalDAV/CardDAV setup, client guides
+- **41 command groups, 100+ subcommands** -- manage every aspect of MXroute from the terminal
+- **Automated DNS setup** -- configure MX, SPF, DKIM, and DMARC records via Cloudflare, Porkbun, DigitalOcean, or Namecheap APIs
+- **MCP server** -- 36 tools exposed via the Model Context Protocol for AI-assisted email management
+- **Security auditing** -- score your domains against DNS, SPF lookup count, catch-all, and forwarding loop checks
+- **Blacklist monitoring** -- check your server IP against 10 DNS blacklists
+- **Health monitoring** -- cron-friendly health checks with alert support
+- **Bulk operations** -- create accounts and forwarders from CSV files
+- **Export/import** -- back up and restore your entire configuration as JSON
+- **Email webhook** -- local HTTP server that relays email through MXroute SMTP
 - **Multi-profile support** -- manage multiple MXroute accounts from one CLI
 - **Secure config** -- credentials stored with `0600` permissions in `~/.config/mxroute-cli/`
 
-## Install
+---
+
+## Installation
 
 ```bash
 npm install -g mxroute-cli
 ```
 
+This installs two binaries:
+- `mxroute` -- the CLI
+- `mxroute-mcp` -- the MCP server
+
+---
+
 ## Quick Start
 
 ```bash
-# 1. Configure SMTP credentials (for sending email)
-mxroute config setup
+# 1. Run the interactive setup wizard
+mxroute setup
 
-# 2. Authenticate with DirectAdmin API (for account management)
-mxroute auth login
+# Or configure step by step:
+mxroute config setup          # SMTP credentials (for sending email)
+mxroute auth login            # DirectAdmin API auth (for account management)
 
-# 3. Check your DNS records
+# 2. Check your DNS records
 mxroute dns check
 
-# 4. View full account status dashboard
+# 3. View your account dashboard
 mxroute status
 ```
 
-### Getting Your Credentials
+**Example -- status dashboard:**
+```
+  ┌─ Account Status ────────────────────────────────────────┐
+  │  Profile          default                                │
+  │  Server           fusion.mxrouting.net                   │
+  │  Account          user@example.com                       │
+  │                                                          │
+  │  DNS Health                                              │
+  │  MX  ✔  SPF  ✔  DKIM  ✔  DMARC  ✔  CNAME  ●           │
+  │                                                          │
+  │  SMTP API         ✔ Connected                            │
+  └──────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Credentials
 
 The CLI uses two types of credentials:
 
 | Credential | Purpose | Where to find |
 |---|---|---|
-| **Server hostname** | Identifies your MXroute server | Control Panel (panel.mxroute.com) -> DNS section. Looks like `tuesday`, `fusion`, etc. |
-| **Email + password** | SMTP API (sending email) | Your email account credentials (same as email client login) |
+| **Server hostname** | Identifies your MXroute server | Control Panel -> DNS section (e.g., `tuesday`, `fusion`) |
+| **Email + password** | SMTP API (sending email) | Your email account credentials |
 | **DirectAdmin username** | API authentication | Your DirectAdmin login username |
-| **Login Key** | API authentication (recommended over password) | Control Panel -> Login Keys -> Create new key |
+| **Login Key** | API authentication (recommended) | Control Panel -> Login Keys -> Create new key |
 
-> **Why Login Keys?** They're more secure than passwords -- you can restrict permissions, set expiry dates, and revoke them without changing your password.
+> **Why Login Keys?** They are more secure than passwords -- you can restrict permissions, set expiry dates, and revoke them without changing your password.
+
+**Which commands need which credentials:**
+
+| Credential | Required for |
+|---|---|
+| **SMTP credentials** | `send`, `test`, `webhook`, `monitor` |
+| **DirectAdmin Login Key** | `domains`, `accounts`, `forwarders`, `autoresponder`, `catchall`, `spam`, `dnsrecords`, `filters`, `lists`, `aliases`, `quota`, `audit`, `doctor`, `export` |
+| **None** (server name only) | `dns check`, `dns records`, `dns generate`, `info`, `troubleshoot`, `ip` |
 
 ---
 
 ## Command Reference
 
-### Authentication
+### Core
+
+| Command | Description |
+|---|---|
+| `mxroute setup` | Interactive setup wizard -- configures CLI, MCP server, and skills |
+| `mxroute status` | Account dashboard with auth status, DNS health, and connectivity |
+| `mxroute whoami` | Quick account overview |
+| `mxroute open [target]` | Open MXroute panels in your browser |
+
+#### config -- Configuration Management
+
+```bash
+mxroute config setup           # Interactive configuration wizard
+mxroute config smtp            # Configure SMTP credentials
+mxroute config remove-smtp     # Remove SMTP credentials
+mxroute config show            # Show current config (passwords masked)
+mxroute config profiles        # List all saved profiles
+mxroute config switch [name]   # Switch between profiles
+mxroute config delete [name]   # Delete a profile
+```
 
-Authenticate with the DirectAdmin API to unlock account management commands.
+#### auth -- Authentication
 
 ```bash
-mxroute auth login          # Interactive login with Login Key
-mxroute auth status         # Verify stored credentials are valid
-mxroute auth logout         # Remove stored credentials
+mxroute auth login             # Interactive login with Login Key
+mxroute auth status            # Verify stored credentials are valid
+mxroute auth logout            # Remove stored credentials
 ```
 
 **Example:**
@@ -82,297 +169,332 @@ $ mxroute auth login
 ✔ Authentication successful!
 ```
 
-### Configuration & Profiles
+---
+
+### Email Management
+
+#### domains -- Domain Management
 
-Configure SMTP credentials for sending email. Supports multiple profiles for managing different accounts.
+```bash
+mxroute domains list                   # List all domains with alias counts
+mxroute domains info [domain]          # Show details for a domain
+```
+
+#### accounts -- Email Accounts
 
 ```bash
-mxroute config setup        # Interactive configuration wizard
-mxroute config show         # Show current active configuration
-mxroute config profiles     # List all saved profiles
-mxroute config switch       # Switch between profiles (interactive)
-mxroute config switch work  # Switch to a named profile
-mxroute config delete       # Delete a profile (interactive)
-mxroute config delete old   # Delete a named profile
+mxroute accounts list [domain]         # List email accounts
+mxroute accounts create [domain]       # Create an email account (interactive)
+mxroute accounts delete [domain]       # Delete an email account
+mxroute accounts passwd [domain]       # Change account password
 ```
 
-**Example -- multiple profiles:**
+**Example:**
 ```bash
-$ mxroute config setup      # Creates "default" profile
-$ mxroute config setup      # Enter "work" as profile name
-$ mxroute config switch     # Pick which profile to use
+$ mxroute accounts create example.com
+? Username (before @example.com): info
+? Password: ••••••••
+? Confirm password: ••••••••
+? Quota in MB (0 = unlimited): 0
+? Create info@example.com? Yes
+✔ Created info@example.com
 ```
 
-### Status Dashboard
+#### forwarders / fwd -- Email Forwarders
+
+```bash
+mxroute forwarders list [domain]       # List all forwarders
+mxroute forwarders create [domain]     # Create a forwarder (interactive)
+mxroute forwarders delete [domain]     # Delete a forwarder
+```
 
-Get a complete overview of your account in one command.
+#### autoresponder / vacation -- Autoresponders
 
 ```bash
-mxroute status              # Full dashboard: account info, DNS health, API test
-mxroute                     # Same as status (default command)
+mxroute autoresponder list [domain]    # List all autoresponders
+mxroute autoresponder create [domain]  # Create autoresponder (opens editor)
+mxroute autoresponder edit [domain]    # Edit existing autoresponder
+mxroute autoresponder delete [domain]  # Delete an autoresponder
 ```
 
-Shows: active profile, server, account, domain, DNS health scores for MX/SPF/DKIM/DMARC/CNAME, and SMTP API connectivity test.
+#### catchall -- Catch-All / Default Address
 
----
+```bash
+mxroute catchall get [domain]          # Show current catch-all setting
+mxroute catchall set [domain]          # Configure catch-all (interactive)
+```
 
-### Domains
+Options: forward to existing account, forward to custom email, reject (`:fail:`), or disable (`:blackhole:`).
 
-List and inspect domains on your MXroute account.
+#### filters -- Email Filters
 
 ```bash
-mxroute domains list                    # List all domains with alias counts
-mxroute domains info                    # Show details for configured domain
-mxroute domains info example.com        # Show details for specific domain
+mxroute filters list [domain]          # List filters for an account
+mxroute filters create [domain]        # Create a filter (interactive)
+mxroute filters delete [domain]        # Delete a filter
 ```
 
-### Email Accounts
+Supports matching on from, to, subject, or body with actions to discard, forward, or move to a folder.
 
-Create, list, delete, and manage passwords for email accounts.
+#### lists / mailinglist -- Mailing Lists
 
 ```bash
-mxroute accounts list                   # List accounts (prompts for domain if multiple)
-mxroute accounts list example.com       # List accounts for specific domain
-mxroute accounts create                 # Interactive account creation
-mxroute accounts create example.com     # Create account on specific domain
-mxroute accounts delete example.com     # Delete an account (picks from list)
-mxroute accounts passwd example.com     # Change password (picks from list)
+mxroute lists list [domain]            # List all mailing lists
+mxroute lists create [domain]          # Create a mailing list
+mxroute lists delete [domain]          # Delete a mailing list
+mxroute lists members [domain]         # Show members of a list
+mxroute lists add-member [domain]      # Add a member
+mxroute lists remove-member [domain]   # Remove a member
 ```
 
-Aliases: `accounts add` = `accounts create`, `accounts rm` = `accounts delete`, `accounts password` = `accounts passwd`
+#### aliases -- Domain Aliases / Pointers
 
-**Example -- creating an account:**
 ```bash
-$ mxroute accounts create example.com
-? Username (before @example.com): info
-? Password: ••••••••
-? Confirm password: ••••••••
-? Quota in MB (0 = unlimited): 0
-? Create info@example.com? Yes
-✔ Created info@example.com
+mxroute aliases list [domain]          # List domain aliases
+mxroute aliases add [domain]           # Add a domain alias
+mxroute aliases remove [domain]        # Remove a domain alias
 ```
 
-### Email Forwarders
+> **How aliases work:** If `primary.com` has `user@primary.com`, adding `alias.com` as a pointer means `user@alias.com` also works -- all accounts are shared.
 
-Redirect email from one address to another.
+#### quota -- Quota and Usage
 
 ```bash
-mxroute forwarders list [domain]        # List all forwarders
-mxroute forwarders create [domain]      # Create a forwarder (interactive)
-mxroute forwarders delete [domain]      # Delete a forwarder (picks from list)
+mxroute quota show                     # Account-wide usage overview
+mxroute quota set [domain]             # Set quota for a specific account
 ```
 
-Aliases: `fwd list`, `fwd create`, `fwd delete`; `forwarders add`, `forwarders rm`
+**Example output:**
+```
+  ┌─ Resource Usage ─────────────────────────────────────────────┐
+  │  Disk Usage         3.19MB / 100.0GB  [--------------------] 0%  │
+  │  Bandwidth          1.26MB / unlimited                           │
+  │  Email Accounts     12 / unlimited                               │
+  │  Domains            3 / unlimited                                │
+  │  Forwarders         1 / unlimited                                │
+  └──────────────────────────────────────────────────────────────────┘
+```
+
+---
 
-### Autoresponders / Vacation Messages
+### DNS Management
 
-Set up automatic replies for email accounts (e.g., "I'm out of office").
+#### dns -- DNS Health and Records
 
 ```bash
-mxroute autoresponder list [domain]     # List all autoresponders
-mxroute autoresponder create [domain]   # Create autoresponder (picks account, opens editor)
-mxroute autoresponder edit [domain]     # Edit existing autoresponder message
-mxroute autoresponder delete [domain]   # Delete an autoresponder
+mxroute dns check [domain]            # Health check via DNS lookup
+mxroute dns records [domain]          # Show required DNS records for your server
+mxroute dns generate [domain]         # Generate zone file for your DNS provider
+mxroute dns setup [domain]            # Auto-configure via registrar API
+mxroute dns watch [domain]            # Real-time DNS propagation monitoring
 ```
 
-Aliases: `vacation list`, `vacation create`, `vacation edit`, `vacation delete`
+**What `dns check` verifies:**
+- **MX** -- primary and relay records pointing to your MXroute server
+- **SPF** -- `v=spf1 include:mxroute.com -all` present with hard fail
+- **DKIM** -- `x._domainkey` TXT record with valid DKIM1 key
+- **DMARC** -- `_dmarc` TXT record with quarantine or reject policy
+- **CNAME** -- custom hostnames for mail/webmail (optional)
+
+**`dns generate` supports:** Cloudflare, Namecheap, Route53/AWS, and generic providers.
 
-### Catch-All / Default Address
+#### dnsrecords / dnsapi -- DNS Record Management via API
 
-Control what happens to email sent to non-existent addresses on your domain.
+Manage DNS records directly on your MXroute server. Requires authentication.
 
 ```bash
-mxroute catchall get [domain]           # Show current catch-all setting
-mxroute catchall set [domain]           # Configure catch-all (interactive)
+mxroute dnsrecords list [domain]       # List all DNS records from server
+mxroute dnsrecords add [domain]        # Add a record (A, AAAA, CNAME, MX, TXT, SRV)
+mxroute dnsrecords delete [domain]     # Delete a DNS record
+mxroute dnsrecords dkim [domain]       # Retrieve the full DKIM key
 ```
 
-**Catch-all options:**
-- **Forward to existing account** -- picks from your email accounts
-- **Forward to custom email** -- any external address
-- **Reject** (`:fail:`) -- bounce back to sender
-- **Disable** (`:blackhole:`) -- silently discard
+---
 
-### SpamAssassin
+### Email Sending
 
-Configure server-side spam filtering per domain.
+#### send -- Send Email via SMTP
 
 ```bash
-mxroute spam status [domain]            # Show current SpamAssassin config
-mxroute spam enable [domain]            # Enable with defaults (score 5, spam folder)
-mxroute spam disable [domain]           # Disable SpamAssassin
-mxroute spam config [domain]            # Interactive configuration wizard
+mxroute send                                                    # Interactive composer
+mxroute send -t user@example.com -s "Subject" -b "Body"        # Send with flags
+mxroute send -t user@example.com -s "Hi" --html -b "<h1>Hello</h1>"  # HTML email
+mxroute send -f alias@example.com -t user@example.com -s "Hi" -b "Body"  # Custom from
+mxroute send -t user@example.com -s "Report" --file report.pdf  # With attachment
 ```
 
-Aliases: `spam on` = `spam enable`, `spam off` = `spam disable`, `spam show` = `spam status`
+| Flag | Description |
+|---|---|
+| `-t, --to <email>` | Recipient email address |
+| `-s, --subject <text>` | Email subject line |
+| `-b, --body <text>` | Email body content |
+| `-f, --from <email>` | Sender address (defaults to configured account) |
+| `--html` | Treat body as raw HTML |
+| `--file <path>` | Attach a file |
 
-**`spam config` options:**
-- **Required score** (1-10) -- lower = more aggressive filtering
-- **Spam delivery** -- move to spam folder, leave in inbox, or delete
-- **High score threshold** -- separate action for very high scoring spam
-- **High score action** -- what to do with high-scoring spam
+#### test -- Test Email
 
-> **Note:** MXroute also has "Expert Spam Filtering" which is separate from SpamAssassin. Manage it at Management Panel -> Spam Filters.
+```bash
+mxroute test                           # Send a test email to yourself
+```
 
-### Email Filters
+#### webhook -- Email Webhook Server
 
-Create per-account email filtering rules (server-side).
+Start a local HTTP server that accepts POST requests and relays them as email through MXroute SMTP.
 
 ```bash
-mxroute filters list [domain]           # List filters (picks account)
-mxroute filters create [domain]         # Create a filter (interactive)
-mxroute filters delete [domain]         # Delete a filter (picks from list)
+mxroute webhook                        # Start on default port 3025
+mxroute webhook --port 8080            # Custom port
 ```
 
-**Filter options:**
-- **Match field**: from, to, subject, body
-- **Match type**: contains, equals, starts with, ends with
-- **Actions**: discard, forward to address, move to folder
+**Endpoints:**
+- `POST /send` -- send an email (`{ "to": "...", "subject": "...", "body": "..." }`)
+- `GET /health` -- health check
 
-### Mailing Lists
+---
 
-Create and manage mailing lists for group communication.
+### Spam and Security
+
+#### spam -- SpamAssassin Configuration
 
 ```bash
-mxroute lists list [domain]             # List all mailing lists
-mxroute lists create [domain]           # Create a new mailing list
-mxroute lists delete [domain]           # Delete a mailing list
-mxroute lists members [domain]          # Show members of a list
-mxroute lists add-member [domain]       # Add a member to a list
-mxroute lists remove-member [domain]    # Remove a member from a list
+mxroute spam status [domain]           # Show current SpamAssassin config
+mxroute spam enable [domain]           # Enable with defaults (score 5, spam folder)
+mxroute spam disable [domain]          # Disable SpamAssassin
+mxroute spam config [domain]           # Interactive configuration wizard
 ```
 
-Aliases: `mailinglist list`, `lists ls`, `lists add`, `lists rm`
+Configuration options: required score (1-10), spam delivery action (move to folder, leave in inbox, delete), high score threshold, and high score action.
 
-### Domain Aliases / Pointers
+#### audit -- Security Audit
 
-Make one domain share all email accounts with another domain.
+Run a comprehensive security audit across all domains with a scored report.
 
 ```bash
-mxroute aliases list [domain]           # List domain aliases/pointers
-mxroute aliases add [domain]            # Add a domain alias
-mxroute aliases remove [domain]         # Remove a domain alias
+mxroute audit                          # Full security audit with score
 ```
 
-> **How aliases work:** If `primary.com` has `user@primary.com`, adding `alias.com` as a pointer means `user@alias.com` will also work -- all accounts are shared.
+Checks: DNS configuration, SPF lookup count, catch-all settings, forwarding loops, and more.
 
-### Quota & Usage
+#### ip / blacklist -- IP Blacklist Check
 
-Monitor disk usage, bandwidth, and resource limits.
+```bash
+mxroute ip                             # Check server IP against 10 DNS blacklists
+```
+
+---
+
+### Monitoring and Operations
+
+#### monitor -- Health Monitoring
+
+Cron-friendly health check that tests DNS, port connectivity, and SMTP API across all domains.
 
 ```bash
-mxroute quota                           # Account-wide usage overview with progress bars
-mxroute quota-set [domain]              # Set quota for a specific email account
+mxroute monitor                        # Run health check with full output
+mxroute monitor --quiet                # Exit code only (0 = healthy, 1 = issue)
+mxroute monitor --alert                # Send email alert on failure
 ```
 
-**Example output:**
+#### cron -- Cron Job Management
+
+```bash
+mxroute cron setup                     # Install monitoring cron job
+mxroute cron remove                    # Remove monitoring cron job
 ```
-  ┌─ Resource Usage ─────────────────────────────────────────────┐
-  │  Disk Usage         3.19MB / 100.0GB  [--------------------] 0%  │
-  │  Bandwidth          1.26MB / unlimited                           │
-  │  Email Accounts     12 / unlimited                               │
-  │  Domains            3 / unlimited                                │
-  │  Forwarders         1 / unlimited                                │
-  └──────────────────────────────────────────────────────────────────┘
+
+#### doctor / healthcheck -- Comprehensive Diagnostics
+
+```bash
+mxroute doctor                         # Run checks across all domains
 ```
 
----
+#### benchmark / bench -- Connection Speed Test
 
-### DNS Management
+```bash
+mxroute benchmark                      # Test IMAP/SMTP connection speed
+```
 
-Two approaches to DNS: **health checks** (read-only, queries public DNS) and **record management** (read/write, via DirectAdmin API).
+---
 
-#### DNS Health Check
+### Data Management
 
-Verify your domain's DNS records are correctly configured for MXroute by querying public DNS servers.
+#### export -- Export Configuration
 
 ```bash
-mxroute dns check                       # Check configured domain
-mxroute dns check example.com           # Check specific domain
-mxroute dns records                     # Show required DNS records for your server
-mxroute dns records example.com         # Show for specific domain
-mxroute dns generate                    # Generate zone file (picks DNS provider)
-mxroute dns generate example.com        # Generate for specific domain
+mxroute export                         # Export all domains to JSON
+mxroute export example.com            # Export specific domain
 ```
 
-**What `dns check` verifies:**
-- **MX** -- primary and relay records pointing to your MXroute server
-- **SPF** -- `v=spf1 include:mxroute.com -all` present, single record, hard fail
-- **DKIM** -- `x._domainkey` TXT record with valid DKIM1 key
-- **DMARC** -- `_dmarc` TXT record with quarantine or reject policy
-- **CNAME** -- custom hostnames for mail/webmail (optional)
-
-**`dns generate` supports:**
-- Cloudflare (with proxy-off warning)
-- Namecheap
-- Route53 / AWS (with quoting notes)
-- Generic / other providers
+#### import -- Import Configuration
 
-#### DNS Records (via DirectAdmin API)
+```bash
+mxroute import backup.json            # Restore from export file
+```
 
-Manage DNS records directly on your MXroute server. Requires authentication (`mxroute auth login`).
+#### diff -- Compare Exports
 
 ```bash
-mxroute dnsrecords list [domain]        # List all DNS records from server
-mxroute dnsrecords add [domain]         # Add a record (A, AAAA, CNAME, MX, TXT, SRV)
-mxroute dnsrecords delete [domain]      # Delete a DNS record
-mxroute dnsrecords dkim [domain]        # Retrieve the full DKIM key for your domain
+mxroute diff before.json after.json   # Compare two export files
 ```
 
-Aliases: `dnsapi list`, `dnsapi add`, etc.
+#### bulk -- Bulk Operations
+
+```bash
+mxroute bulk accounts accounts.csv    # Create accounts from CSV
+mxroute bulk forwarders fwd.csv       # Create forwarders from CSV
+```
 
 ---
 
-### Send Email
+### Troubleshooting
 
-Send email via MXroute's SMTP API. Requires SMTP configuration (`mxroute config setup`).
+#### troubleshoot / diagnose -- Interactive Wizard
 
 ```bash
-mxroute send                                                    # Interactive composer (opens editor for body)
-mxroute send -t user@example.com -s "Subject" -b "Body text"   # Send with flags
-mxroute send -t user@example.com -s "Hi" --html -b "<h1>Hello</h1>"  # HTML body
-mxroute send -f alias@example.com -t user@example.com -s "Hi" -b "Body"  # Custom from
-mxroute test                                                     # Send a test email to yourself
+mxroute troubleshoot                   # Launch interactive wizard
 ```
 
-**Options:**
-| Flag | Description |
-|---|---|
-| `-t, --to <email>` | Recipient email address |
-| `-s, --subject <text>` | Email subject line |
-| `-b, --body <text>` | Email body content |
-| `-f, --from <email>` | Sender address (defaults to configured username) |
-| `--html` | Treat body as raw HTML (otherwise auto-wrapped) |
-
-**SMTP API limitations:**
-- 400 emails per hour per email address
-- Single recipient per request
-- No file attachments
-- Body size limit ~10MB
-- Marketing/promotional email is prohibited
+Covers 10 issue categories:
 
-### Connection Info
+1. Emails going to spam (Gmail)
+2. Emails going to spam (Microsoft)
+3. Cannot connect to server
+4. Authentication failures
+5. Emails not being delivered
+6. DNS configuration issues
+7. SSL certificate warnings
+8. Common error messages (550 Auth Required, Sender Verify Failed, etc.)
+9. Migration issues (imapsync guide)
+10. Spam filter blocking legitimate mail
 
-Quick reference for email client settings, webmail URLs, and service details.
+#### share -- Shareable Setup Page
 
 ```bash
-mxroute info connections                # IMAP/SMTP/POP3 ports table
-mxroute info webmail                    # Webmail URLs (Crossbox, Roundcube)
-mxroute info caldav                     # CalDAV/CardDAV server and setup guides
-mxroute info api                        # SMTP API endpoint, fields, and limits
-mxroute info limits                     # Service limits and policies
-mxroute info panels                     # Management and Control Panel URLs
-mxroute info all                        # Everything at once
+mxroute share                          # Generate setup page for terminal
+mxroute share user@example.com        # Generate for specific email
 ```
 
-**Email client setup guides:**
+Produces an HTML page or terminal output with connection details to share with end users.
+
+---
+
+### Connection Info
+
+Quick reference for email client settings and service details.
+
 ```bash
-mxroute info client ios                 # Apple Mail (iPhone/iPad)
-mxroute info client outlook             # Microsoft Outlook
-mxroute info client thunderbird         # Mozilla Thunderbird
-mxroute info client generic             # Generic IMAP/SMTP settings
+mxroute info connections               # IMAP/SMTP/POP3 ports table
+mxroute info webmail                   # Webmail URLs (Crossbox, Roundcube)
+mxroute info caldav                    # CalDAV/CardDAV setup
+mxroute info api                       # SMTP API endpoint and limits
+mxroute info limits                    # Service limits and policies
+mxroute info panels                    # Management and Control Panel URLs
+mxroute info all                       # Everything at once
+mxroute info client <name>            # Client setup guide (ios, outlook, thunderbird, generic)
 ```
 
-**Connection settings reference:**
+**Connection settings:**
 
 | Protocol | Port | Encryption | Recommended |
 |---|---|---|---|
@@ -384,64 +506,223 @@ mxroute info client generic             # Generic IMAP/SMTP settings
 | SMTP | 587 | STARTTLS | Alternative |
 | SMTP | 2525 | STARTTLS | If 587 blocked |
 
-### Troubleshooting
+---
+
+## Configuration
+
+Configuration is stored at `~/.config/mxroute-cli/config.json` with file permissions `0600` (owner-only read/write).
 
-Interactive troubleshooting wizard that walks you through diagnosing and fixing common issues.
+### Multiple Profiles
+
+Manage different MXroute accounts from one CLI:
+
+```bash
+# Create profiles
+mxroute config setup                   # First run creates "default" profile
+mxroute config setup                   # Enter "work" as profile name for second
+
+# Switch between them
+mxroute config switch                  # Interactive picker
+mxroute config switch work             # Switch directly by name
+mxroute config profiles                # List all profiles
+
+# Delete a profile
+mxroute config delete old              # Delete by name
+```
+
+---
+
+## MCP Server
+
+The `mxroute-mcp` binary exposes 36 tools via the [Model Context Protocol](https://modelcontextprotocol.io), allowing AI assistants to manage your MXroute account.
+
+### Supported Clients
+
+- Claude Code
+- Claude Desktop
+- Cursor
+- Windsurf
+- OpenCode
+- Cline
+- Continue.dev
+
+### Quick Setup
+
+The setup wizard auto-detects installed clients and configures them:
 
 ```bash
-mxroute troubleshoot                    # Launch interactive wizard
-mxroute diagnose                        # Alias
+mxroute setup
+```
+
+### Manual Configuration
+
+Add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "mxroute": {
+      "command": "mxroute-mcp",
+      "args": []
+    }
+  }
+}
 ```
 
-**Covers 10 issue categories:**
-1. **Emails going to spam (Gmail)** -- mail-tester, DNS checks, filter training, Postmaster Tools
-2. **Emails going to spam (Microsoft)** -- Microsoft-specific steps, SNDS reputation
-3. **Cannot connect to server** -- ports, firewall, ISP blocking, live connection test
-4. **Authentication failures** -- username format, password reset, encryption settings
-5. **Emails not being delivered** -- DNS check, sender verification, bounce analysis
-6. **DNS configuration issues** -- common mistakes checklist, live DNS check
-7. **SSL certificate warnings** -- CNAME setup, certificate request steps
-8. **Common error messages** -- 550 Auth Required, Sender Verify Failed, 5.7.515, etc.
-9. **Migration issues** -- imapsync command, step-by-step migration guide
-10. **Spam filter blocking legitimate mail** -- whitelist requests, filter toggle
+### Available MCP Tools
+
+The MCP server provides tools for domains, email accounts, forwarders, autoresponders, catch-all, spam config, DNS records, DKIM keys, email filters, mailing lists, domain aliases, quota management, sending email, and DNS health checks.
 
 ---
 
-## Configuration
+## Automated DNS Setup
 
-### Config file
+The `dns setup` command can automatically create all required MXroute DNS records at your registrar via API.
 
-Configuration is stored at `~/.config/mxroute-cli/config.json` with file permissions `0600` (owner-only read/write).
+### Supported Registrars
+
+| Registrar | API Support | Credentials Needed |
+|---|---|---|
+| **Cloudflare** | Full | API Token |
+| **Porkbun** | Full | API Key + Secret Key |
+| **DigitalOcean** | Full | API Token |
+| **Namecheap** | Limited | API Key + Username |
+
+### Usage
 
 ```bash
-mxroute config show                     # View current config (passwords masked)
+mxroute dns setup example.com
 ```
 
-### Two credential types
+The wizard will:
+1. Ask which registrar manages your DNS
+2. Prompt for API credentials (saved for reuse)
+3. Retrieve your DKIM key from the server
+4. Create MX, SPF, DKIM, and DMARC records automatically
+5. Verify the records propagated correctly
 
-| Type | Used for | Command | Required for |
-|---|---|---|---|
-| **SMTP credentials** | Sending email | `mxroute config setup` | `send`, `test` |
-| **DirectAdmin Login Key** | Account management | `mxroute auth login` | `domains`, `accounts`, `forwarders`, `autoresponder`, `catchall`, `spam`, `dnsrecords`, `filters`, `lists`, `aliases`, `quota` |
+### Propagation Monitoring
 
-Commands that only read public DNS (`dns check`, `dns records`, `dns generate`) and display static info (`info`, `troubleshoot`) work without any credentials -- just a server name.
+After making DNS changes, watch propagation in real time:
 
-### Multiple profiles
+```bash
+mxroute dns watch example.com
+```
 
-Manage different MXroute accounts from one CLI:
+---
+
+## Monitoring and Cron
+
+### Health Monitoring
+
+The `monitor` command checks DNS records, port connectivity (IMAP/SMTP), and SMTP API health across all your domains.
 
 ```bash
-# Create profiles
-mxroute config setup                    # First run creates "default" profile
-mxroute config setup                    # Enter "work" as profile name for second
+# Full output
+mxroute monitor
 
-# Switch between them
-mxroute config switch                   # Interactive picker
-mxroute config switch work              # Switch by name
-mxroute config profiles                 # List all profiles
+# Silent mode for cron (exit code only)
+mxroute monitor --quiet
 
-# Delete a profile
-mxroute config delete old               # Delete by name
+# Send email alert on failure
+mxroute monitor --alert
+```
+
+### Cron Job Setup
+
+Install automatic monitoring that runs on a schedule:
+
+```bash
+# Install the cron job
+mxroute cron setup
+
+# Remove the cron job
+mxroute cron remove
+```
+
+---
+
+## Shell Completions
+
+Generate shell completion scripts for tab completion of commands and options.
+
+```bash
+mxroute completions bash               # Bash completions
+mxroute completions zsh                # Zsh completions
+mxroute completions fish               # Fish completions
+```
+
+**Install for your shell:**
+
+```bash
+# Bash
+mxroute completions bash >> ~/.bashrc
+
+# Zsh
+mxroute completions zsh >> ~/.zshrc
+
+# Fish
+mxroute completions fish > ~/.config/fish/completions/mxroute.fish
+```
+
+---
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/t-rhex/mxroute-cli.git
+cd mxroute-cli
+npm install
+npm run build
+```
+
+### Scripts
+
+| Script | Description |
+|---|---|
+| `npm run build` | Compile TypeScript |
+| `npm run dev` | Watch mode for development |
+| `npm test` | Run tests (Vitest) |
+| `npm run test:watch` | Run tests in watch mode |
+| `npm run test:coverage` | Run tests with coverage |
+| `npm run lint` | Lint with ESLint |
+| `npm run lint:fix` | Auto-fix lint issues |
+| `npm run format` | Format with Prettier |
+| `npm run typecheck` | Type check without emitting |
+| `npm run ci` | Full CI pipeline (lint + typecheck + build + test) |
+
+### Test Suite
+
+78 tests across 15 test files covering API, audit, benchmark, blacklist, CLI, completions, config, diff, DirectAdmin, DNS, MCP, monitor, share, theme, and webhook functionality.
+
+### Code Quality
+
+- ESLint and Prettier enforce consistent style
+- Husky pre-commit hooks run lint-staged on every commit
+- GitHub Actions CI validates on Node.js 20 and 22
+- Tag-based release workflow publishes to npm with provenance
+
+### Project Structure
+
+```
+src/
+  index.ts              # CLI entry point (Commander.js)
+  mcp.ts                # MCP server entry point
+  commands/             # 35 command modules
+  utils/                # Shared utilities (API, config, DNS, DirectAdmin, registrars)
+tests/                  # 15 test files (Vitest)
+```
+
+### Releasing
+
+Releases are automated via GitHub Actions. Push a version tag to trigger npm publish:
+
+```bash
+npm run release              # Patch version bump
+npm run release:minor        # Minor version bump
+npm run release:major        # Major version bump
 ```
 
 ---
@@ -454,9 +735,11 @@ mxroute config delete old               # Delete by name
 | **Control Panel** | https://panel.mxroute.com | Email accounts, forwarders, domains, DNS, spam, webmail |
 | **Whitelist Request** | https://whitelistrequest.mxrouting.net | Request IP/domain whitelist for spam filter |
 
+---
+
 ## Requirements
 
-- Node.js >= 18
+- Node.js >= 20
 - An [MXroute](https://mxroute.com) email hosting account
 
 ## License