Agent Abilities for MCP – Connect Claude and ChatGPT with Permission Controls and Audit Log

By Unaib Amir

★ 4.8/5 (5 ratings)1,000+ active installationsVersion 1.12.0

WordPress MCP server for Claude and ChatGPT with limited access, a pause switch, read-only mode, drafts you approve, playbooks and an audit log.

Description

WordPress MCP server for Claude and ChatGPT, with limited access and an audit log

Agent Abilities for MCP is a free WordPress MCP server plugin that exposes WordPress abilities to AI agents. You connect Claude, ChatGPT, Cursor or another MCP client to your site, and the AI works as a WordPress user you pick and gets exactly that user’s role. An Editor connection means limited access, not admin: it can write and edit posts, and it can’t install a plugin or change a setting.

It suits site owners, agencies and developers who want an AI agent working on the site without an admin login. Let Claude or ChatGPT draft posts without publishing them, or give either read-only access so it can look around.

Once connected, you can ask things like:

  • “List my five newest drafts and tell me which ones have no featured image.”
  • “Fix the typo in the second paragraph of the About page.”
  • “Which WooCommerce orders are still on hold?”
  • “Write a post about the spring sale and save it as a draft.”

There are 216 abilities (the tools an AI client can call), 94 for WordPress itself and 122 for plugins such as WooCommerce, ACF and Yoast SEO. Every one starts switched off.

What is a WordPress MCP server?

MCP, the Model Context Protocol, is an open standard that lets an AI app ask a service what it can do and then call it, and a WordPress MCP server is a site that answers. Give Claude or ChatGPT your site’s MCP endpoint, the URL on the plugin’s Connection tab, and it can look up an order or draft a post directly instead of you copying text between a chat window and wp-admin.

Connect Claude to WordPress

Switch on the abilities you want and copy your endpoint from the Connection tab. In Claude, open Customize, then Connectors, choose + Add, then Add custom connector, and paste the endpoint. Approve the sign-in once in your browser. On Team and Enterprise plans an Owner (or, on Enterprise, a role with the right permission) has to add the connector first, under Organization settings, then Connectors.

Anthropic’s help article lists custom connectors on Free (one custom connector), Pro, Max, Ultra, Team and Enterprise. Claude connects from Anthropic’s cloud, so your site has to be reachable from the public internet.

Connect ChatGPT to WordPress

On ChatGPT web, open Plugins, select the plus button, then Add custom MCP server, name it, paste your endpoint under Connection, choose OAuth for authentication, tick the risk acknowledgment and select Create as a plugin. You don’t need to turn on Developer Mode first.

OpenAI’s help article says custom MCP servers and full MCP, writes included, are available on Business and Enterprise/Edu, and that Pro can connect with read and fetch permissions, but it doesn’t mention Free or Plus. On Business, admins and owners add the server, while on Enterprise/Edu admins can, and so can members they grant access to. It’s a web feature only.

Manage multiple WordPress sites from Claude or ChatGPT

Install the plugin on each site and add each endpoint as its own connector. Every site keeps its own user, switches and audit log, so an agency can open one client’s site to the AI without touching the others.

Let Claude or ChatGPT edit WordPress posts without admin access

The role you connect as sets the limit: an Editor can write and edit any post, an Author only its own, and a Contributor can write without publishing. The catch is that on a new install only Administrators can approve a connection. Tick Editor under Roles that can connect on the Settings tab, approve as an administrator and pick the Content editor preset, or use the Application Password route with an agent user you’ve given the Editor role.

Let Claude or ChatGPT draft posts without publishing

Start with Force draft on create in Settings. What the AI creates or tries to publish as a post, page, custom content item, reusable block or WooCommerce product is saved as a draft instead, and a product variation is saved as disabled (private).

The Needs review card on the Dashboard lists those drafts with Preview, Open in editor, Publish and Discard buttons, and Discard moves the post to the Trash. Edits to a post that is already live still go live, so connect the AI as a Contributor, who can’t edit published posts, if every change needs your approval.

Give an AI agent read-only access to WordPress

Turn on read-only mode in Settings and this plugin unloads every write tool, including write tools bridged from other plugins, so the AI can search and read but can’t change anything through it. Your selections come back when you switch it off. To limit a single connection instead, pick the Read only preset when you approve it.

Update ACF fields and edit one block

With ACF active, the AI can read a post’s fields and write new values, each sanitized for the field’s type. It can also edit a single block: it lists your block types, reads a block’s settings (an ACF block adds its field names) and swaps one block with Replace block, without resending the page.

Limit what an AI agent can do on your site

These controls cover this plugin’s own tools, plus any other plugin’s tool you switch on from the Plugins’ own tools tab. Each call is checked against the capabilities of the WordPress user the AI connects as, over OAuth or an Application Password.

Pause all access on the Connection tab is the emergency stop, the one switch that pauses all agents at once. It refuses every MCP request through your site, OAuth apps and Application Passwords alike. An Application Password can still use the rest of the REST API, so revoke it too for a full cut-off. To pause an AI agent without disconnecting it, use Pause and Resume next to Revoke on an OAuth connection. An OAuth connection can also get an end date, for access that expires, and a lower rate limit of its own; an Application Password has neither.

When you approve an app, or run Quick Connect, you pick an access preset (Read only, Content editor, Shop manager or Custom) that only ever narrows what is already switched on. Per-role and per-connection allowlists narrow it further, since a tool has to be in the global list, the role’s list and the connection’s list before the AI can call it. The rate limit, the IP allowlist, Force draft on create and a maximum title length sit on the Settings tab and do nothing until you set them.

