--- url: /relyagent-whmcs/errors.md description: >- A searchable list of the exact messages Relyagent can show your AI client or in the WHMCS admin — what each one means and what to do about it. --- # Error reference Every message Relyagent might show, quoted exactly, with what it means and what to do. Use your browser's find (⌘F / Ctrl-F) to jump to a message. For step-by-step fixes, see [Troubleshooting](/relyagent-whmcs/troubleshooting). **MCP** below means the Model Context Protocol — how your AI client talks to the tools Relyagent exposes from WHMCS. ## Runtime messages (seen by the AI client) ### HTTP 403 on the MCP or OAuth endpoints **What it means:** the MCP server is license-gated, and your Relyagent license is inactive or removed, so no client can connect or call tools. A brief licensing-server outage does **not** cause this — the check runs locally. **What to do:** open **Addons → Relyagent → Settings → License** and renew or re-enter your key. Service resumes as soon as the license is active. ### HTTP 429 **What it means:** the connection hit a rate cap — too many calls per minute or per day for that token. **What to do:** raise **Calls / minute** or **Calls / day** under **Settings → MCP Settings**, or have the client slow down. ### `Missing required scope: ` **What it means:** the connection wasn't granted the tool (and its scope) that was called. `` is the specific permission, such as `clients:read` or `invoices:write`. **What to do:** edit the connection under **MCP Clients** and tick the tool. Because this *adds* a tool, the client must reconnect and re-consent afterwards. ### `This tool is disabled. Enable dangerous operations in Relyagent settings.` **What it means:** a state-changing (dangerous) tool was called while **Dangerous Operations** is off. These tools stay off by default. **What to do:** turn on **Dangerous Operations** under **Settings → MCP Settings** *and* confirm the tool is ticked on the connection. Enable this deliberately — it lets tools modify your WHMCS data. ### `Tool group disabled: ` **What it means:** the tool's group (for example, `Invoices` or `Tickets`) is toggled off in your settings, so none of its tools list or run. **What to do:** re-enable the group under **Settings → MCP Settings**. ### `ionCube Loader required. Contact support@relyweb.co` **What it means:** the encoded module can't load because your server is missing the ionCube Loader or has one that's too old. **What to do:** ask your host to install/enable the ionCube Loader for the PHP version WHMCS runs on (13.0.2+ on PHP 8.2, 14.4.0+ on PHP 8.3). See [Requirements](/relyagent-whmcs/requirements). ## Update and license messages (seen in the WHMCS admin) ### `Could not verify your license right now — the licensing server was unreachable.` **What it means:** a transient outage — our licensing server couldn't be reached for this check. Your working install keeps running because the license check runs locally. **What to do:** nothing urgent; retry later. If it persists, confirm outbound HTTPS from your server isn't blocked. ### `Your Support & Updates plan has expired or is not active. Renew it to install updates. Your current version continues to work normally.` **What it means:** for a **Lifetime** license, the Support & Updates entitlement has lapsed. Your installed version keeps working; only installing a newer version is blocked. **What to do:** renew Support & Updates to install updates again. See [Licensing](/relyagent-whmcs/licensing). ### `… is published but its download is not yet available` **What it means:** a new release has been announced but its installer isn't live yet, so **Update Now** stays disabled. **What to do:** wait and check again shortly — nothing is wrong with your install. ### `Failed to download update…` **What it means:** the update couldn't be downloaded — usually outbound HTTPS is blocked, or the build isn't authorised for your license. **What to do:** allow outbound HTTPS from your server and confirm your license/entitlement is active, then retry. ### `Backup verification failed…` **What it means:** the pre-update backup didn't verify, so Relyagent stopped **before** changing anything. Your install is untouched. **What to do:** ensure `modules/addons/relyagent/` is writable and there's enough free disk space, then try the update again. ## Connection problems (no single message) ### "Authorization Failed" / a client won't connect **What it means:** the OAuth authorization didn't complete. **What to do:** paste the **Client ID** and **Client Secret** (not just the Endpoint URL), confirm the exact Endpoint URL, sign in at your WHMCS admin login, and approve the consent screen. Full checklist on [Troubleshooting](/relyagent-whmcs/troubleshooting#authorization-failed). ### Tools missing in the client **What it means:** the tool isn't granted to the connection, its group is off, or it's a dangerous tool called with Dangerous Operations off. **What to do:** tick the tool, re-enable its group, or enable Dangerous Operations as needed — then reconnect the client after adding any tool. ::: tip Can't find your message here? It may be a WHMCS-level error rather than a Relyagent one — check your WHMCS module log, and turn on **Verbose Debug Logging** in **Settings → General** for more detail. :::