UAE AI Tools: Troubleshooting, Capabilities & FAQ

This guide covers common issues, the permissions model, and frequently asked questions for UAE AI Tools.

For setup guides, return to the UAE AI Tools main doc.

Troubleshooting

Settings page says “requires WordPress 6.9+” or abilities list is empty

The Abilities API is not available on your WordPress version. Upgrade to WordPress 7.0+, or install the MCP Adapter plugin if you are on 6.9. Clear any page or object cache and reload.

0 abilities when both UAE Lite and Pro are active

Update both UAE Lite and UAE Pro to the latest version. Earlier builds could fail to register abilities in certain plugin load orders when both were active. Reload the AI Tools settings page and flush the Elementor and plugin cache.

AI client shows no tools

1. Confirm Node.js 18+ is installed (run node -v). Applies to Claude Desktop only.
2. Check the config file path for your operating system.
3. Verify the Application Password is correct, include the spaces (e.g. xxxx xxxx xxxx xxxx xxxx xxxx).
4. Make sure a security plugin is not blocking Application Password authentication.
5. Restart the AI client after editing the config.

“ReadableStream is not defined”

Your Node.js version is too old. Upgrade to Node 18 or later:

nvm install 20 && nvm use 20

Tools appear but return permission errors

The connected WordPress user does not have the required capability for that operation. See Capabilities & Permissions below and grant the appropriate role, or connect as a higher-privileged user.

Write tools are missing

Turn on Allow Modifications on the UAE → Settings → AI Tools page. Write tools are hidden until this setting is enabled.

Angie does not show UAE tools

• Confirm the Angie plugin is active.
• Confirm both Enable AI Tools and Angie Integration are on in UAE settings.
• Flush the Elementor cache (Elementor → Tools → Regenerate Files & Data) and reload the editor.

Recovery & Safety

AI-driven changes are recoverable through several layers:

One-step undo: Before every builder change, UAE snapshots the previous content. Just ask the AI to “undo that” and it will restore the snapshot.

Elementor revision history: Content edits also create Elementor revisions, so you can roll back to any earlier version from the editor’s History panel.

Trash, not delete: Deleting a page or template moves it to Trash. Dedicated Restore abilities let the AI bring it back if needed.

Object-level permissions: The AI can only edit content that the connected WordPress user is allowed to edit. It cannot access or modify other users’ content.

Capabilities & Permissions

Every ability checks WordPress capabilities at execution time. The AI client acts as the authenticated WordPress user.

FAQ

Do I need a separate config for UAE Lite and UAE Pro? No. Both use the same AI Tools settings page and the same UAE endpoint. There is nothing separate to configure for Pro, its extra abilities appear automatically when Pro is active.

Can multiple AI clients connect at the same time? Yes. Each client authenticates independently using its own Application Password.

Is my content sent to AI providers? Only when the AI client requests it through a tool call. UAE does not send data to any external service on its own. The AI client processes data under its own privacy policy.

What happens if I deactivate UAE? Its abilities are unregistered and AI clients will no longer see UAE tools. Your templates and content are unaffected.

Does this work on a local development site? Yes. For .local or .test domains, use the Claude Desktop config with @automattic/mcp-wordpress-remote, which handles local SSL. HTTP-based clients work with local URLs directly.

What is the UAE Pro endpoint? UAE Pro uses the same endpoint as Lite. When Pro is active alongside Lite, Pro’s extra abilities are added automatically to the same UAE endpoint, no separate URL needed.

Still stuck? Contact our support team and include your WordPress version, UAE version, and a description of the issue.