Get the plugin
WP MCP/Integrations/Rank Math MCP

Rank Math MCP · Free

Rank Math MCP: let an AI agent work through your SEO metadata.

A Rank Math MCP server lets an AI agent read and write the SEO fields Rank Math manages, across as many posts as you point it at. WP MCP writes Rank Math's own fields and groups a bulk run into a session, so one click takes the whole run back.

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

What it is

What a Rank Math MCP server does.

SEO metadata is the textbook job for an agent: hundreds of posts, each needing a title, a description and a focus keyword that someone has to type. A Rank Math MCP server lets the agent read what is there, propose better values, and write them into the fields Rank Math already reads.

WP MCP uses one unified field set and translates it to whichever SEO plugin is active. On a Rank Math site the values land in Rank Math's own meta, so nothing changes in your setup except who does the typing.

SEO cleanups are bulk by nature: a description missing on two hundred posts, a noindex that went too wide, a focus keyword to set per service page. The risk is the run, not any single post. WP MCP groups every write in one agent run under a session id, so a pass that goes wrong at post two hundred is undone with one rollback-session, while a single post can still be restored on its own, leaving the rest of the run in place.

Read and change

What WP MCP can read and change in Rank Math.

It can read

  • Rank Math title, description and focus keyword for a post
  • Canonical URL and robots flags
  • Which SEO plugin is active, and its status

It can change

  • Rewrite meta titles and descriptions
  • Set focus keywords
  • Fix canonical URLs
  • Set or clear noindex and nofollow
get-seo-metaupdate-seo-metaget-seo-statusrollback-session

These are the real ability and operation names the agent calls. TheRank Math AI agent tool reference page lists the calls in detail.

Example prompts

Three things to ask first.

Find posts with no Rank Math description and draft one for each, under 155 characters.

Set the focus keyword on each Services page from this list.

The noindex went too wide. Roll back the last SEO session.

Find posts with no Rank Math description and draft one for each, under 155 characters.

get-seo-meta reads the posts; update-seo-meta writes the Rank Math fields, one snapshot per post, all in one session.

Set the focus keyword on each Services page from this list.

Each page gets its keyword through update-seo-meta and a before-image of the old value.

The noindex went too wide. Roll back the last SEO session.

rollback-session restores every post that run touched. rollback-operation restores just one.

Safety

Every Rank Math write has a way back.

Rank Math stores its values as post meta, which the post snapshot captures before each write. Every write in a run shares a session id, so a bulk pass that goes wrong on post two hundred is restored with one rollback-session, and a single post can be restored on its own.

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.

Bulk runs roll back as one

Writes made in one agent run are grouped into a session. Undo the whole run in one click, or restore a single post and keep the rest.

Free or Pro

Free.

Rank Math support is in the free plugin: reading and writing post SEO metadata, with the full snapshot and rollback engine. WP MCP Pro adds unlimited snapshot history, which matters for very large bulk runs, and SEO metadata for taxonomy terms.

The free plugin is GPL and has no trial clock. See pricing for what each tier includes.

How to connect

Connect Rank Math 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

    Rank Math active.

  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 Rank Math. 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

Rank Math MCP: questions, answered.

What is Rank Math MCP?

It is Rank Math's SEO metadata made readable and writable by AI agents over the Model Context Protocol. WP MCP lets Claude, Cursor or any MCP client bulk-edit titles, descriptions, focus keywords, canonicals and robots flags.

Is RankMath MCP free?

Yes. The SEO metadata tools and the undo engine are in the free WP MCP plugin.

Does it change my Rank Math settings?

No. It writes the per-post fields Rank Math already uses. Your Rank Math configuration is left alone.

Is bulk SEO editing with AI safe?

Every metadata write is snapshotted and grouped by session, so an over-broad change is reversed in one click. The free plugin keeps the most recent run whole in its history.

What if I switch from Rank Math to another SEO plugin?

The same tools translate to whichever supported SEO plugin is active, including Yoast SEO, SEOPress, The SEO Framework, SureRank and Slim SEO.

Is SEO metadata for taxonomy terms included?

That is part of WP MCP Pro, along with unlimited snapshot history for very large bulk runs. Post SEO metadata is in the free plugin.

Does it check which SEO plugin is active?

Yes. get-seo-status reports which SEO plugin is active and its status, so the agent writes the right fields.

Does Rank Math 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 Rank Math tools are available in every client the same way.

Point your AI agent at Rank Math.