MCP Server for WHMCS

Step 1.1: Upload Files

1. 1.Open your FTP client (FileZilla, Cyberduck, etc.) or cPanel File Manager
2. 2.Connect to your WHMCS server
3. 3.Navigate to: /public_html/whmcs/modules/addons/
4. 4.Extract mx_mcp.zip on your computer
5. 5.Upload the entire mx_mcp/ folder

/whmcs/modules/addons/mx_mcp/
├── mx_mcp.php
├── mcp.php
├── hooks.php
├── .htaccess
└── lib/
    ├── Admin/
    ├── Api/
    └── Database.php

Step 1.2: Activate Addon

1. 1.Open your browser and go to your WHMCS admin: http://your-whmcs.com/admin
2. 2.Login with your administrator account
3. 3.Go to: Configuration → Addon Modules
4. 4.Find "MCP Server" in the list
5. 5.Click "Activate"
6. 6.
   Configure settings:

   • • License Key: Paste your license key (received via email)

   The activation form on v1.7.1 only requires the License Key. Older flags (Enable API, Rate Limit, Access Control) were removed; rate limiting and tool access now live inside the addon's admin UI.

7. 7.Click "Save Changes"
8. 8.Verify License Status shows "Active"

Success check: You should see "Changes Saved Successfully" and License Status should display "Active"

Step 1.3: Generate Bearer Token

1. 1.Go to: Addons → MCP Server
2. 2.Click the API Keys tab
3. 3.Click Generate New Credential
4. 4.Enter a descriptive name (e.g., "Claude Desktop" or "Cursor")
5. 5.Click "Generate"

{
  "mcpServers": {
    "whmcs": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-remote",
        "https://your-whmcs.com/modules/addons/mx_mcp/mcp/sse.php"],
      "env": { "MCP_API_KEY": "your-api-key-here" }
    }
  }
}

Step 1.4: Enable the MCP Endpoint

The MCP Endpoint is a master kill-switch, separate from the WHMCS “addon active” flag. By default it ships OFF, so the endpoint will not respond to any client until you turn it on.

1. 1.Go to: Addons → MCP Server → Settings tab, then click the Connection sub-tab on the left sidebar
2. 2.In the Endpoint Status card, find the MCP Endpoint toggle
3. 3.Switch the toggle to Enabled (the label next to it should now read “Enabled”)

Test 1: Verify Connection

Open your AI client and look for the MCP connection indicator.

Success: You should see "MCP Servers: 1 connected" or a tools icon.

Test 2: First Query

Type this:

You should see system info like WHMCS version, PHP version, and client count.

Test 3: List Clients

Type this:

If you see a list of clients with names and emails, it works.

If you get “I don't have any tools” or “Server disconnected” instead, jump to Common Setup Pitfalls before opening a ticket. Three known causes cover most failures, and Step 1.4 (Enable the MCP Endpoint) is the most common one.