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.

• 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

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):

   {
     "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.

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.

Related

• Configuration — create and manage connections
• Setup tab: Addons → Relyagent → Setup
• MCP tools — what each tool group does