Ten WooCommerce tools that move money or grant authority (refunds, creating and changing orders, customer updates, payment gateways, coupons and tax rates) stay locked until you unlock them in Settings, even if you’ve ticked them. Deletes work differently: the tools named Trash post and Trash page move content to the Trash, but most Delete tools, such as Delete post, Delete page and Delete media, remove it permanently.

What these controls do not cover

The MCP Adapter has a built-in default server that other plugins can publish their own tools to. Tools on that server sit outside this plugin’s controls, so its read-only mode, allowlists, IP allowlist, rate limit and audit log do not apply to them. Pause all access is the exception, since it refuses requests to that server too. A Settings choice, Allow the MCP Adapter’s default server, takes Automatic (the default, which runs it only when another plugin publishes tools there), Always on or Always off. This plugin’s own tools are never on that server.

Audit log: see what the AI did on your site

The audit log is the Activity Log tab. Every call to one of this plugin’s tools lands there, denied calls included, with the reason for a denial. A row shows who made the call, the connection and source IP, the tool, the argument names, how long it ran and a short note on what it touched (ids, slugs and meta key names, never post text or email addresses).

You can filter by user, connection, tool, plugin, date or text, watch the Live view and export what the filters show as CSV. The log is a table in your own database.

Playbooks and Site Brief: standing instructions for AI agents

Write a checklist once on the Playbooks tab, such as how to check a draft before it goes out, and the AI loads it when a task matches. Five starters come built in and arrive switched off. Site Brief on the Settings tab holds a few standing rules, such as your spelling or pages to leave alone, that every agent gets when its session starts.

Two read tools, List playbooks and Get playbook, stay off until you enable them on the Abilities tab. With both on, the AI sees your Active playbooks when a session starts and loads one with Get playbook. It reads the text word for word, so keep passwords and private details out, and agents can’t edit playbooks. A playbook or the Site Brief is guidance the AI may follow, so the controls above still decide what it can do.

AI for WooCommerce, ACF, Yoast SEO and other plugins

When one of these plugins is active, its abilities appear on the Integrations tab. WooCommerce has the most, 52, covering products, variations, orders, customers, coupons, shipping, tax, payment gateways and reports, and because they reach names, emails and addresses an admin notice flags them. ACF adds 7 for field groups and the field values on posts, terms and users, and Rank Math (5), Yoast SEO (3), All in One SEO (3) and Slim SEO (2) let the AI read and edit a post’s SEO data.

The Events Calendar has 13 abilities, Event Tickets 3, Avada 18 and WPBakery Page Builder 12, both for editing pages and builder settings. GeoDirectory’s 4 business listing tools stay off until you enable that integration, even with GeoDirectory active.

Minimum versions: WooCommerce 9.1, All in One SEO 4.9.8, The Events Calendar 6.17.3.1 and Event Tickets 5.29.3.1. Below these, their tools stay hidden and the Integrations tab says why.

Plugins that register their own abilities with the WordPress Abilities API appear on the Plugins’ own tools tab, and this plugin does not filter what another plugin’s ability returns.

Each tool shows which plugin provides it (or its namespace, when the plugin cannot be identified), carries a Read, Write or Destructive label from the plugin’s own annotations (an unlabelled tool is treated as Destructive and says so), and gets a notice when it may return personal data (a hint from the plugin and tool name, not a full check). Tools a plugin update adds wait for your review.

A plugin that doesn’t declare its reads as read-only has them treated as writes, so read-only mode unloads them. A tool whose own permission check needs an item id is listed for anyone who can edit posts, and that plugin’s own check refuses the call if their role can’t run it.

Built on the Abilities API and the MCP Adapter

WordPress 6.9 added the Abilities API, and the official MCP Adapter turns those abilities into MCP tools. The Adapter comes bundled, so there is nothing else to install, and if you also run the standalone Adapter plugin, this plugin uses whichever copy loads first.

Page builders: Avada and WPBakery editable, the rest refused

A page builder owns its page’s layout, so an edit to the post text can report success and change nothing. For Elementor, Divi, Beaver Builder, Avada, Visual Composer, Oxygen, Breakdance, Brizy, Bricks and WPBakery the plugin’s general content tools refuse the write, though an excerpt-only edit goes through unless the plugin can’t tell which builder owns the post. Avada and WPBakery pages get their own editing tools, which refuse any save that changes anything else; Restore revision also works there.

Is this the right WordPress MCP plugin for you?

It fits if you want to decide tool by tool what an AI agent can do. Your AI client talks straight to your site: the plugin calls no AI provider, sends no telemetry and has no relay, account or API key of ours in the path.

It’s a poor fit if you want every tool on from day one, or an undo for every kind of change. The Changes tab can revert changes from 25 of this plugin’s tools for 30 days. Changes from its other tools can’t be undone, including permanent deletes, orders, refunds, user accounts and file uploads.

Compatible clients

Any MCP client that can reach your endpoint can connect. Claude (web and Desktop), ChatGPT and Manus are hosted apps and use OAuth, while Claude Code, Cursor, VS Code, Windsurf and Gemini CLI can use OAuth or an Application Password. The Gemini app has no known way to add a custom MCP server. A client that can’t connect directly can go through a bridge such as mcp-remote, which runs on your own machine.

Disclaimer

The Model Context Protocol is an open specification that Anthropic originally developed. Claude, ChatGPT, Cursor, VS Code, Gemini and other product names belong to their owners, and Agent Abilities for MCP is a third-party plugin that isn’t affiliated with, endorsed by or sponsored by any of them.

External Services

This plugin calls no AI provider and sends no telemetry.

