# Mailcow MCP Server Documentation
## 📚 Documentation Overview
This directory contains comprehensive documentation for the Mailcow Model Context Protocol (MCP) server implementation.
## 📖 Table of Contents
### Core Documentation
- **[Architecture](ARCHITECTURE.md)** - System design and component overview
- **[Quick Start](QUICK_START.md)** - Get started in 5 minutes
- **[API Reference](API_REFERENCE.md)** - Complete API and tool documentation
- **[Configuration](CONFIGURATION.md)** - Environment setup and configuration options
- **[Testing Guide](TESTING.md)** - Testing framework and practices
### Implementation Details
- **[Tool Development](TOOL_DEVELOPMENT.md)** - How to create new MCP tools
- **[Email System](EMAIL_SYSTEM.md)** - Email sending and queue management
- **[Security](SECURITY.md)** - Security considerations and best practices
- **[Deployment](DEPLOYMENT.md)** - Production deployment guide
### Developer Resources
- **[Team Structure](TEAM_STRUCTURE.md)** - Parallel development workflow
- **[Contributing](CONTRIBUTING.md)** - How to contribute to the project
## 🚀 Quick Links
| Need to... | Go to... |
|-----------|----------|
| **Get started quickly** | [Quick Start](QUICK_START.md) |
| **Understand the architecture** | [Architecture](ARCHITECTURE.md) |
| **See available tools** | [API Reference](API_REFERENCE.md) |
| **Set up configuration** | [Configuration](CONFIGURATION.md) |
| **Run tests** | [Testing Guide](TESTING.md) |
| **Deploy to production** | [Deployment](DEPLOYMENT.md) |
## 📊 Current Status
- **Server Infrastructure**: 100% complete ✅
- **Domain Management**: 100% complete ✅
- **Mailbox Management**: 100% complete ✅
- **Queue Management**: 100% complete ✅
- **Email Sending**: 100% complete ✅
- **Log Management**: 100% complete ✅
- **Sync Job Management**: 100% complete ✅
### Available Tools: 20 MCP Tools
- **System Tools**: 3 (health check, config, API test)
- **Domain Tools**: 5 (list, get, create, update, delete)
- **Mailbox Tools**: 5 (list, get, create, update, delete)
- **Queue Tools**: 6 (list, get, flush, delete, hold, release)
- **Sync Job Tools**: 7 (list, get, create, update, delete, activate, deactivate)
- **Log Tools**: 4 (general, error, performance, access)
- **Email Tools**: 3 (send, check status, get templates)
## 🔗 External Resources
- **[MCP Specification](https://spec.modelcontextprotocol.io/)** - Official MCP protocol documentation
- **[Mailcow API Documentation](../mailcow_docs/)** - Local Mailcow API reference
- **[GitHub Repository](https://github.com/your-repo/mailcow-mcp)** - Source code and issues
