Easy MCP AI Docs

Appearance

Enabled Tools Not Showing in Your AI Client ​

If you switched on a tool in Easy MCP AI (an External Data provider, a plugin integration, or an ability) and your AI assistant still can't see it, work through this page from the top. In most cases the change is already live in WordPress, and your AI client is still showing the tool list it loaded earlier.

In this article

Refresh the Tool List in Your AI Client ​

AI clients load the list of available tools when they connect, and most of them keep using that saved list afterwards. Easy MCP AI builds the list fresh on every request, but it does not notify connected clients when the list changes, so your client only sees new tools after you make it load the list again. Starting a new chat on its own is often not enough.

Once a tool is switched on and saved in WordPress, nothing on the WordPress side needs to be cleared or rebuilt. There is no tool cache in WordPress, your caching plugin, or your CDN that affects this, and you do not need to delete and re-add the connection. If the missing tool is a WordPress ability that doesn't appear in Easy MCP AI at all, refreshing your client won't help: follow Check That the Tools Are Switched On in WordPress first.

Find your client below and follow its steps.

ChatGPT ​

  1. Open Plugins in the ChatGPT sidebar and select your WordPress connector.
  2. Click Refresh next to Information.
  3. Check the connector's Actions list on the same page. If a new action is listed but not available, turn it on.
  4. Start a new chat and enable the connector there. A chat that was already open keeps the old tool list.

For screenshots and the full procedure, see Connect ChatGPT to WordPress.

ChatGPT workspaces

In a ChatGPT Enterprise or Edu workspace, a published connector keeps the tool list it had when it was published. A workspace admin must go to Workspace settings > Apps, open the ... menu next to the connector, select Action control, click Refresh, and then select the new actions, because they arrive switched off. In a ChatGPT Business workspace, a published connector cannot be updated, so an admin has to create and publish it again.

Claude.ai and Claude Desktop Connectors ​

  1. Go to Customize > Connectors and select your WordPress connector under Your connectors.
  2. Open the ... menu next to Disconnect and choose Refresh tool list.
  3. Under Tool permissions, look for the new tools. If a tool is set to Blocked, change it to Needs approval or Always allow.
  4. Start a new conversation, click +, open Connectors, and make sure your WordPress connector is turned on for that conversation.

Claude Desktop with a Configuration File ​

If you connected Claude Desktop by editing claude_desktop_config.json instead of adding a connector, Claude Desktop only loads the server's tools when it starts.

  1. Quit Claude Desktop completely. Closing the window is not enough, because the app keeps running in the background.
  2. Open Claude Desktop again and start a new conversation.

Claude Code ​

  1. Run /mcp in Claude Code.
  2. Select the wordpress server and choose Reconnect.

Claude Code then loads the tool list again from your site. Use Reconnect instead of only restarting Claude Code, because a restart can reuse the previously saved tool list.

Cursor ​

  1. Open the Customize panel in Cursor's sidebar.
  2. Turn the wordpress server off with its toggle, then turn it on again.
  3. If the new tools still don't appear, quit and restart Cursor.

GitHub Copilot in VS Code ​

  1. Open the Command Palette (Ctrl+Shift+P on Windows and Linux, Cmd+Shift+P on macOS) and run MCP: Reset Cached Tools.
  2. Run MCP: List Servers from the Command Palette, select the wordpress server, and restart it.
  3. In Copilot Chat, switch to agent mode, open Configure Tools, and make sure the new WordPress tools are selected.

Tool limit in VS Code

VS Code allows at most 128 tools in a single chat request. Easy MCP AI can expose more than that once you switch on several integrations. If VS Code warns that you have too many tools, open Configure Tools and deselect the tools you don't need for the task.

OpenAI Codex CLI ​

  1. Quit your current Codex session and run codex again. Codex loads the tool list when a session starts. In the Codex IDE extension, use Restart extension instead.
  2. If the new tools are still missing, open your Codex config.toml and look at the [mcp_servers.wordpress] section. If it has an enabled_tools list, Codex only shows the tools named in it, so add the new tools there or remove the list. Also check that the new tools are not in disabled_tools.

Google Antigravity ​

  1. In the Antigravity App, open Customizations > Installed > MCP Servers. In the IDE, open MCP Servers > Manage MCP Servers from the agent side panel.
  2. Click Refresh next to the wordpress server if shown, or use More actions > Restart if your interface offers that instead.
  3. If the new tools still don't appear, restart Antigravity.

OpenCode ​

  1. Quit OpenCode and start it again in the same project. OpenCode connects to MCP servers when it starts.
  2. If the new tools are still missing, check the tools section of your OpenCode configuration. A pattern such as "wordpress*": false switches off every WordPress tool, including new ones.

Manus ​

  1. In Manus, open Settings > Connectors and remove your WordPress connector.
  2. Add it again with the same values, following Connect Manus to WordPress. Manus loads the list of available tools when it connects to a server.

Other AI Clients ​

Look for an option to refresh, reload, or reconnect the MCP server in your client's settings. If there isn't one, restart the client. If that doesn't help, remove the server and add it again.

Check That the Tools Are Switched On in WordPress ​