It makes two kinds of outbound request on its own. The first is the Connection tab’s checks: requests from your site to its own address that test the MCP endpoint, header and body delivery and, with OAuth on, the discovery documents. The second only happens if you enable the upload-media-from-url ability, which is off by default: it fetches the exact HTTPS URL your AI client supplies so the file can be added to your media library, refuses private and reserved addresses and follows no redirects. The server at that URL sees the URL, your site’s IP address and the time of the request, and the request carries none of your content, credentials or site data. When an agent calls Avada Studio tools, Avada downloads content from avada.studio under your Avada registration; this plugin sends nothing. Avada’s terms and privacy policy apply.

Connecting a client happens in the client. Some clients reach your endpoint directly, and others use a bridge that runs on your own machine and is not bundled with the plugin:

  • mcp-remote: https://www.npmjs.com/package/mcp-remote
  • @automattic/mcp-wordpress-remote: https://www.npmjs.com/package/@automattic/mcp-wordpress-remote

Installation

  1. Upload the plugin to /wp-content/plugins/agent-abilities-for-mcp, or install it from Plugins, Add New in your admin, then activate it.
  2. Open Agent Abilities for MCP in the admin menu and, on the Abilities tab, switch on the tools you want the AI to have.
  3. On the Connection tab, copy your MCP endpoint and paste it into your AI client. Most clients ask you to approve the connection once in the browser, as your own account.
  4. If a client can’t use OAuth, create the low-privilege agent user the Connection tab offers, add an Application Password for it and connect with that, using the config the tab builds for you.
  5. Click Check my connection to confirm your server answers.

Each client has its own steps in the getting started guide and in connecting a client.

FAQ

More help: Documentation | Troubleshooting | Security | Support forum

What is a WordPress MCP server?

A WordPress site that AI apps can call to do things like list posts or update a product, with this plugin supplying the endpoint and the rules about who can use it and for what.

How do I connect Claude to WordPress?

Follow the steps under Connect Claude to WordPress above, which add your endpoint as a custom connector under Customize, then Connectors. The one thing to add here is that Claude connects from Anthropic’s cloud, so a site on localhost or behind a VPN won’t work. The Claude guide has the full setup.

How do I connect ChatGPT to WordPress?

You don’t need to turn on Developer Mode first, and the steps are under Connect ChatGPT to WordPress above (the ChatGPT guide walks through them too). ChatGPT reaches your endpoint over the public internet, so a site on localhost or behind a VPN won’t connect, and because custom servers are a web feature you can’t add one from the mobile app.

Is it safe to connect ChatGPT or Claude to my WordPress site?

It can be, as long as you keep the access small: the AI works as one WordPress user you choose, this plugin’s tools start off, and each call to them is checked against that user’s capabilities and logged. I’d start with read-only mode or Force draft on create and widen from there once you’ve seen what it does.

What ChatGPT or Claude does with the content it reads is up to that vendor, and text on your own site (a comment, say) can try to steer an AI, a risk called prompt injection that the post on indirect prompt injection covers.

Is Agent Abilities for MCP safe?

The code is GPL-licensed and public on GitHub, the plugin makes no calls to AI providers and sends no telemetry, and it stores OAuth credentials as SHA-256 hashes in its own tables. The security page lists the controls and says how to report a problem.

Does the AI agent get admin access?

Not unless you connect it as an administrator, which I wouldn’t. It gets the role of the user it connects as: for OAuth that’s whoever approves the connection, and Roles that can connect on the Settings tab decides who may approve, with a new install allowing Administrators only. The Application Password route uses a Subscriber account the Connection tab creates, which you can raise to Editor or Author.

An Application Password works across the whole REST API and this plugin’s limits apply only to calls through its MCP endpoint, whereas a token issued over OAuth works on that endpoint alone.

Can I give Claude access to edit posts but not change settings?

Yes, through the user’s role. An Editor can write and publish any post but can’t touch site settings or install plugins, an Author is confined to its own posts, and a Contributor writes without publishing. The Content editor preset narrows it further to posts, pages, media, categories and tags, and because a new install lets only Administrators approve a connection, add the role under Roles that can connect first or approve as an administrator and pick the preset.

Can I stop an AI agent right now?

Flip Pause all access on the Connection tab, the emergency stop for every connected app and Application Password. Nothing is deleted and Resume all access turns everything back on, but since Application Passwords keep working on the rest of the REST API you should revoke one if it has to go.

Can I pause an AI agent without disconnecting it?

Yes. Each approved OAuth connection on the Connection tab has Pause next to Revoke, and a paused connection keeps its sign-in and can still list tools while every tool call comes back with a message that the connection is paused. Resume it and nobody has to approve it again. The same person’s Application Password is unaffected, since it has no pause of its own.

Can I give an AI agent access that expires?

For an OAuth connection, yes. Set an end date on its row on the Connection tab and the connection stops at the end of that day and stays refused until a site administrator renews it, and its old tokens never work again. An Application Password has no end date, so revoke it when the job is done.

How do I give Claude read-only access to WordPress?

Turn on read-only mode in Settings and this plugin loads no write tool, whatever else is ticked, including write abilities you bridged from other plugins. Search and read keep working, and your selections come back when you switch it off. To limit a single connection instead, pick the Read only preset when you approve it.

Can I let ChatGPT draft posts without publishing them?

With Force draft on create switched on in Settings, anything the AI creates and any request to publish is saved as a draft, which covers posts, pages, custom content items, reusable blocks and WooCommerce products. Product variations save as disabled instead, because a draft variation disappears from WooCommerce’s editor. Edits to a post that’s already live still go live, so if every change should be reviewed, connect the AI as a Contributor, who can’t edit published posts. The drafts wait on the Needs review card on the Dashboard.

