Cbrown35/20i-MCP

20i MCP Server 🚀

The first and only Model Context Protocol (MCP) server for 20i web hosting services

Transform your 20i hosting management experience with AI-powered administration. This groundbreaking MCP server enables natural language interactions with your 20i hosting infrastructure through Claude, ChatGPT, and other AI assistants.

🆕 What's New - v1.6.0 COMPREHENSIVE RELEASE

🎉 MILESTONE RELEASE: Near-Complete API Coverage Achieved!

• 🏆 COMPREHENSIVE COVERAGE: 303 specialized tools covering 90.0% of 20i API functionality (303/335 endpoints)
• 🖥️ VPS Management: Complete server infrastructure control (22 endpoints)
• 🗄️ Database Services: Full MSSQL management with backup/restore (16 tools)
• 🔒 SSL Automation: Complete certificate lifecycle management (11 tools)
• 📦 Package Administration: Full service provisioning control (9 tools)
• 📧 Advanced Email: Premium email services with DKIM/DMARC (15 tools)
• 🛡️ Security & Monitoring: Enhanced protection and compliance (10 tools)
• 🌐 DNS & Domain Advanced: Enterprise DNS capabilities (20 tools)
• 💾 Backup & Recovery: Comprehensive data protection (10 tools)
• ⚙️ Platform Tools: Windows/IIS and automation (12 tools)

The MCP server now supports 303 comprehensive tools including:

• 🌐 Subdomain Management: Create, remove, and list subdomains with simple commands
• 🗄️ Database Operations: Create MySQL databases and users for your applications
• 📧 Email Account Creation: Set up email accounts and forwarders directly
• ⚙️ PHP Version Control: Get and set PHP versions for optimal compatibility
• 🚀 Application Installation: Install WordPress, Joomla, and other applications instantly
• 📁 FTP & File Management: Create FTP users and manage directory structures
• ⚡ WordPress Management: Complete WordPress automation, plugin/theme control, staging environments
• 🚀 CDN Management: Content delivery optimization, cache control, security headers
• 💾 Backup/Restore Management: Timeline snapshots, data protection, multisite backups
• 🔒 Advanced Security Management: IP/country blocking, malware scanning, premium SSL certificates

🎯 Why This Matters

For 20i Customers:

• Manage hosting services through natural language conversations
• Reduce complex API interactions to simple chat commands
• Streamline domain, hosting, and DNS management workflows
• Enable non-technical users to perform advanced hosting operations

For 20i:

• First-to-market AI integration in the hosting industry
• Differentiate from competitors with cutting-edge AI capabilities
• Reduce support burden through self-service AI assistance
• Attract tech-savvy customers and developers

✨ Features

🏢 Reseller Account Management

• Real-time account overview and statistics
• Monitor usage, limits, and billing information
• Track performance metrics across your infrastructure

🌐 Domain Management

• List and search all domains in your portfolio
• Get detailed domain information and status
• Monitor expiration dates and renewal requirements
• Automated domain health checks

🖥️ Hosting Package Administration

• Create hosting packages with natural language descriptions
• Monitor hosting package performance and usage
• Scale resources based on demand
• Automated provisioning and deployment
• Create and manage subdomains for organized site structure
• Set PHP versions for optimal application compatibility
• Install applications like WordPress with one command

☁️ Cloud Server Operations

• Deploy cloud servers across multiple providers
• Monitor server health and performance
• Scale infrastructure based on requirements
• Automated backup and recovery operations

🔧 DNS Management

• View and modify DNS records through conversation
• Bulk DNS operations and migrations
• Automated DNS health monitoring
• Advanced DNS configuration management

📧 Premium Email Services

• Order and manage premium mailbox subscriptions
• Renew existing premium email services
• Generate single sign-on webmail URLs
• Monitor email service usage and billing

📮 Email Configuration Management

• Configure email settings for hosting packages
• Manage mailbox configurations and quotas
• Set up and modify email forwarding rules
• Monitor email infrastructure health
• Create email accounts directly through conversation
• Set up email forwarders with multiple destinations

🗃️ Database Management

• Create MySQL databases for applications
• Set up MySQL users with proper permissions
• List and monitor existing databases
• Manage database access and security

