SEOPress MCP · Free and Pro
SEOPress MCP: hand your SEOPress fields to an AI agent.
A SEOPress MCP server lets an AI agent fill in the SEOPress box on posts it has never opened. WP MCP detects SEOPress from the free plugin, writes the same meta keys SEOPress saves, and keeps a snapshot of every post it touches.
Self-hosted · snapshot before every write · one-click undo
› Noindex the five thin tag-roundup posts, leave nofollow alone
get-seo-meta 5 posts read, noindex false on all
⛨ one per post, one session
update-seo-meta yes written to _seopress_robots_index, 5 posts
✓ 5 posts noindexed. rollback-session reverses all five.
What it is
What a SEOPress MCP server does.
SEOPress stores each field under its own post meta key: _seopress_titles_title for the title, _seopress_titles_desc for the description, _seopress_analysis_target_kw for the target keyword. Its robots flags are not booleans but the string yes or an empty value. A SEOPress MCP server has to speak that format exactly, or SEOPress reads back something other than what the agent meant.
WP MCP handles the translation. The agent asks for noindex:true and WP MCP writes yes into _seopress_robots_index, and on a read it turns those strings back into plain true or false. With Pro, a social image write also keeps the attachment id and the stored width and height in step, so SEOPress's Open Graph tags do not describe the old picture.
Read and change
What WP MCP can read and change in SEOPress.
It can read
- SEOPress title, meta description and target keyword for a post
- The canonical URL and the noindex and nofollow flags, as true or false
- Pro: Open Graph and Twitter fields, and whether Twitter falls back to Open Graph
- Which SEO plugin is active, with its name and version
It can change
- Write titles and meta descriptions into SEOPress's own keys
- Replace the target keyword string on a post
- Set canonicals and switch noindex or nofollow on or off
- Pro: set an Open Graph or Twitter image from the Media Library
- Pro: set title, description and robots on categories and tags
These are the real ability and operation names the agent calls. TheSEOPress AI agent tool reference page lists the calls in detail.
Example prompts
Three things to ask first.
Which SEO plugin is active, and what does SEOPress have set on the Pricing page?
Set a target keyword on every Services page from this list, one per page.
Use media item 88 as the Open Graph image on the launch post.
Safety
Every SEOPress write has a way back.
SEOPress values are ordinary post meta, so the post snapshot holds every SEOPress key before update-seo-meta writes. A bulk run shares one session id, so rollback-session reverses all of it and rollback-operation restores a single post. Pro social and term writes are snapshotted the same way, so an image returns together with its id and dimensions.
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.
SEOPress's own format
Robots flags are written as the yes string SEOPress expects and the target keyword goes to _seopress_analysis_target_kw, so the SEOPress box shows exactly what the agent set.
Free or Pro
Free, with more on Pro.
Post-level SEOPress support is in the free plugin: title, description, target keyword, canonical and the two robots flags, plus get-seo-status and the full undo engine. The free SEOPress plugin is enough, SEOPress Pro is not required. WP MCP Pro adds category and tag SEO, the Open Graph and Twitter fields with set-social-image, and unlimited snapshot history with an active licence, where the free plugin keeps the last 20.
WP MCP Pro starts at $49 a year for one site. See pricing for what each tier includes.
How to connect
Connect SEOPress 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
SEOPress active. The free SEOPress plugin is enough.
- 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 SEOPress. 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
SEOPress MCP: questions, answered.
What is SEOPress MCP?
It is SEOPress's per-post SEO fields made readable and writable by AI agents over the Model Context Protocol. WP MCP lets Claude, Cursor or any MCP client read and write titles, descriptions, target keywords, canonicals and robots flags in SEOPress's own meta keys.
Is SEOPress MCP free?
The post tools are: get-seo-status, get-seo-meta, update-seo-meta and the undo engine are in the free plugin. Category and tag SEO, social images and unlimited snapshot history are WP MCP Pro.
Does a target keyword write add to the existing ones?
No, it replaces them. SEOPress keeps its target keywords as one string, so send every keyword you want on the post in the same write.
Can it set a focus keyword on a category?
No. SEOPress has no per-term target keyword. A term write with one is not refused: the keyword is reported back as skipped and the title and description are still written.
Does it touch SEOPress redirections or schema settings?
No. Redirections, local business data and SEOPress's schema settings are not exposed. The tools stay on per-post and per-term metadata and social fields.
Does SEOPress 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 SEOPress tools are available in every client the same way.
Keep exploring
MCP for SEOPress →
Bulk-edit SEOPress metadata across the site from a prompt, through SEOPress's own fields, every change reversible.
Bulk-edit SEOPress metadata with your AI agent →
Have Claude or Cursor rewrite titles, descriptions, canonicals, and robots flags across your site through SEOPress, every change snapshotted and one click from undone.
AIOSEO MCP →
An AIOSEO MCP server lets an AI agent work on All in One SEO without anyone opening the AIOSEO panel on each post.
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.
Rank Math MCP →
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 Rocket MCP →
A WP Rocket MCP server lets an AI agent clear the cache after a change and adjust how WP Rocket optimises the site, without a trip to its settings tabs.
Browse all integrations, comparefree and Pro, read the docs, or see how the WordPress MCP server works.