Open Source · MIT License

Hosting control
for AI agents

An MCP server that gives Claude, GPT, and any AI assistant full control over cPanel hosting. 47 tools across email, DNS, databases, files, SSL, and more.

ts npx cpanel-mcp
py uvx cpanel-mcp
go go install github.com/ExpertVagabond/cpanel-mcp/cmd/cpanel-mcp@latest
47
Tools
14
Categories
3
Languages
Hosting Tasks

14 categories of control

Every tool maps 1:1 to a cPanel UAPI or WHM API endpoint. No wrappers, no abstraction — direct hosting management.

Email

Create accounts, forwarders, set quotas, list mailboxes

6 tools

DNS

Add, delete, list records and zones across domains

4 tools

Domains

List domains, add and remove subdomains

3 tools
📂

Files

List, read, write, and delete files on the server

4 tools

MySQL

Create databases, manage users, set privileges

5 tools
🔒

SSL

List certs, generate CSRs, install certificates

3 tools

Cron

Add, list, and remove scheduled cron jobs

3 tools
📦

Backups

Create backups and list existing snapshots

2 tools

FTP

Create, list, and delete FTP accounts

3 tools

PHP

Get and set PHP version per domain

2 tools

WHM Accounts

Create, suspend, terminate hosting accounts

5 tools

WHM Packages

Create and list hosting packages

2 tools

WHM Services

Check status, restart Apache, MySQL, and more

2 tools

WHM System

Hostname, load average, server version info

3 tools

How it works

01 — Connect

Add to your AI client

Point Claude Code, Cursor, or any MCP-compatible client to the cpanel-mcp server with your cPanel credentials.

02 — Ask

Natural language commands

"Create an email account for support@mydomain.com" or "Set up a cron job to run backups nightly."

03 — Execute

Direct API calls

The MCP server translates to cPanel UAPI calls, executes them, and returns structured results. No dashboard needed.

claude-code
you set up a catch-all email forwarder for mydomain.com

> Using cpanel_email_create_forwarder
> domain: mydomain.com
> type: catch-all → user@gmail.com

Catch-all forwarder created. All mail to *@mydomain.com
  will forward to user@gmail.com

Drop-in configuration

Add the server to your MCP client config. Supports cPanel API tokens — no password needed.

📄 .mcp.json
{
  "mcpServers": {
    "cpanel": {
      "command": "npx",
      "args": ["cpanel-mcp"],
      "env": {
        "CPANEL_HOST": "your-server.com",
        "CPANEL_USERNAME": "your-user",
        "CPANEL_API_TOKEN": "your-token"
      }
    }
  }
}
📄 Environment Variables
# Required
CPANEL_HOST=server.web-hosting.com
CPANEL_USERNAME=myuser
CPANEL_API_TOKEN=ABCDEF123456

# Optional
CPANEL_PORT=2083
CPANEL_VERIFY_SSL=true
CPANEL_TIMEOUT=30000