# 1. Install dependencies
npm install

# 2. Configure environment  
cp .env.example .env
# Edit .env with your Mailcow server details

# 3. Start the server
npm run build && npm start

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   AI Models     │    │   MCP Client    │    │   Your App      │
│   (Claude, etc) │◄──►│   (Claude CLI)  │◄──►│   Integration   │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                                │
                                ▼
                       ┌─────────────────┐
                       │  MCP Protocol   │
                       │   (JSON-RPC)    │
                       └─────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                    Mailcow MCP Server                           │
│  ┌───────────────┐ ┌───────────────┐ ┌───────────────────────┐  │
│  │ Tool Registry │ │ Auth Manager  │ │   20 MCP Tools        │  │
│  │ & Validation  │ │ & Security    │ │ • Domain Management   │  │
│  │               │ │               │ │ • Mailbox Management  │  │
│  │               │ │               │ │ • Email & Queues      │  │
│  └───────────────┘ └───────────────┘ └───────────────────────┘  │
│                                │                                │
│                                ▼                                │  
│                    ┌───────────────────────┐                    │
│                    │     API Client        │                    │
│                    │   (HTTP + Auth)       │                    │
│                    └───────────────────────┘                    │
└─────────────────────────────────────────────────────────────────┘
                                │
                                ▼
                       ┌─────────────────┐
                       │  Mailcow Server │
                       │   REST API      │
                       └─────────────────┘

# Development mode with auto-reload
npm run dev

# Run tests
npm test

# View test coverage
npm run test:coverage

# Lint and format
npm run lint
npm run format

# Build for production
npm run build

// Send welcome email with template
const result = await mcp.call('send_email', {
  from: 'admin@company.com',
  to: ['user@company.com'],
  subject: 'Welcome to our service!',
  body: 'Your account is ready to use.',
  body_type: 'plain'
});

// Check delivery status  
await mcp.call('check_email_status', { 
  queue_id: result.email_details.queue_id 
});

// List all active domains
const domains = await mcp.call('list_domains', { 
  active_only: true 
});

// Create new domain
await mcp.call('create_domain', {
  domain: 'newclient.com', 
  description: 'New client domain',
  quota: 5368709120  // 5GB
});

// Check server health
const health = await mcp.call('health_check');

// Get recent error logs
const errors = await mcp.call('get_error_logs', {
  limit: 50,
  start_time: '2023-12-01T00:00:00.000Z'
});