Get the plugin
WP MCP/Integrations/AIOSEO MCP

AIOSEO MCP · Free and Pro

AIOSEO MCP: All in One SEO metadata, edited by an AI agent.

An AIOSEO MCP server lets an AI agent work on All in One SEO without anyone opening the AIOSEO panel on each post. WP MCP reads and writes the row AIOSEO keeps for every post, snapshots that row before each change, and clears AIOSEO's cache so the result shows straight away.

Self-hosted · snapshot before every write · one-click undo

What it is

What a All in One SEO MCP server does.

All in One SEO does not keep its fields in post meta. Each post gets a row in its own aioseo_posts table, and on the paid AIOSEO each category and tag gets one in aioseo_terms. An AIOSEO MCP server therefore cannot reuse a post meta snapshot: it has to save and restore the table row itself.

WP MCP does that through one code path for both the write and the undo. It also follows AIOSEO's robots rule: per-post noindex and nofollow count while the row overrides the global defaults, so setting either flag switches that override on, and a flag stored under the defaults reads back as false because AIOSEO is not applying it.

Read and change

What WP MCP can read and change in All in One SEO.

It can read

  • AIOSEO title, description and focus keyword for a post
  • The canonical URL and the noindex and nofollow flags AIOSEO is really applying
  • Pro: Open Graph and Twitter fields on the post
  • Which SEO plugin is active, reported as aioseo with its version

It can change

  • Write titles and descriptions into the aioseo_posts row
  • Set the focus keyword, with the legacy keyphrases data kept in step
  • Set canonicals, and noindex or nofollow with the per-post override
  • Pro: set an Open Graph or Twitter image from the Media Library
  • Pro, with the paid AIOSEO: SEO fields on categories and tags
get-seo-statusget-seo-metaupdate-seo-metaset-social-imagerollback-operationrollback-session

These are the real ability and operation names the agent calls. TheAll in One SEO AI agent tool reference page lists the calls in detail.

Example prompts

Three things to ask first.

Rewrite the All in One SEO descriptions on every product page under 155 characters.

Set the focus keyword on the Cold Brew page to cold brew coffee.

Give the launch post its own Twitter image from media item 120.

Safety

Every All in One SEO write has a way back.

Every write snapshots the post's aioseo_posts row, or the term's aioseo_terms row, as one image. rollback-operation writes that image back and clears AIOSEO's query cache, so the old values show in its screens at once, and rollback-session reverses a whole bulk run the same way.

Snapshot before every write

No tool that writes can skip it. The before-state is saved first, the change is applied second.

One-click undo

Restore a single change with rollback-operation or a whole agent run with rollback-session, from the agent or from wp-admin.

Row-level snapshots

AIOSEO's data lives in its own table, so the snapshot is the table row itself. Columns an older AIOSEO lacks are left out of the write instead of failing it.

Free or Pro

Free, with more on Pro.

Post-level All in One SEO support is in the free plugin download: title, description, focus keyword, canonical and the two robots flags, plus get-seo-status and the full undo engine. WP MCP Pro adds the Open Graph and Twitter fields with set-social-image, category and tag SEO, and unlimited snapshot history with an active licence, where the free plugin keeps the last 20. The WordPress.org directory build of WP MCP leaves All in One SEO out.

WP MCP Pro starts at $49 a year for one site. See pricing for what each tier includes.

How to connect

Connect AIOSEO MCP in four steps.

  1. 01
    Install WP MCP

    Upload the free wpmcp plugin and activate it. It needs WordPress 6.9 or newer and PHP 8.1 or newer, and it runs entirely on your own server.

  2. 02
    Check the requirement

    All in One SEO active. Social fields need WP MCP Pro; category and tag SEO needs WP MCP Pro and the paid AIOSEO, which creates the aioseo_terms table.

  3. 03
    Connect your client

    Add the site to Claude Code, Claude Desktop, Cursor or any MCP client with a WordPress application password, or the WP-CLI stdio bridge locally. OAuth 2.1 with full or read-only access is there too, once the site owner switches it on.

  4. 04
    Ask for the change

    Describe what you want done in All in One SEO. WP MCP snapshots the target, makes the change, and leaves a Restore button next to it in wp-admin.

Step-by-step guides: Claude,Claude Code andCursor. The docscover the safety model in full.

Frequently asked

AIOSEO MCP: questions, answered.

What is AIOSEO MCP?

It is All in One SEO's per-post data made readable and writable by AI agents over the Model Context Protocol. WP MCP lets Claude, Cursor or any MCP client edit AIOSEO titles, descriptions, focus keywords, canonicals and robots flags, and with Pro, social images.

Is AIOSEO MCP free?

The post tools are: get-seo-status, get-seo-meta, update-seo-meta and the undo engine work with All in One SEO in the free plugin download. Social images, category and tag SEO and unlimited snapshot history are WP MCP Pro, as they are for every SEO plugin. The WordPress.org directory build leaves All in One SEO out.

Why does a page with a stored noindex read as indexable?

AIOSEO applies a per-post robots flag while that post overrides the global robots defaults. If the override is off, the stored flag has no effect, so the tool reports false to match what AIOSEO serves.

Does clearing noindex switch the robots override off again?

No. Other robots settings on the row may depend on the override, so it is left on. Roll the write back to return the row exactly as it was.

What happens to a Twitter card that mirrors Open Graph?

When a Twitter-specific image is set on a card that was mirroring Open Graph, the mirror is switched off and the inherited title and description are written as Twitter values, so the card keeps its text.

Does AIOSEO MCP work with Claude, Claude Code and Cursor?

Yes. Claude Code and Cursor connect to WP MCP over HTTP with a WordPress application password, and Claude Desktop uses the desktop bundle from the WP MCP Connection screen. Clients that can only sign in with OAuth, such as the claude.ai custom connector, need OAuth switched on first with one line in wp-config.php, because it ships off. Once connected, the All in One SEO tools are available in every client the same way.

Point your AI agent at All in One SEO.