Can I stop an AI agent from deleting my posts?

I’d leave the delete tools off, which is how they ship. Trash post and Trash page move content to the Trash where you can restore it, but most of the tools named Delete, such as Delete post, Delete page and Delete media, remove it permanently. Read-only mode takes away every write and delete tool of this plugin’s at once and the Content editor preset has no deletes in it, and the Activity Log shows which tool ran on which item though it keeps no copy of deleted content.

How do I see what ChatGPT or Claude did on my site?

Open the Activity Log tab (the guide to finding what an agent did walks through it). Each row gives the time, user, connection, source IP, tool, run time and a short note on what the call touched, such as a post ID or a meta key name, and a 7-day summary sits at the top. Export CSV downloads whatever your filters show. The log records which tool ran on which item and never stores the text the AI wrote.

Is there rate limiting for AI agents?

Yes, once you set it. Enter a number under Rate limit (per minute) on the Settings tab and each agent user can make that many calls a minute, shared across all its connections, with 0 turning the limit off. One OAuth connection can have a lower limit of its own on the Connection tab, in which case its calls count against both, and calls over a cap are denied and logged.

Can I limit the MCP endpoint to certain IP addresses?

Yes. Enter addresses or CIDR ranges, one per line, under IP allowlist on the Settings tab and requests from anywhere else are refused before they sign in. Behind Cloudflare or another proxy, switch on Real visitor address behind a proxy or CDN first, because otherwise the plugin sees the proxy’s address and the allowlist can lock your agents out.

What are the access presets?

A preset caps what one OAuth connection can reach, and you pick it when you approve an app or in Quick Connect and can change it later on the connection’s row.

  • Read only: look at your content, never change it.
  • Content editor: posts, pages, media, categories, tags and playbooks. No deletes, users, settings or comments.
  • Shop manager: everything in Content editor plus WooCommerce, minus deletes and the money and authority tools.
  • Custom: everything you’ve switched on, limited by the approving user’s role.

Someone who approves an app but can’t manage the site gets the default preset or a narrower one, never a wider one.

What are playbooks?

Step-by-step instructions you write on the Playbooks tab, for example how to check a draft before it goes out. A site can keep 50 of them, with steps up to 8,000 characters, and you can add your own or start from one of the five starters. Once List playbooks and Get playbook are switched on, the AI sees your Active playbooks at the start of a session and loads one when a task fits, and the list refreshes when the client reconnects.

Can I manage multiple WordPress sites from ChatGPT or Claude?

Yes. Put the plugin on every site and add each endpoint as a separate connector, and name the connectors after the sites so you can tell them apart in the chat.

Can an AI agent update my ACF fields or edit one block without breaking the layout?

With ACF active, the ACF tools list field groups and read and write field values on posts, terms and users, sanitizing each value for its field type, and a write that names a field ACF doesn’t know is refused with an error that names it.

For layout, the AI can list block types and read one block’s attributes, plus field names and an example for an ACF block. Replace block then swaps one block in a post, found by its position, and leaves the others alone, although WordPress may still sanitize the whole post on save for users who can’t post unfiltered HTML. Questionable block markup saves with a warning unless you turn on Strict block validation in Settings.

Will an agent break my Elementor or Divi page?

A page builder owns its page’s layout, so an edit to the post text could report success and change nothing. Before any write, update-post, update-page, replace-in-post and the other general content tools check whether a page builder owns the post, and if one does they refuse with an error that names the builder.

Elementor, Divi, Beaver Builder, Avada, Visual Composer, Oxygen, Breakdance, Brizy, Bricks and WPBakery are covered. The one write they let through is an edit that only sets the excerpt, which leaves the stored content as it was, and even that is refused when the plugin can’t tell which builder owns the post. Pages built with the other eight builders are edited in the builder itself.

Avada and WPBakery Page Builder pages have editing tools of their own: they read a page as an outline of elements, change an element’s settings or text, add, move and remove elements, and place a saved template or Library item. Each write is refused, with nothing saved, if saving the page as your user would change anything else on it.

Restore revision works on these pages too, and when WordPress keeps a revision the editing tool returns it so the page can be brought back. Remove element is refused when no revision could bring the element back, which means revisions are off, the site keeps only one revision, or the target is an Avada form or off canvas panel. All of these tools start off, and the writes are in no preset except Custom.

What can an agent change on a WPBakery or Avada page?

Text, links, images, colours and spacing work for anyone who can edit the page. Code blocks, raw HTML and JS, Design Options, page CSS and JS, and settings that can carry script need a user who may post unfiltered HTML, and so do square brackets, percent-encoded brackets and data-* attributes in body text.

The site-wide tools (WPBakery settings, Avada Global Options, Avada layouts and their sections, Avada Slider settings and both Avada Studio tools) need a user who can manage options, and so does editing the elements of an Avada layout section. Neither builder’s Role Manager is applied, so the agent gets what its WordPress user can do and no more.

With Templatera active, its templates are listed in place of WPBakery’s saved templates and can be copied into a page or placed by reference, and a Templatera template can be edited like a WPBakery page.

With Avada Core active, an agent can change an Avada Slider’s settings, and Avada page options also work on Avada Slider and Elastic Slider slides. The settings tools return the previous values, which is the way back.

The Avada Studio tools start switched off. The import has its own switch, which no Enable all button ticks, and the list tool is refused until the import is on. When an agent uses them, Avada downloads the catalogue and items from avada.studio under your site’s Avada registration; this plugin sends nothing in that exchange and only checks with Avada that Studio is available. Avada’s terms and privacy policy apply.