A tool is only offered once the feature it belongs to is switched on and saved. Go to Easy MCP AI > Tools and check the section that matches the tool you are missing:

  • External Data tools (Google Analytics, Search Console, DataForSEO, Semrush, SE Ranking, Ahrefs): open the External data section. A provider needs credentials, either saved in WordPress or supplied through wp-config constants or environment variables. Deployment-controlled credentials cannot be edited here; configuration errors must be corrected in the deployment source. Ahrefs is off by default, and saving its key switches its tool on. Each provider also has a list of its individual tools, so make sure the tools you need are enabled there, then click Save changes.
  • Plugin integration tools (for example WooCommerce, Advanced Custom Fields, or SEO plugins): open the Abilities section, enable the integration, and click Save changes. The plugin the integration works with must also be installed and active on your site.
  • WordPress Abilities registered by other plugins: open the Abilities section. All abilities are off by default, so enable the abilities you want to use and click Save changes.
  • Privileged tools (the search and replace tool and the file tool): these are switched on under Easy MCP AI > Settings > Advanced > Disabled tools, not on the Tools screen. They have extra requirements on who and which connections can use them; see Privileged Tools in Easy MCP AI.

Some abilities registered with WordPress are intentionally unavailable in Easy MCP AI. The MCP Adapter and Angie discovery and execution abilities, as well as angie/read-resource, are excluded so their individual tool switches remain effective. Reconnecting or changing saved selections will not make these abilities available. Use other eligible abilities instead.

For other missing abilities, check whether the provider has registered them:

  1. Make sure the plugin that provides the ability is installed, active, and updated to its latest version.
  2. Check that plugin's own settings. Many plugins only register their abilities after you turn on an option in their settings that allows AI or Abilities API access. Burst Statistics, for example, has its own setting for this.
  3. Go back to Easy MCP AI > Tools, open the Abilities section, and check whether the ability now appears. If it does, enable it and click Save changes.

If an ability that is not intentionally excluded still doesn't appear after these checks, contact the support team of the plugin that provides it about ability registration.

After you save, go back to Refresh the Tool List in Your AI Client.

Check What Your Connection Is Allowed to Use ​

Each connection to your site has its own permissions, so a tool can be switched on and still be hidden from one particular connection.

API Tokens ​

Go to Easy MCP AI > Connections, open the API tokens tab, and click Edit on the token your client uses. Check its Access level:

  • Full access includes all tools, current and future, so a newly enabled tool is included automatically.
  • Read-only includes the read tools that existed when the token was saved. Tools added later are not included.
  • Custom includes only the tools selected for the token. Select the newly enabled tool.

Save the token after making changes. For details, see Creating and Managing API Tokens.

OAuth Connections ​

Clients that you connected by signing in and approving the connection (such as ChatGPT, Claude, and Claude Code) use an OAuth grant instead of a token.

  1. Go to Easy MCP AI > Connections and open the OAuth tab.
  2. Under Active grants, find the connection and check its Access level.

Edit scope can only narrow a grant. It cannot give a connection access to more tools. If the grant doesn't include the new tool, connect the client again and approve the connection with an access level that includes the tool, such as Full access. For the steps in your client, see its connection guide, for example Connect ChatGPT to WordPress or Connect Claude.ai to WordPress. For more on grants, see Managing OAuth Access.

Refresh the tool list in your client afterwards.

Check Site-Wide Settings and User Roles ​

These settings can hide a tool from every connection:

  • Disabled tools: go to Easy MCP AI > Settings, scroll to the Advanced card, and check that the tool's checkbox is not ticked under Disabled tools. A tool switched off there is hidden from every token and OAuth connection, including a Full access connection that belongs to an administrator. On a new installation, Easy MCP AI switches off a set of tools that make site-wide changes, such as the tools that activate, deactivate, or update plugins (wp_activate_plugin, wp_deactivate_plugin, and wp_update_plugin) and the tools that manage users, change themes, and update site settings. On Easy MCP AI > Tools > Core, these tools show a Disabled badge and can't be switched on from that screen. To switch one on, clear its checkbox under Disabled tools, click Save changes, and then refresh the tool list in your AI client.
  • EASY_MCP_AI_TOOLS in wp-config.php: a tool switched off there, or left out of a list that ends in *=off, is hidden from every connection, and its row on the admin screens is locked. A tool added by a plugin update stays hidden under *=off until it is named. See Switch Tools On or Off from wp-config.php.
  • Minimum Capability for External Data Tools: the Google Analytics, Search Console, DataForSEO, Semrush, and SE Ranking tools are shown only to connections whose WordPress user has the capability set in Easy MCP AI > Settings, which is Administrator by default. This is why a connection that belongs to an Editor or Author can't see them. Lower the setting if those users should have access.

Confirm Which Tools a Connection Can See ​

The Diagnostics card on the Easy MCP AI Dashboard checks whether each API token can see tools and names the setting that hides them. It also flags OAuth connections that have no usable permissions.

  1. Go to Easy MCP AI > Dashboard.
  2. On the Diagnostics card, click Re-run and wait for the results.

For help reading the results, and for what to send the support team if a tool still doesn't appear, see Troubleshooting Easy MCP AI Connection Issues.

Was this helpful?

Copyright (c) 2026 Easy MCP AI