Whmcs Mcp

WHMCS MCP Server

MCP (Model Context Protocol) server for full integration with the WHMCS API.

Features

Tickets and Support

• List tickets with advanced filters
• View full ticket details (including replies and notes)
• Create new tickets
• Add replies to tickets
• Update ticket properties
• List support departments
• View ticket statuses with counts
• Full ticket statistics

Clients

• List clients with filters and pagination
• View full client details (with stats)

Products and Orders

• List available products/services
• List orders with filters

Invoices

• List invoices with filters and sorting

General

• Secure authentication via API credentials
• Fully typed with TypeScript
• 34 MCP tools implemented and tested

Available Tools (34)

Tickets

1. whmcsgettickets - List tickets with filters
2. whmcsgetticket - View a specific ticket with all replies
3. whmcsgetticket_counts - Ticket statistics and counts
4. whmcsopenticket - Create a new ticket
5. whmcsaddticket_reply - Reply to a ticket
6. whmcsupdateticket - Update ticket properties

Support

1. whmcsgetsupport_departments - List departments
2. whmcsgetsupport_statuses - View statuses with counts

Clients

1. whmcsgetclients - List clients
2. whmcsgetclients_details - Full client details
3. whmcsgetclients_products - Client products/services
4. whmcsgetclients_domains - Client domains
5. whmcsgetcontacts - Client contacts
6. whmcsgetemails - Email history

Products, Orders, and Invoices

1. whmcsgetproducts - List products/services
2. whmcsgetorders - List orders
3. whmcsgetinvoices - List invoices

Billing Analysis

1. whmcsfindinvoice_gaps - Find missing invoice months per client
2. whmcslistclientswithpending_invoices - List clients with unpaid/overdue invoices

System and Administration

1. whmcsgetactivity_log - Activity log (116k+ entries)
2. whmcsgetstats - Full statistics (revenue, orders, tickets)
3. whmcsgetcurrencies - Configured currencies
4. whmcsgetpayment_methods - Active payment methods
5. whmcsgetadmin_users - Admin users

Combined Invoices

1. whmcsgetunpaidinvoicesdetailed - Unpaid invoices with client and product details
2. whmcsgetallunpaidinvoices_complete - All unpaid invoices with full details

Service Management

1. whmcsmodulesuspend - Suspend service
2. whmcsmoduleunsuspend - Unsuspend service
3. whmcsmoduleterminate - Terminate service permanently
4. whmcsmodulecreate - Provision service

Order Management

1. whmcsacceptorder - Accept and activate order
2. whmcscancelorder - Cancel order
3. whmcsdeleteorder - Delete order permanently
4. whmcspendingorder - Set order as pending

Quick Install

Claude Code (one command)

claude mcp add whmcs \
  -e WHMCS_API_URL=https://your-whmcs.com/includes/api.php \
  -e WHMCS_IDENTIFIER=your_identifier \
  -e WHMCS_SECRET=your_secret \
  -- npx -y whmcs-mcp

Or with admin credentials instead of API keys:

claude mcp add whmcs \
  -e WHMCS_API_URL=https://your-whmcs.com/includes/api.php \
  -e WHMCS_USERNAME=your_admin_user \
  -e WHMCS_PASSWORD=your_admin_password \
  -- npx -y whmcs-mcp

That's it. Run claude mcp list to verify.

Claude Desktop

Add to your claude_desktop_config.json (location by OS):

{
  "mcpServers": {
    "whmcs": {
      "command": "npx",
      "args": ["-y", "whmcs-mcp"],
      "env": {
        "WHMCS_API_URL": "https://your-whmcs.com/includes/api.php",
        "WHMCS_IDENTIFIER": "your_identifier",
        "WHMCS_SECRET": "your_secret"
      }
    }
  }
}

Restart Claude Desktop and the 34 tools will be available.

Alternative: mcp.json file

If you prefer a config file instead of env vars, create mcp.json in the project root:

cp mcp.example.json mcp.json
# edit mcp.json with your credentials

When using admin credentials with username/password, the server automatically hashes the password with MD5 (WHMCS requirement). You can also provide an already MD5-hashed password.

Adding credentials later

If you already added the MCP server but didn't have the credentials yet:

Claude Code: run claude mcp add whmcs ... again with the -e flags -- it overwrites the previous entry.

Claude Desktop: open claude_desktop_config.json and add the env block to the existing whmcs entry:

"env": {
  "WHMCS_API_URL": "https://your-whmcs.com/includes/api.php",
  "WHMCS_IDENTIFIER": "your_identifier",
  "WHMCS_SECRET": "your_secret"
}

Then restart Claude Desktop.

Usage Examples

In Claude Code, you can ask questions like:

Tickets:

• "List the last 10 open tickets"
• "Show details for ticket #123456"
• "How many tickets are awaiting response?"
• "Which support departments are available?"

Clients:

• "List the last 5 active clients"
• "Show details for client ID 123"
• "How many clients do we have total?"

Products:

• "List all available products"
• "Which products are in group 5?"

Orders and Invoices:

• "List the last 10 orders"
• "Show overdue invoices"

Technologies

• TypeScript
• MCP SDK (@modelcontextprotocol/sdk)
• Axios (HTTP client)
• WHMCS API v1

Project Structure

whmcs-mcp/
├── src/                # TypeScript source code
│   ├── index.ts        # MCP server (34 tools)
│   ├── config.ts       # Config loader (env vars → mcp.json)
│   ├── whmcs-client.ts # API client (34 methods)
│   └── types.ts        # TypeScript types
├── test/               # Unit tests
├── build/              # Compiled output
├── mcp.example.json    # Config file template (optional)
└── package.json

Development

# Watch mode (auto rebuild)
npm run dev

# Manual build
npm run build

# Run the MCP server with the default mcp.json
node build/index.js

# Run with a custom config path
node build/index.js --config /absolute/path/mcp.json

# Test client directly
node -e "import('./build/whmcs-client.js').then(async ({WHMCSClient}) => { ... })"

Requirements

• Node.js >= 18
• WHMCS account with API enabled
• WHMCS API Identifier and Secret
• IP authorized in the WHMCS API

Project Status

• 34 MCP tools implemented and tested
• Complete TypeScript client
• Tested in production with real data
• Full coverage of main WHMCS endpoints

Completed Implementations

Tickets and Support (8 tools)

• GetTickets, GetTicket, GetTicketCounts
• OpenTicket, AddTicketReply, UpdateTicket
• GetSupportDepartments, GetSupportStatuses

Clients (6 tools)

• GetClients, GetClientsDetails
• GetClientsProducts, GetClientsDomains
• GetContacts, GetEmails

Products and Sales (3 tools)

• GetProducts, GetOrders, GetInvoices

System and Admin (5 tools)

• GetActivityLog (116k+ entries tested)
• GetStats (revenue, orders, tickets)
• GetCurrencies, GetPaymentMethods
• GetAdminUsers

Combined Invoices (2 tools)

• GetUnpaidInvoicesDetailed, GetAllUnpaidInvoicesComplete

Billing Analysis (2 tools)

• FindInvoiceGaps, ListClientsWithPendingInvoices

Service Management (4 tools)

• ModuleSuspend, ModuleUnsuspend, ModuleTerminate, ModuleCreate

Order Management (4 tools)

• AcceptOrder, CancelOrder, DeleteOrder, PendingOrder

License

MIT

Author

Built for WHMCS integration via Model Context Protocol.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: caioldcarvalho
• Source: caioldcarvalho/whmcs-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.