MCP Tools

MCP Tools lets you decide which AI tools are available on your WordPress site. It gives you one screen where you can review every available tool and turn each one on or off.

The plugin also adds two content tools. Create Post or Page creates new WordPress content, and Update Content Status changes the status of existing posts and pages. These tools can be used by AI agents and automation systems that are connected to your site.

Getting Started

  1. Install and activate the plugin.
  2. Make sure the MCP Adapter module is installed and active.
  3. In the WordPress admin menu, click MCP Tools.
  4. Review the list of tools and uncheck any tool you do not want to use.
  5. Click Save Changes.

Only administrators can open the MCP Tools screen. All tools are enabled by default.

If the MCP Adapter module is missing, the screen shows this notice:

The MCP Adapter module is missing. Activate or install it to ensure all functionality is available.

Use the Install or Activate button in the notice. If the automatic install does not work, install and activate MCP Adapter from the Plugins screen.

Quick Start

For most stores, the simplest setup is to keep all tools enabled:

  1. Open MCP Tools.
  2. Confirm that the Enabled checkbox is checked for each tool you want to use.
  3. Click Save Changes.

The tools are then available to MCP-enabled environments connected to your site.

Plugin Features

Feature What it does
Tool control Lists the available MCP tools and lets you enable or disable each one.
Create Post or Page Creates a new WordPress post or page, including drafts, pending content, and published content.
Update Content Status Changes the status of an existing post or page to draft, pending, publish, private, or trash.
Support for other plugins Shows tools added by other plugins, so you can enable or disable them from the same screen.

Plugin Settings

Enabled

The Enabled checkbox controls whether a tool is available. Leave the box checked to keep the tool enabled. Uncheck it to disable the tool.

Default: Checked. All tools are enabled when you first open the screen.

What happens after saving: A disabled tool is removed from the tools available to connected AI clients. It does not delete any posts, pages, or other content.

A disabled tool stays in the list so you can enable it again later. If the plugin that provides a disabled tool is no longer registering it, the tool still appears with this description:

This ability is disabled and is not currently registered.

The checkbox does not take effect until you click Save Changes.

Tool List Columns

The screen shows these columns:

Column What it shows
Enabled The checkbox that turns the tool on or off.
Tool The tool label. The tool category is shown below the label when one is set.
Ability name The name of the tool.
Description What the tool does.

Tools are grouped by category. Tools added by this plugin are marked with the This plugin badge.

Create Post or Page

This tool creates a new WordPress post or page. New content is created as a draft by default.

Available Fields

Field Required What to provide Default
Post type No Choose post or page. Post
Title Yes The title of the new post or page. None
Content No The body content, entered as HTML or block markup. Empty
Excerpt No A short summary of the content. Empty
Status No Choose draft, pending, or publish. Draft
Slug No A URL slug. Leave it empty to let WordPress create the slug from the title. Created from the title
Parent ID No The ID of an existing page. This field is used for pages only. None

What the Tool Returns

After creating content, the tool reports:

Permissions

Validation

Update Content Status

This tool changes the status of an existing post or page.

Available Fields

Field Required What to provide
Post ID Yes The ID of an existing post or page.
Status Yes Choose draft, pending, publish, private, or trash.

Status Options

Status What it means
Draft The content is saved as a draft.
Pending The content is saved for review.
Publish The content is published. This requires permission to publish.
Private The content is set to private. This requires permission to read private posts.
Trash The content is moved to the trash. The previous status is kept so the content can be restored.

Supported Content

By default, this tool only works with posts and pages. It does not change WooCommerce products, orders, coupons, or other custom post types.

Permissions

If the content does not exist, is not a supported type, or the user cannot edit it, the tool returns the same message:

Content not found, or you are not allowed to change it.

What Happens in Special Cases

Examples

Example 1: Create a Draft Page

A store owner wants to prepare an About Us page without publishing it yet.

Field Value
Post type Page
Title About Us
Content <p>Learn more about our store.</p>
Status Draft

Result: A new page titled About Us is created as a draft. The result includes the new post ID, the admin edit URL, and the page URL.

Example 2: Publishing Is Blocked Without Permission

A user can create posts but cannot publish them.

Field Value
Post type Post
Title Summer Sale
Status Publish

Result: The post is not created. The tool returns: You are not allowed to publish. Use status draft or pending. The user can retry with the status set to draft or pending.

Example 3: Move a Post to the Trash and Restore It

A store owner wants to remove a post from the site and later bring it back.

Step Post ID Status
First 123 Trash
Then 123 Draft

Result: The first request moves the post to the trash. The result shows the previous status and the new status of trash. The second request restores the post from the trash and sets it to draft. The result shows trash as the previous status and draft as the new status.

Example 4: Publish a Future-Dated Post

A post has a future publish date.

Field Value
Post ID 456
Status Publish

Result: The post is scheduled instead of published. The tool returns: Content has a future date, so it was scheduled instead of published. The new status is future.

Important Notes

Troubleshooting

The MCP Adapter Notice Appears

Symptom: The screen shows a notice that the MCP Adapter module is missing.

Cause: The MCP Adapter module is not active.

Solution: Click Install or Activate in the notice and wait for the page to reload. If the automatic install fails, install and activate MCP Adapter from the Plugins screen.

No MCP Abilities Were Found

Symptom: The screen shows: No MCP abilities were found. Please make sure the WordPress Abilities API is available.

Solution: Check that the WordPress Abilities API is available on your site and that the MCP Adapter module is active.

A Tool Is Not Available to the AI Client

Solution:

  1. Open MCP Tools.
  2. Confirm that the Enabled checkbox is checked for the tool.
  3. Click Save Changes.
  4. Confirm that the MCP Adapter module is active.

A Status Change Is Rejected

Symptom: The tool returns: You are not allowed to set this status.

Cause: The connected user does not have the permission required for that status.

Solution: Publishing needs publish permission, private needs permission to read private posts, and trash needs delete permission for that item.

Frequently Asked Questions

Does unchecking a tool delete it?

No. The tool is only removed from the tools available to connected AI clients. It stays in the list and can be enabled again.

Can I create WooCommerce products with these tools?

No. Create Post or Page only supports posts and pages. Update Content Status only changes posts and pages by default.

Can I schedule a post with Update Content Status?

Not directly. future is not an accepted status. Setting a future-dated post to publish makes WordPress schedule it.

Why does a disabled tool still appear in the list?

Disabled tools stay visible so you can turn them back on. If the plugin that provides the tool no longer registers it, the row shows the message This ability is disabled and is not currently registered.

Can I disable tools added by other plugins?

Yes. The MCP Tools screen lists tools from every plugin and lets you enable or disable them.