Refused on both builders: an element type the builder’s own element map doesn’t list, and a stale element index or page fingerprint. A global Avada Library element is edited in the Library, not on the page that shows it. Adding an element to a WPBakery flexbox or grid container item, or moving one into it, isn’t supported yet, though elements already inside one can be reordered, updated and removed.

Can an AI agent manage my WooCommerce store?

With WooCommerce active, 52 abilities cover products and variations, orders with notes and refunds, customers, coupons, shipping, tax, payment gateways and reports, and because they reach customer data an admin notice flags them. The tools that move money or grant authority stay locked until you unlock them in Settings, and the Shop manager preset leaves them out.

Do I need to install the MCP Adapter? Does it work with the Abilities API?

No, the official MCP Adapter is bundled, and if the standalone Adapter plugin is active too, this plugin uses whichever copy loads first. It builds on the WordPress 6.9 Abilities API.

The Adapter also has a built-in default server that other plugins can publish tools to, and those tools sit outside this plugin’s controls: its read-only mode, allowlists, IP allowlist, rate limit and audit log don’t apply to them, though Pause all access does.

Under Settings, Allow the MCP Adapter’s default server starts on Automatic, which runs it only when another active plugin publishes tools there. Choose Always off to keep it off, or Always on if you ran the standalone Adapter only to reach WordPress core’s public abilities, since those don’t count as a publisher. This plugin’s own tools are never on that server.

Why do I see “Another version of MCP Adapter is already loaded”?

That notice comes from a copy of the MCP Adapter that runs its own loader and finds the adapter already loaded by a different copy. This plugin bundles adapter 0.7.1 and loads it without that loader, so its own copy never prints the notice. When the standalone MCP Adapter plugin is active too, this plugin asks it to step aside quietly, unless your site already sets the WP_MCP_AUTOLOAD constant.

If the notice still shows, another plugin ships its own copy of the adapter. The Connection Doctor report on the Connection tab shows which copy is running. If it says bundled, this plugin’s copy is in use and the notice comes from the other plugin’s copy, so update or remove the plugin that bundles its own MCP Adapter.

How is this different from other WordPress MCP plugins?

Because this plugin’s tools are all off until you switch them on, it’s a poor fit if you want everything available from day one. In exchange the AI acts as a user you choose, each OAuth connection can be paused or given an end date, and the plugin builds on the Abilities API and the MCP Adapter instead of running a server of its own.

Does it send my content to OpenAI, Anthropic or Google?

The plugin never contacts an AI provider and has no telemetry, but your AI client does receive whatever a tool returns, because that is how it reads your site, and what it does with that is covered by the vendor’s terms and your plan. The only request the plugin makes to an outside address is the upload-media-from-url tool, which stays off until you enable it, and External Services above has the details. If you switch on the Avada Studio tools, Avada itself fetches the Studio catalogue and items from Avada’s servers under your Avada registration, and this plugin adds nothing to those requests.

Is it free? Which WordPress and PHP versions? Do I need to know how to code?

It’s free on WordPress.org. There’s no paid tier, the plugin adds no usage limits and it needs no API key. You need WordPress 6.9 or newer, where the Abilities API arrived, and PHP 7.4 or newer. You can get connected without writing code, since the Connection tab gives you the endpoint to paste into your AI client, and developers get filters and a WP-CLI command that are documented on GitHub.

Why can’t ChatGPT or Claude connect?

Click Check my connection on the Connection tab and the Connection Doctor runs its checks from your own server, then names the fix, whether that’s a host stripping the Authorization header, a firewall emptying the JSON body, a redirect or a blocked discovery document. The nginx rule and the Cloudflare and WP Engine steps are in the troubleshooting guide, and server rules that block /.well-known/ or CDN rules such as Cloudflare’s AI bot blocking are common causes.

Why does ChatGPT say my server must advertise PKCE?

That error means ChatGPT never got the plugin’s discovery document, so it couldn’t see the PKCE support listed there. The usual cause is a firewall or CDN rule blocking ChatGPT, or a host serving .well-known from disk before WordPress sees the request. Test from outside your network with curl -sS -A "ChatGPT-User/1.0" https://your-site/.well-known/oauth-authorization-server (on a subfolder install, add the folder: https://your-site/blog/.well-known/oauth-authorization-server), and if the JSON doesn’t come back, allow that path for ChatGPT.

Why is a tool I switched on missing from my agent?

The AI client may be showing an old tool list. To refresh it in ChatGPT, open Settings, then Integrations, then Plugins, pick the app and choose Refresh, and in Claude start a new chat or reconnect the connector. If that isn’t it, the Why is my tool missing? card on the Dashboard lists each of this plugin’s own tools that you switched on but agents can’t see, with the reason, such as read-only mode, the high-risk lock or an inactive plugin.

Why was my browser-based MCP client refused?

The MCP endpoint refuses requests sent from a web page on another site, as the MCP specification requires, while desktop apps, command-line tools and the hosted ChatGPT and Claude apps are unaffected. Developers can allow a browser client they trust with the aafm_mcp_allowed_origins filter.

Can I get an email when something important happens?

Under Settings, Notifications, pick Admin notice only, Email alerts as they happen or One email a day, then tick the events you care about, such as a new app being authorized or a burst of denied calls. Nothing is sent until you do. The safety controls guide lists every event and the sending limits, and the emails themselves link to the Activity Log and never include the content of a call, a user name or an IP address. Where WP-Cron never runs, an alert can arrive an hour or more late.

Can I undo what an AI agent changed?

