obambu-cpanel-mcp

A Model Context Protocol (MCP) server that lets an AI assistant (Claude, etc.) manage a cPanel hosting account through the cPanel UAPI.

It exposes tools for domains, DNS zones, email accounts, MySQL databases, and file listing, plus a generic escape hatch to call any other UAPI module/function.

Requirements

Node.js 18+
A cPanel account with API token access (Security → Manage API Tokens in cPanel)

Getting your cPanel credentials (Obambu example)

The four env vars below can come from any cPanel host, but here's how to find them on Obambu:

CPANEL_HOST — your server hostname, e.g. cp4.obambu.com (or your own domain if cPanel is reachable at https://yourdomain.com:2083). Find it in your Obambu welcome email, or in your domain's DNS zone: look for an A record named cpanel (e.g. cpanel.yourdomain.com) — that same server also answers at its cpX.obambu.com hostname.
CPANEL_PORT — 00000 (cPanel's default HTTPS port). Leave it unless your host says otherwise.
CPANEL_USERNAME — your cPanel account username, shown top-right when logged into cPanel, or in the welcome email Obambu sent when the hosting account was created.
CPANEL_API_TOKEN — generate one yourself, it is not your cPanel password:
1. Log into cPanel at https://<CPANEL_HOST>:00000
2. Go to Security → Manage API Tokens
3. Click Create, give it a name (e.g. mcp-server), optionally restrict it to specific ACLs, then Create
4. Copy the token immediately — cPanel only shows it once

Using it with an MCP client (npx, recommended)

Published on npm as obambu-cpanel-mcp — no clone or build needed. Add it to your MCP client config (e.g. Claude Desktop / Claude Code):

{
  "mcpServers": {
    "obambu-cpanel": {
      "command": "npx",
      "args": ["-y", "obambu-cpanel-mcp"],
      "env": {
        "CPANEL_HOST": "your-server-hostname-or-ip",
        "CPANEL_PORT": "00000",
        "CPANEL_USERNAME": "your-cpanel-username",
        "CPANEL_API_TOKEN": "your-api-token"
      }
    }
  }
}

Running from source

git clone https://github.com/RodrigueDev13/obambu-cpanel-mcp.git
cd obambu-cpanel-mcp
npm install
cp .env.example .env

Edit .env with your cPanel details, then:

npm run build
npm start

For local development without building first:

npm run dev

When running from source, point your MCP client at the built entrypoint instead of npx:

{
  "mcpServers": {
    "obambu-cpanel": {
      "command": "node",
      "args": ["/absolute/path/to/obambu-cpanel-mcp/dist/index.js"],
      "env": {
        "CPANEL_HOST": "your-server-hostname-or-ip",
        "CPANEL_PORT": "00000",
        "CPANEL_USERNAME": "your-cpanel-username",
        "CPANEL_API_TOKEN": "your-api-token"
      }
    }
  }
}

Available tools

Tool	Description
`get_account_summary`	Disk/bandwidth quota usage and general stats
`list_domains`	Domains, subdomains, addon domains and parked domains
`list_dns_records`	Read a domain's DNS zone
`add_dns_record`	Add a DNS record
`edit_dns_record`	Edit an existing DNS record
`remove_dns_record`	Remove a DNS record
`list_emails`	List email accounts
`create_email`	Create an email account
`delete_email`	Delete an email account
`list_files`	List files/directories under the account home directory
`list_databases`	List MySQL databases
`list_database_users`	List MySQL database users
`create_database`	Create a MySQL database
`create_database_user`	Create a MySQL database user
`grant_database_privileges`	Grant a user privileges on a database
`cpanel_uapi_call`	Call any UAPI module/function directly for anything not covered above

Usage examples

Once connected, just talk to your assistant in plain language — it picks the right tool:

"Test the connection to my cPanel account" → get_account_summary
"What domains and subdomains are on this hosting account?" → list_domains
"Show me the DNS records for example.com" → list_dns_records
"Add an A record for shop.example.com pointing to 1.2.3.4" → add_dns_record
"Create a mailbox contact@example.com" → create_email
"Create a MySQL database and user for my new app, then grant privileges" → create_database + create_database_user + grant_database_privileges
"List the files in public_html" → list_files
"Read config/filesystems.php and fix this path" → cpanel_uapi_call with module: "Fileman", function: "get_file_content" / save_file_content

Because tool calls map directly to UAPI modules, this is also useful for real migration/deployment workflows — e.g. moving a site to a new cPanel account, provisioning a database for a fresh app, or auditing DNS before a domain cutover.

Notes on `Fileman`

Only list_files (backed by Fileman::list_files) and, through the cpanel_uapi_call escape hatch, get_file_content / save_file_content are known to work reliably for reading and writing individual files. Bulk filesystem operations (extract_files, rename, mkdir, fileop, delete_files, ...) are not guaranteed to be available depending on your cPanel version/provider — test before relying on them, and prefer cPanel's File Manager UI for bulk moves, extraction, and deletion.

Security

Never commit your .env file (it's git-ignored by default).
Scope your cPanel API token as narrowly as your provider allows.
The cpanel_uapi_call tool can call any UAPI function available to your account — treat it with the same care as direct API/token access.

License

MIT

Obambu cPanel MCP