WholesaleX AI Tools allows compatible AI assistants to interact with your wholesale store using the Model Context Protocol (MCP). You can use natural-language prompts to retrieve store information, manage wholesale roles, configure pricing rules, update registration fields and manage supported WholesaleX settings.
You control what connected AI assistants can access and modify directly from your WordPress dashboard.
Before You Begin
Make sure you have:
- WordPress 6.9 or later.
- WooCommerce installed and activated.
- A version of WholesaleX that includes AI Tools.
- An active MCP Adapter, provided either by WooCommerce’s enabled MCP integration or the standalone MCP Adapter plugin.
- A WordPress administrator account.
- An AI client that supports a compatible MCP connection.
The core MCP tools are available in WholesaleX Free. Supported Pro capabilities require the WholesaleX Pro add-on to be active with a valid license.
Additional Requirements for Web Connections
For web-based AI connectors, your website must:
- Have a publicly accessible HTTPS address.
- Use pretty permalinks.
- Allow access to the MCP and OAuth endpoints through its hosting and firewall configuration.
To configure pretty permalinks, navigate to Settings → Permalinks in your WordPress dashboard and select any structure other than Plain.
Local website addresses, such as localhost, cannot be reached by remote web connectors.
Step 1: Configure WholesaleX MCP Access
- Log in to your WordPress dashboard as an administrator.
- Navigate to WholesaleX → AI Tools.
- Under Access, select your preferred access level.
- Click Save access.
WholesaleX provides four access levels: Off, Read only, Read and write and Full access.
Access is Off by default. Select Read only when connecting an AI assistant for the first time.
For a detailed explanation of each permission level, see WholesaleX MCP Access Levels and Security.
Step 2: Check Your Connection Status
Under the Status section, check whether your website meets the requirements for connecting an AI assistant.
The status panel includes the following checks:
- WordPress Abilities API: Checks whether the required WordPress functionality is available.
- Application passwords: Checks whether WordPress application-password authentication is available.
- MCP Adapter plugin: Checks whether an MCP Adapter is available through WooCommerce’s MCP integration or the standalone MCP Adapter plugin.
- Sign-in for ChatGPT, Claude and Gemini: Checks readiness for web-based authentication.
Resolve any warnings relevant to your connection method before proceeding. If WooCommerce already provides an active MCP Adapter, you do not need to install the standalone plugin separately.
Application passwords are required for certain desktop and CLI connection methods. Web-based OAuth connections use your WordPress administrator sign-in instead.
Step 3: Copy Your MCP Server Address
Locate the Server address under the Status section and click Copy.
A typical WholesaleX MCP server address looks like this:
https://example.com/wp-json/wholesalex/mcp
Always use the actual server address displayed in your WholesaleX dashboard.
The WholesaleX MCP server uses its own dedicated endpoint, which is different from the MCP Adapter’s default server address.
Step 4: Connect Your AI Assistant
Under Connect an AI assistant, you can find connection instructions for different AI applications.
Choose the relevant setup guide for your preferred AI client:
- How to Connect WholesaleX to ChatGPT
- How to Connect WholesaleX to Claude
- How to Connect WholesaleX to Gemini
- How to Connect WholesaleX to Cursor
- How to Connect WholesaleX to Claude Code
- How to Connect WholesaleX to Gemini CLI
- How to Connect Desktop Apps Using the Local Bridge
Your ability to connect may depend on your AI client’s subscription plan, workspace permissions and supported authentication methods.
Step 5: Verify Your WholesaleX MCP Connection
After connecting your AI assistant, start a conversation and enter the following prompt:
Use the connected WholesaleX tool wholesalex-get-store-overview to retrieve my store overview. Show the store currency, role count and available rule types. Do not change anything.
Your AI assistant should call the connected WholesaleX tool and return information from your store.
You can also test the connection by asking:
List my WholesaleX customer roles and their IDs. Do not make changes.
A successful response containing your actual store information confirms that the connection and read access are working.
A general explanation of WholesaleX or its available tools does not confirm a successful connection. A successful read-only test also does not verify write permissions.
Once connected, explore What Can You Do with WholesaleX MCP? to learn about the available operations and example prompts.