Yes, for edits made with 25 of this plugin’s tools: posts, pages and custom post types, creates, trashes, block edits, terms, custom fields (post and term meta), featured images and SEO fields. The Changes tab keeps up to 30 days and reverts a change if the item hasn’t been edited since, and it refuses a revert that would overwrite a newer edit. It lists field names, never contents, though the earlier values are stored in a table in your site’s database, and when the history is full the oldest values go first.

No other tool of this plugin’s can be undone, including permanent deletes, orders, refunds, user accounts, file uploads, WooCommerce products, ACF field values, menus, comments and events, and each of them says so in its response. That includes the WPBakery and Avada tools, but a page edit keeps a WordPress revision when revisions are on, and the tool returns it for restore-revision; their settings tools return the previous values instead, and an imported Avada Studio item is removed by deleting it in Avada’s Library. Tools from other plugins aren’t recorded either. Notifications, webhooks and anything already read are not recalled. Some plugins, GeoDirectory among them, turn revisions off for the whole site; a WP_POST_REVISIONS line in wp-config.php turns them back on.

Two optional tools, list-changes and undo-change, let an agent undo its own changes from the last 24 hours, and both start off. History records only while the plugin is active, can be switched off in Settings and is removed on uninstall. WordPress’s export and erase personal data tools cover it.

Does uninstalling the plugin revoke my agent’s access?

Not by itself. Deleting the plugin leaves the dedicated agent user and its Application Passwords in place because they’re ordinary WordPress accounts, and by default it keeps your settings, activity log and OAuth data too, so a reinstall picks up where you left off. Switch on Delete data on uninstall in Settings first if you want that data removed (change history is always removed, whatever that switch says), and to cut an agent off, revoke its OAuth connection on the Connection tab or delete its Application Password or user on the Users screen.

How do I report a security issue?

Use the Report a vulnerability option on the Security tab of the GitHub repository so the report stays private until there’s a fix. The security policy lists the other contact route.

Screenshots

Changelog

1.12.0

  • Feature: Agents can edit WPBakery Page Builder and Avada pages element by element with tools such as avada-update-element and wpbakery-insert-template. Restore revision works there too. See every tool.
  • Feature: Users who can manage options can change WPBakery settings, Avada Global Options, layouts and Slider settings, and import Avada Studio items. Page CSS and page options can be set per page.
  • Feature: list-navigations and update-navigation read and replace block-theme menus, pages take a parent and a template, update-site-settings sets the static homepage, and wc-update-product can remove an attribute.
  • Feature: Connection adds Add to Cursor and Add to VS Code links and can end tokens issued for an old site address. Other plugins is now Plugins’ own tools, and the accent follows your Admin Color Scheme.
  • Fix: update-page, update-post and replace-in-post overwrote Divi page layouts and now refuse them, and avada-replace-text refuses a save that would strip other content.
  • Fix: Expired or revoked OAuth tokens now get error=”invalid_token”, and alert emails go through WP-Cron on hosts that can’t finish the page before sending.

1.11.2

  • Feature: A new Changes tab keeps 30 days of what agents changed with 25 tools and reverts a change if the item hasn’t been edited since, and a site-wide find and replace reverts as one group. Every write tool now reports whether its change can be undone, with a reason when it can’t (permanent deletes, orders, refunds).
  • Feature: Two new tools, list-changes and undo-change, let an agent see and undo its own changes from the last 24 hours, up to 30 undo calls an hour per connection. Both start off, and undo-change is destructive, so the Read only, Content editor and Shop manager presets leave it out.
  • Fix: wc-update-payment-gateway’s order is now a zero-based position, as wc-get-payment-gateway reports it, and the write renumbers the stored gateway order, so a script that passed a stored sort value now gets a position. wc-get-order returns payment_method and payment_method_title, a variation’s sale price can be cleared with an empty string, and WordPress’s export and erase personal data tools now cover the activity log and the new change history.
  • Fix: A refund above the remaining amount, a user deleting their own account, deleting or demoting the last administrator, a missing reassign user, trashing an item already in the Trash and a tool aimed at a content type that isn’t exposed now each return a named error instead of a generic one.
  • Chore: Change history is stored in its own table, which is dropped on every uninstall and emptied by Reset, and several tool descriptions and messages were reworded.

1.11.1

  • Fix: The high-risk lock now holds wc-create-order, WooCommerce’s own order status and order update tools, and the Secure Custom Fields tools that can store a callback name, and its filter accepts other plugins’ slugs. Shop manager connections no longer reach wc-create-order, and post tools no longer reach a type whose own tool is off.
  • Fix: Agent writes to WPBakery, Bricks, Oxygen, Breakdance and Brizy pages are refused, but a page builder’s post or page now accepts an edit that only sets the excerpt and keeps its stored content as it was, unless the plugin can’t tell which builder owns it. A role with only read_private_posts no longer lists other people’s drafts, the user meta tools can’t reach the MCP session store, Test connection no longer sends your login cookies to another host, and a bridged tool’s crash text no longer reaches the agent under WP_DEBUG.
  • Fix: Bridged WooCommerce product create and update tools no longer leave ChatGPT stuck on an old tool list. Rank Math’s get-head shows a post’s own title and description, the Activity Log records which object each built-in write tool changed (a count for the site-wide replace), and invalid URLs, an event end before its start, a sale price above the regular price and similar bad input are refused with an error instead of being saved or ignored.
  • Fix: A batch of smaller fixes across Quick Connect and Reset, subsite deletion, Force draft on product variations, meta tools that now say why a key was refused, the product types wc-create-product offers, protected excerpts, term backslashes, empty meta, SEO head and search answers, OAuth discovery on subfolder installs, and LiteSpeed and WP Fastest Cache purging after agent meta writes.
  • Chore: Five old admin save actions are gone (a script calling them directly should use aafm_save_abilities_page), readme wording is corrected, and integration minimum versions are listed.

