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
› Rewrite the thin meta descriptions across the Knowledge Base
get-seo-meta 42 posts read
⛨ one per post, one session
update-seo-meta Rank Math fields written, 42 posts
✓ 42 descriptions rewritten. rollback-session undoes all of them.
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
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.
- 01Install 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.
- 02Check the requirement
Rank Math active.
- 03Connect 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.
- 04Ask 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.
Keep exploring
MCP for Rank Math →
Bulk-edit Rank Math metadata across the site from a prompt, reversible by session.
Yoast SEO MCP →
A Yoast SEO MCP server lets an AI agent read and write the fields in the Yoast box under every post, without anyone opening those posts one by one.
ACF MCP →
An ACF MCP server lets an AI agent understand your content model and work with it: see which fields a post type has, fill them in, or add a new field group.
Contact Form 7 MCP →
A Contact Form 7 MCP server lets an AI agent answer the questions you normally click around for: which forms exist, who each one emails, what came in this week.
WooCommerce Subscriptions MCP →
A WooCommerce Subscriptions MCP server lets an AI agent handle the routine subscription requests: put one on hold, move a renewal date, change an item, cancel at term end.
Browse all integrations, comparefree and Pro, read the docs, or see how the WordPress MCP server works.