SEO integration
SEOPress AI agent tool reference
WP MCP writes SEO metadata through SEOPress's own postmeta fields, using one unified field set shared with Yoast and Rank Math. An AI agent can read and write meta titles and descriptions, focus keywords, canonicals, and noindex / nofollow flags across hundreds of posts. Each write is snapshotted before it lands, so a bulk metadata pass that goes wrong is one click from restored, and nothing changes in your SEOPress setup except who is doing the typing.
SEOPress in plain language: SEOPress MCP.
In practice
How SEOPress work goes with an agent.
SEOPress writes one post meta key per field, such as _seopress_titles_title and _seopress_titles_desc, and stores its robots flags as the string yes or an empty value. Its focus keyword lives in _seopress_analysis_target_kw. WP MCP maps its neutral field set onto those keys, turning the yes strings into booleans on read and back on write. For social images it also keeps the attachment id and the stored image width and height in step, so SEOPress's own media picker and Open Graph tags do not show the old picture's details.
Which SEO plugin is active here, and what does post 301 have set?
Runs get-seo-status, which returns the slug seopress with name and version, then get-seo-meta. Both are reads, and the per-post check refuses other authors' drafts and protected posts for callers who could not edit them.
Noindex posts 301 to 305 but leave nofollow as it is.
Runs update-seo-meta once per post with noindex:true under one session_id. Each writes yes into the noindex key only, after a post snapshot. A single rollback-session undoes all five.
Use media item 88 as the Open Graph image on post 301.
With Pro, runs set-social-image with target og. It writes the image URL, the attachment id, and the image's width and height, snapshotted. Without an attachment id, the old dimensions are deleted rather than left behind.
Set the title and description for the News category, and a focus keyword too.
With Pro, runs update-term-seo-meta. Title and description are written to the term's meta and snapshotted, but SEOPress has no per-term focus keyword, so it is reported back in skipped_fields instead of failing the write.
What your AI can do
Real SEOPress operations, every write reversible.
- Read and write SEOPress meta title, description, and focus keyword
- Set canonical URLs and noindex / nofollow flags
- Run site-wide bulk metadata edits safely
- Restore a single post or a whole bulk session
Example prompts
Example SEOPress prompts.
Rewrite the meta descriptions across the blog, keep them under 155 characters.
Set noindex on the thin tag-archive posts.
Roll back the last SEO session, the canonicals went wrong.
Under the hood
The SEOPress calls, under the hood.
update-seo-meta({ post_id: 90, title: "…", description: "…" }), writes SEOPress fields; snapshotted
rollback-session({ session_id }), one-click undo for the run
Safety and access
What can be undone on SEOPress, and what costs what.
Recoverable on SEOPress
- update-seo-meta takes a post snapshot, including every SEOPress meta key, before it writes.
- rollback-operation restores one post exactly, and rollback-session reverses a bulk run.
- set-social-image and the term writes (Pro) are snapshotted too, so the image, its id and its dimensions return together.
SEOPress limits and opt-ins
- A noindex or nofollow of false is stored as an empty value, which SEOPress treats as not set.
- SEOPress's redirections, local business data and schema settings are not exposed.
- Term SEO, social fields and the schema and meta-tag proposals are Pro.
Free or Pro: Reading and writing a post's title, description, focus keyword, canonical and robots flags is free, along with get-seo-status and the undo engine. Detection works from the free SEOPress plugin, so SEOPress Pro is not required. WP MCP Pro adds term SEO, Open Graph and Twitter fields with set-social-image, and the read-only generate-schema-markup and generate-meta-tags proposals. update-seo-meta has no opt-in filter.
In the free plugin
The SEOPress integration is in the free plugin.
The core SEOPress tools ship in the free, GPL plugin with the full snapshot and undo engine, and no trial clock. Pro adds 133 more tools, including Elementor deep editing, the other page builders, the forms adapter pack and, for some integrations, extra operations. The pricing page lists what each tier includes.
Frequently asked
SEOPress MCP: questions, answered.
Yoast, Rank Math, or SEOPress, does WP MCP care which I use?
No. The same get-seo-meta / update-seo-meta tools translate to whichever SEO plugin is active, using its own fields. Yoast, Rank Math, SEOPress, The SEO Framework, SureRank, Slim SEO and All in One SEO are supported on the free tier for post metadata.
With SEOPress, is bulk SEO editing safe?
Every metadata write is snapshotted and grouped into a session, so an over-broad change is reversible in one click.
Do I need SEOPress Pro for this to work?
No. SEOPress is detected from constants and functions the free plugin defines, and the post fields written are ones the free plugin uses. Features that exist only in SEOPress Pro are outside this integration.
Where does the focus keyword go?
Into _seopress_analysis_target_kw, as one string, which is where SEOPress keeps its target keywords. A write replaces the value, so send every keyword you want kept. Terms have no focus keyword in SEOPress at all.
Does the Twitter card follow Open Graph?
get-social-meta reads SEOPress's global "use Open Graph if no Twitter Cards" setting, so it can tell an agent whether the Twitter fields are real overrides or inherited. Changing that global setting is not something these tools do.
What is returned if an update changes nothing?
The write still completes and returns the stored fields with an operation_id, since the snapshot is taken before the change. Reading with get-seo-meta first lets an agent skip posts that already have the wanted value.
Is there an AI agent for SEOPress?
Yes, through WP MCP rather than SEOPress itself. An agent you choose, such as Claude or Cursor, can read and write SEOPress meta title, description, and focus keyword. WP MCP is a separate plugin, not a built-in AI feature of SEOPress. On the undo side: update-seo-meta takes a post snapshot, including every SEOPress meta key, before it writes.
Related integrations
More integrations for the same agent.
MCP for Yoast SEO
FreeSEO, 3 tools.
MCP for Rank Math
FreeSEO, 3 tools.
MCP for The SEO Framework
FreeSEO, 3 tools.
MCP for Redirection
FreeSEO, 2 tools.
MCP for DataForSEO
ProSEO, 2 tools.
MCP for SureRank
FreeSEO, 3 tools.
Browse the full Integrations hub, or read more on SEOPress MCP, MCP for SEO and the WordPress MCP plugin.