📁 File and Access Management

• Create FTP users for team access
• Manage directories (create/delete)
• Control file access permissions
• Monitor file usage and organization

💰 Account & Billing Management

• Check account balance and billing status
• Monitor account overview and statistics
• Track API usage and limits
• View reseller account information

⚡ WordPress Management

• NEW: Complete WordPress automation with 15 tools
• Check WordPress installation status and version
• Manage plugins: activate, deactivate, remove, install StackCache
• Theme management: switch themes, remove unused themes
• WordPress staging environments: clone live to staging and vice versa
• User management: list administrators and users
• Configuration management: get/set WordPress settings
• Search and replace operations for migrations
• One-click WordPress updates and reinstallation

🚀 CDN Management

• NEW: Complete CDN automation with 15 tools
• CDN feature configuration and management
• Cache control: get reports, purge cache by URL
• StackCache performance optimization policies
• Security headers management for enhanced protection
• Traffic distribution analytics by country
• Website Turbo service assignment and credit management
• Bandwidth statistics and monitoring
• Performance optimization through CDN features

💾 Backup/Restore Management

• NEW: Complete data protection with 11 tools
• Timeline storage management and snapshot creation
• Web and database snapshot restoration with precise control
• FTP backup restoration and job monitoring
• Multisite backup management across multiple packages
• VPS backup service configuration
• Automated backup job status tracking
• Point-in-time recovery capabilities

🔒 Advanced Security Management

• NEW: Complete security control with 13 tools
• IP address blocking and allowlisting for traffic control
• Country-based access restrictions using ISO codes
• Malware scanning and automated threat detection
• Email spam filtering with blacklist/whitelist management
• Premium SSL/TLS certificate ordering and renewal
• Security monitoring and incident response
• Real-time threat protection and access control

🚀 Quick Start

Prerequisites

• Node.js 18+ and npm
• 20i Reseller Account with API access
• Claude Desktop, VS Code with Claude, or other MCP-compatible AI assistant

Installation

1. Clone the repository:

   git clone https://github.com/Cbrown35/20i-MCP.git
   cd 20i-MCP
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Configure your AI assistant:

   Add to your claude_desktop_config.json:

   {
     "mcpServers": {
       "20i-hosting": {
         "command": "node",
         "args": ["/path/to/20i-MCP/build/index.js"],
         "cwd": "/path/to/20i-MCP",
         "env": {
           "TWENTYI_API_KEY": "your_general_api_key",
           "TWENTYI_OAUTH_KEY": "your_oauth_client_key", 
           "TWENTYI_COMBINED_KEY": "your_combined_api_key"
         }
       }
     }
   }
   

5. Restart your AI assistant and start managing your 20i services with natural language!

💬 Usage Examples

🌟 Power User Workflows (New!)

Complete WordPress Site Setup

"Create hosting package for myblog.com, then create a staging subdomain, install WordPress, create MySQL database 'blog_db' and user 'blog_admin', set PHP to 8.2, add SSL certificate, and create FTP user for my developer"

Professional Email Setup

"Create email accounts for support@, sales@, and info@ for mycompany.com, forward all to admin@mycompany.com, then create a premium mailbox for the CEO"

Development Environment

"Set up dev.mysite.com subdomain, install WordPress there, create separate MySQL database 'dev_db', set PHP 8.1, create FTP user 'developer' with access to /dev folder"

Domain Management

"List all my domains that expire in the next 30 days"
"Show me DNS records for example.com"
"Add an A record pointing blog.example.com to 192.168.1.100"

Hosting Operations

"Create a new hosting package for clientsite.com with WordPress optimization"
"Show me hosting packages using more than 80% of their resources" 
"What's the performance status of all my hosting packages?"

Cloud Infrastructure

"Deploy a new cloud server in London with 4GB RAM for my development environment"
"Show me all cloud servers and their current resource usage"
"Scale up the production server to handle increased traffic"

Account Monitoring

"Give me an overview of my 20i reseller account"
"What's my current account balance and billing status?"
"What's my current API usage and remaining limits?"
"Show me this month's hosting statistics"

Hosting Management Operations

