Get the plugin
WP MCP/Integrations/SEOPress MCP

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

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
get-seo-statusget-seo-metaupdate-seo-metaset-social-imageupdate-term-seo-metarollback-session

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.

  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

    SEOPress active. The free SEOPress plugin is enough.

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

Point your AI agent at SEOPress.