Name: WHMCS MCP Tools
Author: scarecr0w12

LABSCO SUMMARY

Full read and write against a live billing system, destructive calls included.

Deleting a client, terminating a service and marking an order fraudulent are each one call, so the permissions on the API credential are the real boundary. WHMCS lets you enable only the API functions you need and restrict access by IP — set both before you point an assistant at a production install.

What it is

A TypeScript server over the WHMCS API that covers the whole admin surface: clients, products, billing, support tickets, domains, orders, service provisioning and system data.

What you get

Client records end to end — whmcs_get_clients, whmcs_get_client_details, whmcs_add_client, whmcs_update_client, whmcs_delete_client
Billing — whmcs_get_invoices, whmcs_create_invoice, whmcs_add_payment, whmcs_apply_credit, whmcs_get_transactions
The support desk — whmcs_get_tickets, whmcs_open_ticket, whmcs_add_ticket_reply, whmcs_update_ticket
Domains — whmcs_register_domain, whmcs_transfer_domain, whmcs_renew_domain, whmcs_update_domain_nameservers, whmcs_get_tld_pricing
Service lifecycle on the server modules — whmcs_module_create, whmcs_module_suspend, whmcs_module_terminate, whmcs_module_change_password
Read-only live resources such as whmcs://stats, whmcs://products and whmcs://tld-pricing, plus prompt templates for client onboarding, revenue reporting and fraud investigation

Requirements

Three environment variables — WHMCS_API_URL, WHMCS_API_IDENTIFIER and WHMCS_API_SECRET — from credentials created under Setup → Staff Management → API Credentials. WHMCS_ACCESS_KEY is optional and adds a second factor. Run the ghcr.io/scarecr0w12/whmcs-mcp-tool:latest image, or build from source with npm.

Setup effort

One command plus a key — docker run -it --rm -e WHMCS_API_URL="<YOUR_BILLING_URL>/" -e WHMCS_API_IDENTIFIER="<YOUR_WHMCS_API_IDENTIFIER>" -e WHMCS_API_SECRET="<YOUR_WHMCS_API_SECRET>" ghcr.io/scarecr0w12/whmcs-mcp-tool:latest

See installation options

USE CASES

01

Answering a billing question without opening the admin

Pull the client, their services and their invoices in one conversation, then apply a credit or record a payment against the right invoice.

whmcs_get_client_detailswhmcs_get_invoiceswhmcs_add_paymentwhmcs_apply_credit

02

Working the ticket queue

List open tickets, read the thread, and post a reply or change the ticket's status from the same place you drafted the answer.

whmcs_get_ticketswhmcs_get_ticketwhmcs_add_ticket_replywhmcs_update_ticket

03

Auditing domains before renewals hit

Read expiry and lock status across a client's domains and check TLD pricing before you commit to a renewal.

whmcs_get_client_domainswhmcs_get_domain_lock_statuswhmcs_get_tld_pricing

04

Suspending a service for non-payment

Find the service on its server module and suspend it, then unsuspend it once the invoice clears.

whmcs_get_client_productswhmcs_module_suspendwhmcs_module_unsuspend

62 tools

Listed in project docs. Your client may show a different list.

whmcs_get_clients

whmcs_get_client_details

whmcs_add_client

whmcs_update_client

whmcs_delete_client

whmcs_get_client_products

whmcs_get_client_domains

whmcs_get_products

whmcs_get_product_groups

whmcs_get_invoices

whmcs_get_invoice

whmcs_create_invoice

whmcs_update_invoice

whmcs_add_payment

whmcs_apply_credit

BEFORE YOU INSTALL

What to know first

Tools you get

62 tools named in the project's documentation.

Requires

WHMCS_API_SECRET in your environment
WHMCS_API_IDENTIFIER in your environment

Where it runs

All 3 documented setups run the server on your machine.

INSTALLATION

Connect your client

Server setup

TERMINAL

docker run -it --rm -e WHMCS_API_URL="<YOUR_BILLING_URL>/" -e WHMCS_API_IDENTIFIER="<YOUR_WHMCS_API_IDENTIFIER>" -e WHMCS_API_SECRET="<YOUR_WHMCS_API_SECRET>" ghcr.io/scarecr0w12/whmcs-mcp-tool:latest

MCP Clients

Claude Desktop — Docker

CLAUDE DESKTOP — DOCKER · JSON

{
  "mcpServers": {
    "whmcs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WHMCS_API_URL=<YOUR_BILLING_URL>/",
        "-e",
        "WHMCS_API_IDENTIFIER=<YOUR_WHMCS_API_IDENTIFIER>",
        "-e",
        "WHMCS_API_SECRET=<YOUR_WHMCS_API_SECRET>",
        "ghcr.io/scarecr0w12/whmcs-mcp-tool:latest"
      ]
    }
  }
}

VS Code — local build

Clone and build it: git clone https://github.com/scarecr0w12/whmcs-mcp-tool.git && cd whmcs-mcp-tool && npm install && npm run build

Set WHMCS_API_URL, WHMCS_API_IDENTIFIER and WHMCS_API_SECRET (WHMCS_ACCESS_KEY is optional) in your environment, then open the whmcs-mcp-tool folder in VS Code — the repository ships this configuration as .vscode/mcp.json, so dist/index.js resolves inside the clone:

VS CODE — LOCAL BUILD · JSON

{
  "servers": {
    "whmcs-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": [
        "dist/index.js"
      ],
      "env": {
        "WHMCS_API_URL": "${env:WHMCS_API_URL}",
        "WHMCS_API_IDENTIFIER": "${env:WHMCS_API_IDENTIFIER}",
        "WHMCS_API_SECRET": "${env:WHMCS_API_SECRET}",
        "WHMCS_ACCESS_KEY": "${env:WHMCS_ACCESS_KEY}"
      }
    }
  }
}

VS Code — Docker

Clone the repository and build the image: git clone https://github.com/scarecr0w12/whmcs-mcp-tool.git && cd whmcs-mcp-tool && docker build -t whmcs-mcp-server .

Set WHMCS_API_URL, WHMCS_API_IDENTIFIER and WHMCS_API_SECRET in your environment and put this in .vscode/mcp.json:

VS CODE — DOCKER · JSON

{
  "servers": {
    "whmcs-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WHMCS_API_URL",
        "-e",
        "WHMCS_API_IDENTIFIER",
        "-e",
        "WHMCS_API_SECRET",
        "-e",
        "WHMCS_ACCESS_KEY",
        "whmcs-mcp-server"
      ],
      "env": {
        "WHMCS_API_URL": "${env:WHMCS_API_URL}",
        "WHMCS_API_IDENTIFIER": "${env:WHMCS_API_IDENTIFIER}",
        "WHMCS_API_SECRET": "${env:WHMCS_API_SECRET}",
        "WHMCS_ACCESS_KEY": "${env:WHMCS_ACCESS_KEY}"
      }
    }
  }
}

WHMCS MCP Tools