---
url: /relyagent-whmcs.md
description: >-
  Turn your WHMCS into a self-hosted MCP server, exposing scope-gated WHMCS
  tools to AI clients like Claude, Cursor and ChatGPT over OAuth 2.0 — with
  per-connection tool allowlists, audit logging and rate limits.
---

# Relyagent for WHMCS

Relyagent turns your WHMCS installation into a self-hosted **Model Context Protocol (MCP) server**. It allows AI assistants like **Claude, Cursor, and ChatGPT** to interact securely with WHMCS data via granular, admin-controlled tools, OAuth 2.0 authentication, and audit logging.

![Relyagent dashboard in the WHMCS admin](/relyagent-whmcs/img/relyagent-index-dashboard.png)
*Addons → Relyagent → Dashboard*

::: info What is MCP?
The **Model Context Protocol (MCP)** is an open standard that lets AI assistants call external
tools. Relyagent makes your WHMCS one of those tool providers — safely, on your own server, with
no data sent anywhere except between your WHMCS and the AI client you connect.
:::

## Who it is for

WHMCS administrators who want to query or automate operational workflows using AI assistants (e.g. summarizing tickets, listing overdue invoices, checking service status) without exposing root credentials or developing custom API middleware.

## How it works

| Piece | What it is |
| --- | --- |
| **Tools** | 62 scope-gated WHMCS actions across 10 groups (clients, tickets, invoices, services, domains, admin, affiliates, email, quotes, orders) |
| **Connections** | An admin-provisioned link to one AI client, limited to the exact tools you tick, with its own OAuth credentials |
| **Guardrails** | Native WHMCS admin login + consent, per-call audit log, rate limits, prompt-injection sanitisation, and a dangerous-operations gate |

Administrators create a connection, assign tool permissions, and provision OAuth credentials. Upon connecting, the client resolves endpoints, operators authenticate via the native WHMCS login, and approved tools become callable.

## What you can do with it

* **AI client connectivity:** integrates with Claude Desktop, Claude.ai, Claude Code, Cursor, and ChatGPT (see [connection guides](/relyagent-whmcs/guides/claude-desktop)).
* **Granular permissions:** assign specific tools per connection; state-changing tools are protected by a [dangerous operations gate](/relyagent-whmcs/features/mcp-tools#dangerous-operations).
* **Secure access:** requires admin-generated secrets and native WHMCS authentication (see [Connections & OAuth](/relyagent-whmcs/features/connections-oauth)).
* **Comprehensive auditing:** logs every call with status indicators, rate limiting, and CSV export (see [Audit Log](/relyagent-whmcs/features/audit-and-rate-limits)).
* **Deployment integrity:** features HMAC-SHA256 [file integrity checking](/relyagent-whmcs/features/file-integrity) and one-click [updates](/relyagent-whmcs/updating).

## Where to go next

* [Requirements](/relyagent-whmcs/requirements) — check your server first
* [Installation](/relyagent-whmcs/installation) — activate, license, enable connections
* [Configuration](/relyagent-whmcs/configuration) — create your first connection
* [MCP tools](/relyagent-whmcs/features/mcp-tools) — the 10 groups and the dangerous-op gate
* [Settings reference](/relyagent-whmcs/settings) · [Error reference](/relyagent-whmcs/errors)

::: tip New to Relyagent?
Work through [Requirements](/relyagent-whmcs/requirements) →
[Installation](/relyagent-whmcs/installation) → [Configuration](/relyagent-whmcs/configuration),
then open the [Setup guide](/relyagent-whmcs/guides/claude-desktop) for your AI client.
:::