---
url: /relyagent-whmcs/guides/cursor.md
description: >-
  Connect the Cursor editor to your WHMCS by adding Relyagent as a custom MCP
  connector — provide the Endpoint URL, Client ID and Client Secret, authorize
  through your WHMCS admin login, approve consent, and confirm only your allowed
  tools appear.
---

# Connect Cursor

Connect the **Cursor** editor to your WHMCS through Relyagent's self-hosted **MCP server**, so Cursor can list and call only the WHMCS tools you allow.

## Prerequisites

* A **connection** created under **Addons → Relyagent → MCP Clients** — see
  [Configuration](/relyagent-whmcs/configuration).
* Its **Client ID** and **Client Secret** (the secret is shown only once at creation).
* The shared **Endpoint URL**:

  ```
  https://<your-whmcs>/modules/addons/relyagent/public/mcp/endpoint.php
  ```

::: tip Grab the exact values from WHMCS
The **Setup** tab (**Addons → Relyagent → Setup**) has a Cursor accordion with the Endpoint URL
pre-filled and copy-paste steps.
:::

## Add Relyagent as an MCP connector

1. Open **Settings → Tools & Integrations → Add Custom MCP** (or edit `~/.cursor/mcp.json`).
2. Add this server entry (the URL is the same for every connection):

   ```json
   {
     "mcpServers": {
       "relyagent": {
         "url": "https://<your-whmcs>/modules/addons/relyagent/public/mcp/endpoint.php"
       }
     }
   }
   ```
3. Cursor shows **Needs login** — click it to run the OAuth flow. Enter the connection's
   **Client ID** and **Client Secret** if prompted.

## Authorize and consent

Cursor auto-discovers Relyagent's OAuth endpoints and starts sign-in:

1. You're sent to your **native WHMCS admin login** — your existing 2FA, brute-force and IP
   rules apply, because Relyagent shows no login form of its own.
2. A **consent screen** lists this connection's tools. Approve it to finish.

## Verify it works

Ask Cursor to list its available WHMCS tools. It should show **only** the tools you ticked for
this connection — nothing more. Any tool outside that set is rejected.

::: warning If it won't connect
Make sure you provided **both** the Client ID and Client Secret — the Endpoint URL alone isn't
enough. Confirm you signed in at the WHMCS admin login and approved consent, and double-check the
exact Endpoint URL. See the [error reference](/relyagent-whmcs/errors).
:::

## Related

* [Configuration](/relyagent-whmcs/configuration) — create and manage connections
* Setup tab: **Addons → Relyagent → Setup**
* [MCP tools](/relyagent-whmcs/features/mcp-tools) — what each tool group does