If you experience problems connecting an AI assistant to WholesaleX or using its MCP tools, follow the troubleshooting instructions below.
AI Tools Are Missing from the WholesaleX Dashboard
Make sure you are signed in as a WordPress administrator and are using a version of WholesaleX that includes the AI Tools feature.
WordPress Abilities API Is Unavailable
WholesaleX MCP requires WordPress 6.9 or later.
Update WordPress to a compatible version and check the Status panel again under WholesaleX → AI Tools.
MCP Adapter Is Unavailable
Make sure an MCP Adapter is available through WooCommerce’s enabled MCP integration or the standalone MCP Adapter plugin.
If no adapter is available, install and activate the standalone MCP Adapter plugin.
Return to WholesaleX → AI Tools and check the MCP Adapter status again.
The AI Client Cannot Reach Your Website
If you are using a remote web connector:
- Make sure your website has a publicly accessible HTTPS address.
- Use the server address copied from WholesaleX AI Tools.
- Confirm that pretty permalinks are enabled.
- Check whether your hosting provider, firewall, security plugin or website password protection is blocking the connection.
- Review the web sign-in status in WholesaleX.
Remote web connectors cannot access localhost addresses.
OAuth Sign-in Fails
Check the error message returned by your AI client.
Make sure your WordPress website correctly recognizes HTTPS, including when operating behind a reverse proxy.
Your hosting configuration must also allow OAuth discovery and authorization requests.
If OAuth discovery fails, ask your hosting provider to check whether requests to the following paths are being blocked:
/.well-known/oauth-*
/.well-known/openid-configurationApplication Passwords Are Missing from Your WordPress Profile
Make sure your website uses HTTPS.
Check whether your hosting provider, security plugin or WordPress configuration has disabled application passwords.
The AI Client Returns a 401 Error
A 401 response during an actual tool call usually indicates an authentication problem.
Check the following:
- Your WordPress administrator username.
- Your OAuth authorization or application password.
- The Authorization header in your client configuration, if applicable.
- Whether the application password or authorization has been revoked.
An initial unauthenticated 401 response during OAuth discovery can be normal.
The AI Client Returns a 403 or Permission Error
Confirm that you are connecting using a WordPress administrator account.
Check your configured access level under WholesaleX → AI Tools → Access.
Write operations require Read and write or Full access. Delete operations require Full access.
A tool appearing in your AI client does not mean your current access level allows its execution.
WholesaleX Is Connected but No Tools Appear
Check whether:
- WholesaleX MCP access is set to a level other than Off.
- The correct WholesaleX server address is configured.
- An MCP Adapter is active through WooCommerce’s MCP integration or the standalone MCP Adapter plugin.
- The WholesaleX connection and its tools are enabled in your AI client.
Refresh or reconnect the AI client to reload the available tools.
Opening the MCP server address in a browser does not provide a complete connection test.
Follow the Verify Your WholesaleX MCP Connection instructions in the Getting Started guide to test an actual tool call.
A Created Pricing or Dynamic Rule Is Not Working
New pricing and dynamic rules are inactive by default unless explicitly activated.
Check the rule’s:
- Active status.
- Schedule.
- Customer or role conditions.
- Product scope.
Test the rule using a customer account with the relevant wholesale user role.
A WholesaleX Pro Feature Is Unavailable
Confirm that:
- WholesaleX Pro is installed and activated.
- Your Pro license is active.
- The relevant Pro feature or add-on is available.
- Your installed plugin versions are compatible.
Refresh or reconnect your AI client after changing installed features.
Contact WholesaleX Support
If the problem persists, contact WholesaleX support with the following information:
- WordPress version.
- WooCommerce version.
- WholesaleX and WholesaleX Pro versions, where applicable.
- MCP Adapter version.
- AI client name and version.
- Connection and authentication method.
- Exact error message.
- Relevant redacted log entries from the
wholesalex-mcp log.
Do not include passwords, application passwords, authentication tokens or unredacted personal customer information in your support request.