1.11.0

  • Feature: The Other plugins tab says which plugin provides each group of tools (or its namespace, when the plugin cannot be identified), labels each tool Read, Write or Destructive from the plugin’s own annotations (an unlabelled tool is treated as destructive and says so), and marks tools that may return personal data such as form entries, orders, learner or member records. That mark is a hint from the plugin and tool name, not a full check.
  • Feature: When a plugin update or a newly activated plugin adds tools, a “New tools since your last review” card lists them. They stay off until you switch them on, and Settings can send a notification for them.
  • Feature: Each plugin on the Other plugins tab has an “Allow only read tools” button, and the Activity Log can filter to one plugin’s tools.
  • Fix: A bridged tool’s error names the plugin, using the name from its header once cleaned up, for example “WPForms Lite” instead of “wpforms”, or names the tool namespace and says so when the plugin cannot be identified. The Quick Connect note no longer promises deletes go to Trash, the upload tools name the upload-files capability, and Content editor and Shop manager say they can read playbooks.
  • Chore: The TEC events list says whose draft events it returns, the Avada descriptions lost a dash, and leftover internal notes came out of the plugin’s PHP comments.

1.10.2

  • Fix: A request from another site’s web page now gets a 403 even when it carries wrong credentials, and responses requested with ?_envelope=1 send Cache-Control: no-store like every other response.
  • Fix: Content editor and Shop manager connections can read playbooks. The Playbooks editor refuses to save over a playbook someone else changed after you opened it, and keeps your text in the form.
  • Fix: The unknown ACF field refusal names fields only for callers who can list them. A paused connection no longer leaves a “paused” note in the server instructions after you resume it. An app the site no longer recognizes now gets the steps and MCP URL to add it again.
  • Fix: Seven integration tool descriptions now match what the tools do, and every description that lists page builders names all five.
  • Chore: The ability picker on the Playbooks tab has space between its search box and the count line.

1.10.1

  • Feature: The new Playbooks tab holds step-by-step instructions for agents. Tick the abilities each one uses or add one of five starters. Two read tools, off until you enable them, let agents list and load Active playbooks.
  • Fix: A paused connection now signs in and lists tools, and each tool call returns a message that the connection is paused. Claude used to show a firewall or sign-in error instead.
  • Fix: The MCP endpoint refuses requests from web pages on other sites, as the MCP specification requires, and sends Cache-Control: no-store on every response. Clients that open with server discovery now get the playbook list too.
  • Fix: A blocked address, the rate limit and an unknown ACF field name now say why in the refusal. An unreadable playbook list is reported rather than overwritten, and a connection row shows Saved after you save it.
  • Chore: New FAQ answers cover refreshing a client’s tools, ChatGPT plans, playbooks and refused browser clients. The delete-tool and ChatGPT menu wording is corrected.

1.10.0

  • Feature: Each OAuth connection can be paused and resumed without signing in again, given an end date and a lower rate limit of its own, and shows when and from which address it was last used. Approving an app, and Quick Connect, offer Read only, Content editor, Shop manager or Custom access.
  • Feature: The Connection tab now has OAuth and Application Passwords tabs, a token lifetimes card (the client registration switch moved there from Settings), a switch that pauses all MCP access to the site, and a list of the agent users’ Application Passwords with their last use and a Revoke button.
  • Feature: Settings can limit which roles may connect an app and can read the visitor’s real address behind Cloudflare or another proxy. Connection Doctor checks MCP headers, JSON bodies, redirects and stale or blocked discovery documents; the Dashboard says why an enabled tool is missing; tabs show a dot while they have unsaved changes; the Abilities tab opens on an All view listing every ability under its category, with the same bulk buttons each category has.
  • Feature: Agents can list the site’s block types and read one block’s attributes, supports and styles, plus, for ACF blocks, its field names, choices and an example payload. A new Replace block tool swaps one block in a post or page without resending the whole page. Like every other tool, they stay off until you turn them on in the Abilities tab.
  • Fix: Plain attribute text that WordPress would only entity-encode, such as an & in an ACF field, is now stored as written for users who may post unfiltered HTML, style and script elements are removed with their contents, WooCommerce product descriptions and Events Calendar events no longer strip the backslash escapes from block attributes, and writes that return content warnings now also flag unknown blocks or ACF fields, invalid attribute JSON and ignored block gaps. A custom-field-only change now clears that post’s or term’s cache entry (with an action for page caches and an opt-in full re-save for caches that need one), blank-looking IP allowlist lines are dropped, Settings and the Dashboard no longer scroll sideways on a phone, new drafts report real dates, OAuth clients and tokens record their creation time in UTC, and the Activity Log and Connection Doctor show placeholders while they load. The bundled MCP Adapter moves to 0.7.1.

1.9.0

  • Feature: The Activity Log can be searched and filtered by user, connection, tool, plugin, date and text. Each call shows its connection and IP address, and its duration when it ran; the log adds a 7-day summary and a Live view. The CSV export follows your filters.
  • Feature: Optional alerts, off by default: an admin notice, an email right away or a daily email when an app is authorized to connect, an Application Password is created for a user who can edit posts or for the agent user, a high-risk tool or permanent delete runs, calls are denied in a burst, or read-only mode or the high-risk lock is switched.
  • Fix: A denied call now records why in the Activity Log, for example “key is not on the allowlist”; the message the agent sees is unchanged. Reading a meta key now logs a note the way writing one does.
  • Chore: The Cloudflare advice in the FAQ, README and Help tab now points to “Configure AI bot policies” instead of the deprecated “Block AI bots” switch, and adds steps for WP Engine edge traffic rules and HTTP 429 limits.