"Create a new subdomain 'blog' for my website"
"Set up a MySQL database called 'ecommerce_data' for my store"
"Create an FTP user for my designer to upload files"
"Install WordPress in the '/blog' directory of my site"

WordPress Management Operations

"Check if WordPress is installed on package w12345"
"Update WordPress to the latest version on my site"
"List all WordPress plugins and their status"
"Activate the Yoast SEO plugin on my WordPress site"
"Create a staging environment copy of my live WordPress site"
"Update my WordPress site URL from old-domain.com to new-domain.com"
"Install the StackCache plugin for better performance"
"List all WordPress users and their roles"

CDN and Performance Management

"Show me all available CDN features for package w12345"
"Enable all performance CDN features for better site speed"
"Clear CDN cache for https://example.com/updated-page.html"
"Get CDN traffic distribution by country for analytics"
"Set up security headers for enhanced site protection"
"Assign my package to Website Turbo for faster loading"
"Show me CDN cache report and performance statistics"
"Configure StackCache policies for optimal performance"

Backup and Data Protection

"Create a snapshot of my website and database for package w12345"
"Show me all available backups for my hosting package"
"Restore my website from yesterday's snapshot"
"List all timeline storage items for data recovery planning"
"Monitor the status of my current backup jobs"
"Create bulk backups for all my client websites"
"Restore the backup file I uploaded via FTP"
"Configure automatic VPS backup settings"

Advanced Security Management

"Block IP address 192.168.1.100 from accessing package w12345"
"Show me all blocked IP addresses for my hosting package"
"Block all traffic from China and Russia for enhanced security"
"Remove country block for Germany to allow EU traffic"
"Run a malware scan on package w12345 to check for threats"
"Show me the latest malware report for security analysis"
"Order a premium SSL certificate for mysite.com valid for 12 months"
"Check email spam blacklist settings for support@mysite.com"
"Add 10.0.0.0/8 to IP block list to prevent internal network access"
"Remove IP block for 203.0.113.5 to restore legitimate access"

Database and Development

"Create MySQL database 'app_db' and user 'app_user' for my application"
"Upgrade PHP to version 8.2 for better performance"
"List all available applications I can install"
"Set up staging subdomain with separate FTP access"

Email System Management

"Create email account 'support@mysite.com' with secure password"
"Set up email forwarding from 'contact@' to my Gmail account"
"Order a premium mailbox for support@example.com"
"Generate a webmail login URL for user@example.com"

Complete Workflow Examples

"Set up a complete WordPress site: create subdomain, install WordPress, create database, and add SSL"
"Prepare development environment: create staging subdomain, set PHP 8.2, create FTP user, install testing tools"
"Email system setup: create support@, sales@, and info@ accounts, then forward all to main inbox"

🛠️ Available Tools (303 Total) - 90.0% API Coverage (303/335)

Core Management

Hosting Package Management

WordPress Management

CDN Management

Backup/Restore Management

Advanced Security Management

Database Management

SSL Certificate Management

Statistics & Monitoring

Cloud Infrastructure

Premium Email Services

Subdomain Management

PHP and Application Management

FTP and File Management

🏗️ Architecture

• TypeScript: Type-safe, maintainable codebase
• MCP Protocol: Standards-compliant AI assistant integration
• RESTful API: Clean integration with 20i's API infrastructure
• Environment-based Configuration: Secure credential management
• Error Handling: Comprehensive error reporting and recovery
• Modular Design: Easy to extend and customize

🔒 Security

• Environment variable credential storage
• No sensitive data in code or logs
• Secure API token handling
• Rate limiting and error recovery
• Input validation and sanitization

🤝 Contributing

We welcome contributions! This project represents the cutting edge of AI-powered hosting management.

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the file for details.

🌟 Recognition

This is the first Model Context Protocol server for 20i hosting services, pioneering AI-powered hosting management. If you're from 20i and interested in this integration, we'd love to discuss how this can benefit your customers and business.

📞 Contact

• GitHub: @Cbrown35
• Project: 20i-MCP

---

Created by: ClaudeCode 4 & DZIND .Inc

Built with ❤️ for the 20i community. Empowering hosting management through AI.