whm

WHM Management Control Panel (MCP) server for managing WHM/cPanel servers

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

Command

claude mcp add --transport stdio hosthobbit-whm-mcp-server node server.js \
  --env PORT="3000" \
  --env API_KEY="your-secret-api-key-here" \
  --env NODE_ENV="development" \
  --env WHM_PORT="2087" \
  --env LOG_LEVEL="info" \
  --env WHM_SERVER="your-whm-server-domain.com" \
  --env WHM_USERNAME="root" \
  --env WHM_API_TOKEN="your-api-token-here"

How to use

This MCP server provides a bridge to WHM (Web Host Manager) functionality via the Model Context Protocol (MCP). It exposes tools for account management, server information, domain and SSL handling, backups, and email management, all accessible through the MCP endpoints using JSON-RPC over SSE. Start the server with a Node.js runtime, ensure your WHM credentials are configured in the .env file, and then connect your AI assistant (such as Claude) to the provided /sse and /messages endpoints to discover and invoke the available tools. The server's tools are organized into categories like Account Management, Server Management, and Domain Management, each exposing specific WHM actions (for example, whm_list_accounts, whm_create_account, whm_server_status, whm_add_domain, whm_delete_domain, and more). The MCP implementation follows the standard JSON-RPC 2.0 format and uses SSE for transport, providing proactive readiness notifications and standard error handling.

How to install

Prerequisites:

Node.js installed (v14+ recommended)
Access to a WHM server with API token

Installation steps:

Clone the repository git clone https://github.com/your-org/hosthobbit-whm-mcp-server.git
Navigate to the project directory cd hosthobbit-whm-mcp-server
Install dependencies npm install
Create and configure the .env file with WHM and MCP settings

WHM Server Configuration

WHM_SERVER=your-server-domain.com WHM_PORT=2087 WHM_USERNAME=root WHM_API_TOKEN=your-api-token-here

MCP Server Configuration

PORT=3000 NODE_ENV=development LOG_LEVEL=info

API Authentication

API_KEY=your-secret-api-key-here
Start the server npm start

For development mode with auto-reload (if supported by your setup): npm run dev

Additional notes

Tips and caveats:

Ensure WHM API tokens have the necessary permissions for the requested actions.
Use HTTPS in production to protect API tokens and credentials.
Keep .env files secure and do not commit them to version control.
If you encounter connection issues, verify WHM_PORT and network accessibility from the MCP server host.
Review the available MCP endpoints at /api/* and the docs endpoint at /docs after the server starts.
When testing with the example client, you can run: npm run example to verify tooling connectivity.
Regularly rotate API tokens and follow WHM/cPanel security best practices.

Related MCP Servers

zen

1.1k

Selfhosted notes app. Single golang binary, notes stored as markdown within SQLite, full-text search, very low resource usage

MCP -Deepseek_R1

A Model Context Protocol (MCP) server implementation connecting Claude Desktop with DeepSeek's language models (R1/V3)

mcp-fhir

A Model Context Protocol implementation for FHIR

mcp

Inkdrop Model Context Protocol Server

mcp-appium-gestures

This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..

dubco -npm

The (Unofficial) dubco-mcp-server enables AI assistants to manage Dub.co short links via the Model Context Protocol. It provides three MCP tools: create_link for generating new short URLs, update_link for modifying existing links, and delete_link for removing short links.

whm