1.8.1

  • Fix: Bridged tools such as WooCommerce orders and products failed in strict clients like Claude when a value didn’t match the format the source plugin declared, for example a date without a timezone or an empty URL. Bridged tools no longer advertise strict formats; the values are unchanged.

1.8.0

  • Feature: A Site Brief box on the Settings tab lets you describe your site in a few lines. Every agent that connects to this plugin reads it.
  • Feature: The Connection tab has a Connection Doctor. One click checks the connection from your own server and tells you what to fix, for example a host that strips the Authorization header.
  • Feature: A Needs review card on the Dashboard lists the drafts your agents wrote, with Preview, Open in editor, Publish and Discard buttons. Discard moves the post to the Trash.
  • Fix: Other plugins’ tools on the MCP Adapter’s default server stopped working while this plugin was active. A new Settings switch (Automatic, Always on, Always off) brings that server back, and existing sites move to Automatic, which starts it only when another plugin publishes tools there. This plugin’s own tools never appear on it, so a site that used it only for WordPress core abilities should pick Always on.
  • Fix: With Force draft on, an agent that sent “publish” again for a post that was already live took it offline. The post now stays live. A “WP_MCP_VERSION already defined” warning next to the standalone MCP Adapter 0.6.x and a Settings crash with an older adapter copy are also fixed, and the plugin title now names Claude and ChatGPT.

1.7.10

  • Fix: Query Monitor showed a “bundled dependency” deprecation warning from the MCP Adapter on every request that started it; it no longer does.

1.7.9

  • Fix: With the standalone MCP Adapter plugin (0.7.0) active and loading before this one, the /mcp endpoint returned a 404. It now serves in either load order.
  • Fix: The standalone MCP Adapter plugin showed a red “Another version of MCP Adapter is already loaded” notice while this plugin’s copy was in use. It no longer does.
  • Fix: The adapter’s per-request “bundled dependency” deprecation line no longer lands in the PHP error log.
  • Chore: The bundled MCP Adapter moves from 0.6.1 to 0.7.0, and adapter versions 0.6.1 through 0.7.x are supported. The adapter itself now returns error -32602 instead of -32003 for an unknown tool, and clients must send the MCP-Protocol-Version header after initialize.

1.7.8

  • Feature: A bridged ability’s error now says which plugin returned it, and the Activity Log records that plugin’s error code (the code only, never its message).
  • Fix: 37 bridged tools from WooCommerce, Meta Box, SiteOrigin, Premium Addons, SEOPress, WPForms, Elementor and ElementsKit worked when called but never showed in the tool list. They now list for users who can edit posts, and the source plugin still decides whether a call is allowed.
  • Fix: Deleting through bridged ACF reported an error after the item was already deleted. It now returns ACF’s own result.
  • Fix: Bridged results holding plain objects (such as a PixelYourSite response) were refused after the write had already happened. They now come through, and a refused call is logged as an error instead of success.
  • Fix: On WordPress 7.0 and later, the raw exception text from a throwing plugin no longer reaches the client.

1.7.7

  • Feature: The Abilities tab now has one Save changes button that saves every section on it, with an “Unsaved changes” note and a warning if you leave the page with edits pending.
  • Feature: The Activity Log gets a row when an exposed list changes (content types, or post, user or term meta keys), giving the list name and how many keys were added and removed.
  • Fix: Edits to exposed meta keys or content types were lost when you pressed only the main Save. The four separate section buttons are gone, and the one Save covers them.
  • Fix: When a section fails to save, the page names it and keeps your edits so you can retry. Sections that did save stay saved.
  • Fix: The Activity Log table scrolled sideways when a value such as the detail JSON was long; the columns now share the page width and long values wrap.

1.7.6

  • Fix: An OAuth token issued for the MCP endpoint also signed its holder in on other REST routes, admin-ajax.php, admin-post.php, the comment form, the OAuth authorize screen and discovery URLs. It now works on the MCP route only.
  • Fix: Meta, SEO, media, WooCommerce and The Events Calendar writes now check the database for what actually landed and report written, unchanged, refused or a failed read. The Activity Log records each outcome, identifiers only.
  • Fix: Read-only mode, the high-risk lock, ability switches and the allowlist are read from the database on every MCP request. A failed read keeps the stricter setting, so a stale object cache can’t loosen them.
  • Fix: WP-CLI printed a pair of “called incorrectly” notices for each enabled bridge tool whose source plugin was inactive; those tools are now skipped quietly. Activity Log rows for denied calls now read “Attempted: …” instead of looking like the change happened.
  • Fix: Under a persistent object cache, the review prompt wiped other plugins’ cached “option doesn’t exist” entries; it now clears only its own. Smaller fixes land in replace-sitewide, WooCommerce gateway ordering, the Rank Math and AIOSEO head previews, and several tool descriptions.

1.7.5

  • Feature: The Connection tab swaps the allowlist textarea for a searchable checkbox picker and adds role and client selects, a Client ID copy control, paginated tables, and cross-tab abilities search.
  • Fix: A zero-match abilities search left the Save button stranded on an empty card; the savebar now hides and returns with the results.
  • Fix: The client picker’s hover and selected states looked identical; hover is now a border outline only.
  • Fix: Ability order now survives a re-save, a stale search clears on keyboard navigation, a large allowlist no longer renders every checkbox at load, and new controls have accessible names and translations.
  • Fix: Post, block and template writes now confirm what landed, a stuck OAuth migration can no longer re-enable a switch you disabled, comment counts no longer include hidden comments, and a failed token revoke no longer reports success.

Full release history.