# WHMCS MCP Server

> WHMCS MCP Server is an MCP server for cloud and infrastructure. Run WHMCS billing, clients, tickets and domains from Claude, ChatGPT or Cursor. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** self-hosted, API
- **Website:** https://daddar.io/whmcs-mcp
- **Repository:** https://github.com/daddariotech/whmcs-mcp
- **MCP Registry name:** io.github.daddariotech/whmcs-mcp
- **Categories:** cloud and infrastructure, finance and payments
- **Listing updated:** 2026-11-14

## About

This server sits between an AI client and a live WHMCS install, using a WHMCS API credential you create. Its README recommends starting with a read-only API role and adding write permissions only as needed, since the role limits what a misbehaving prompt can do. It ships as a Docker image, needs no PHP modules or WHMCS file edits, and runs alongside an existing stack.

The vendor lists 98 tools across clients, orders, invoices, tickets, domains, products, quotes, affiliates and promotions. Project-management tools such as list_projects through end_task_timer need WHMCS's Project Management addon, and get_clients_online needs one extra file on the WHMCS install. Domain tools like register_domain, transfer_domain and renew_domain require the matching Domain* permissions.

Claude.ai and ChatGPT connect through native OAuth 2.0 without a proxy, while Cursor and local clients can use bearer tokens. The server also offers Prometheus metrics and structured logs. A 14-day trial starts when no licence key is supplied.

## Features

- **98 WHMCS tools:** Covers clients, orders, invoices, tickets, domains, quotes, affiliates and more.
- **Docker deployment:** Run with docker compose; no WHMCS file edits required.
- **OAuth 2.0 and bearer tokens:** OAuth for Claude.ai and ChatGPT, bearer mode for Cursor and local clients.
- **Permission-scoped API role:** Limit the AI to read-only or grant specific write actions.
- **Observability:** Exposes Prometheus metrics and structured JSON logs.
- **Project management tools:** Task and timer tools when the WHMCS Project Management addon is active.

## Good for

- Send payment reminders to clients with overdue invoices
- Triage and close support tickets
- Look up a client's services and domains
- Register, transfer or renew domains by request
- Review open quotes and promotions

## Install

### Claude Code (Terminal)

```sh
claude mcp add whmcs-mcp --env MCP_TRANSPORT='<MCP_TRANSPORT>' --env WHMCS_API_URL='<WHMCS_API_URL>' --env WHMCS_IDENTIFIER='<WHMCS_IDENTIFIER>' --env WHMCS_SECRET='<WHMCS_SECRET>' --env LICENSE_KEY='<LICENSE_KEY>' -- docker run -i --rm -e MCP_TRANSPORT -e WHMCS_API_URL -e WHMCS_IDENTIFIER -e WHMCS_SECRET -e LICENSE_KEY docker.io/daddariotech/whmcs-mcp:latest
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "whmcs-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "WHMCS_API_URL",
        "-e",
        "WHMCS_IDENTIFIER",
        "-e",
        "WHMCS_SECRET",
        "-e",
        "LICENSE_KEY",
        "docker.io/daddariotech/whmcs-mcp:latest"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "WHMCS_API_URL": "<WHMCS_API_URL>",
        "WHMCS_IDENTIFIER": "<WHMCS_IDENTIFIER>",
        "WHMCS_SECRET": "<WHMCS_SECRET>",
        "LICENSE_KEY": "<LICENSE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "whmcs-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "WHMCS_API_URL",
        "-e",
        "WHMCS_IDENTIFIER",
        "-e",
        "WHMCS_SECRET",
        "-e",
        "LICENSE_KEY",
        "docker.io/daddariotech/whmcs-mcp:latest"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "WHMCS_API_URL": "<WHMCS_API_URL>",
        "WHMCS_IDENTIFIER": "<WHMCS_IDENTIFIER>",
        "WHMCS_SECRET": "<WHMCS_SECRET>",
        "LICENSE_KEY": "<LICENSE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "whmcs-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "WHMCS_API_URL",
        "-e",
        "WHMCS_IDENTIFIER",
        "-e",
        "WHMCS_SECRET",
        "-e",
        "LICENSE_KEY",
        "docker.io/daddariotech/whmcs-mcp:latest"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "WHMCS_API_URL": "<WHMCS_API_URL>",
        "WHMCS_IDENTIFIER": "<WHMCS_IDENTIFIER>",
        "WHMCS_SECRET": "<WHMCS_SECRET>",
        "LICENSE_KEY": "<LICENSE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "whmcs-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "WHMCS_API_URL",
        "-e",
        "WHMCS_IDENTIFIER",
        "-e",
        "WHMCS_SECRET",
        "-e",
        "LICENSE_KEY",
        "docker.io/daddariotech/whmcs-mcp:latest"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "WHMCS_API_URL": "<WHMCS_API_URL>",
        "WHMCS_IDENTIFIER": "<WHMCS_IDENTIFIER>",
        "WHMCS_SECRET": "<WHMCS_SECRET>",
        "LICENSE_KEY": "<LICENSE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "whmcs-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "WHMCS_API_URL",
        "-e",
        "WHMCS_IDENTIFIER",
        "-e",
        "WHMCS_SECRET",
        "-e",
        "LICENSE_KEY",
        "docker.io/daddariotech/whmcs-mcp:latest"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "WHMCS_API_URL": "<WHMCS_API_URL>",
        "WHMCS_IDENTIFIER": "<WHMCS_IDENTIFIER>",
        "WHMCS_SECRET": "<WHMCS_SECRET>",
        "LICENSE_KEY": "<LICENSE_KEY>"
      }
    }
  }
}
```

## Tools

- `list_projects`: Lists WHMCS projects; needs the Project Management addon.
- `end_task_timer`: Ends a project task timer; needs the Project Management addon.
- `get_clients_online`: Shows clients online; needs an extra file on the WHMCS install.
- `register_domain`: Registers a domain; requires the DomainRegister permission.
- `transfer_domain`: Transfers a domain; requires DomainTransfer.
- `renew_domain`: Renews a domain; requires DomainRenew.

## FAQ

### Is there a trial?

Yes, 14 days; omit the LICENSE_KEY variable to start it.

### What credentials does it need?

A WHMCS API URL, identifier and secret, plus an optional licence key.

### Can I restrict what the AI changes?

Yes, by granting a read-only API role or only selected write permissions.

### What did a domain tool return when permissions were wrong?

The README says a 403 means the matching Domain* permission is missing from the role.

### Is WHMCS MCP Server free?

WHMCS MCP Server is a paid product with a free trial.

### How do I add WHMCS MCP Server to Claude Code?

Run this command in your terminal: claude mcp add whmcs-mcp --env MCP_TRANSPORT='<MCP_TRANSPORT>' --env WHMCS_API_URL='<WHMCS_API_URL>' --env WHMCS_IDENTIFIER='<WHMCS_IDENTIFIER>' --env WHMCS_SECRET='<WHMCS_SECRET>' --env LICENSE_KEY='<LICENSE_KEY>' -- docker run -i --rm -e MCP_TRANSPORT -e WHMCS_API_URL -e WHMCS_IDENTIFIER -e WHMCS_SECRET -e LICENSE_KEY docker.io/daddariotech/whmcs-mcp:latest

### What are the best alternatives to WHMCS MCP Server?

The closest alternatives to WHMCS MCP Server are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/whmcs-mcp-server
