Rank Math
These abilities register when Rank Math is detected on the site and a Pro licence is active. If either is missing the module stays absent rather than failing at call time.
At a glance
Rank Math registers 8 abilities: 5 that only read, 2 that write, and 1 marked destructive. That split is the practical answer to how much of this module can run unattended. Reads cost nothing and are safe to repeat, so discovery is the part to be generous with; the writes are where review belongs, and the destructive calls stop for an explicit confirmation every single time regardless of which profile is active.
What this module is for
Read and update Rank Math post SEO, term SEO, post schema, and relevant settings from a controlled WordPress MCP connection.
Before you rely on it: Do not mass-generate metadata without page-level review, search intent, and indexation checks.
Typical workflows
- Compare on-page content with current metadata
- Inspect schema before editing structured data
- Review term SEO across an important taxonomy
The Rank Math integration page covers the same module from the workflow side, with the capability map and the questions worth asking before a first write.
Availability on your site
The Rank Math module needs three things at once: WPPilot Free as the MCP foundation, an active Pro licence, and the companion plugin detected on the site. Miss any one and the module does not register, which is deliberate: an ability that appears in the tool list but fails at call time is worse than an ability that was never offered. What the connected agent can actually call is then narrowed twice more: by the safety profile active on the site, and by the WordPress capabilities of the user behind the credential. A read that succeeds for an administrator can be absent entirely for an editor.
Every write these abilities perform is recorded in the change ledger, and destructive calls can be routed through the approval queue so a person signs off before anything is applied. A successful tool result means the operation returned, not that the front end, the cache, and every dependent template are correct: that still needs a look.
Reads
Available in every safety profile, including Read Only. Inspection costs nothing and is not rate limited.
| Ability | What it does |
|---|---|
wppilot/rank-math-check-setupCheck Rank Math Setup | Reports the Rank Math SEO environment: whether Rank Math is active, its version, which modules are enabled (e.g. rich-snippet/schema, redirections, sitemap, local-seo), and the public post types and taxonomies whose SEO can be managed. Module-gated abilities (like the schema abilities, which need the rich-snippet module) check this. Call this first before any other Rank Math ability. |
wppilot/rank-math-get-post-schemaGet Post Schema (Rank Math) | Reads the Rank Math schema (rich snippet) for a post: any per-post schema entries (with their @type and whether each is primary) and the default_type the post inherits from its post-type setting when it has no per-post schema. Requires the Rank Math rich-snippet (Schema) module. Identify the post by post_id (alias: id). |
wppilot/rank-math-get-post-seoGet Post SEO (Rank Math) | Reads the Rank Math SEO metadata for a single post or page in one friendly shape: focus_keywords (list), seo_title, meta_description, canonical, pillar_content (cornerstone), robots (index: default|index|noindex, follow: follow|nofollow, advanced: list of noarchive/noimageindex/nosnippet), facebook and twitter social previews, primary_category, and schema_type. Rank Math stores robots as a token array where index/noindex are mutually exclusive and "default" means inherit the post-type setting — this ability maps it for you. Identify the post by post_id (alias: id). Set include_score to also return the computed read-only SEO score. Never-set fields come back empty / default. |
wppilot/rank-math-get-settingsGet Rank Math Settings | Reads a curated snapshot of the site-wide Rank Math settings. scope selects the block(s) (default "all"): "general" = title separator and the knowledge-graph identity (organization or person, name); "titles" = homepage title/description templates plus per-post-type and per-taxonomy title & description templates and the EFFECTIVE default robots (index/follow/advanced) for each, with a custom_robots flag (false = the type inherits the site-wide default, which is what robots then reflects; true = it has its own per-type override). Template strings use Rank Math variables like %title%, %sep%, %sitename%. To CHANGE a setting use wppilot/execute-php (read the shared rank-math-options-* option, merge, update_option) — this ability reveals the keys and current values. |
wppilot/rank-math-get-term-seoGet Term SEO (Rank Math) | Reads the Rank Math SEO metadata for a single taxonomy term (category, tag, or custom-taxonomy term) in one friendly shape: focus_keywords, seo_title, meta_description, canonical, robots (index: default|index|noindex, follow: follow|nofollow, advanced), and the facebook / twitter social previews. Identify the term by term_id and taxonomy. Rank Math stores term SEO as ordinary term meta, which this ability reads and maps for you. Never-set fields come back empty / default. |
Writes
Gated by the active profile and your WordPress capabilities. Rate limited to 120 per minute per credential.
| Ability | What it does |
|---|---|
wppilot/rank-math-edit-post-seoEdit Post SEO (Rank Math) | Updates the Rank Math SEO metadata for a single post or page. Send only the fields to change — it is a partial merge; nested blocks (robots, facebook, twitter) merge field-by-field. Fields: focus_keywords (list), seo_title, meta_description (may use Rank Math variables like %title% %sep% %sitename%), canonical, pillar_content (bool), robots {index: default|index|noindex, follow: follow|nofollow, advanced: list of noarchive/noimageindex/nosnippet}, facebook/twitter {title, description, image, image_id}, primary_category (category term id, or null to clear). The friendly robots labels are mapped to Rank Math's token array for you (so you never build a contradictory or empty robots set). Identify the post by post_id (alias: id). Returns the full updated SEO. Edit the schema type via the schema abilities. |
wppilot/rank-math-edit-term-seoEdit Term SEO (Rank Math) | Updates the Rank Math SEO metadata for a single taxonomy term (category, tag, or custom-taxonomy term). Send only the fields to change — it is a partial merge; the robots block merges field-by-field. Fields: focus_keywords (list), seo_title, meta_description, canonical, robots {index: default|index|noindex, follow: follow|nofollow, advanced: list of noarchive/noimageindex/nosnippet}, facebook/twitter {title, description, image, image_id}. Rank Math stores term SEO as ordinary term meta. Identify the term by term_id + taxonomy. Returns the full updated SEO. |
Destructive
Marked destructive in the source, so each call needs an explicit confirmation flag, every time.
| Ability | What it does |
|---|---|
wppilot/rank-math-edit-post-schemaEdit Post Schema (Rank Math) | Sets the Rank Math schema (rich snippet) type for a post. schema_type is the schema.org type (Article, BlogPosting, NewsArticle, Product, Course, Event, Recipe, Book, JobPosting, Service, SoftwareApplication, VideoObject, Person, Restaurant) or "off" to remove the per-post schema (the post then inherits the post-type default). This replaces the post's per-post schema with a single primary entry of the chosen type; Rank Math fills the rest of the properties from its template. Requires the rich-snippet module. Identify the post by post_id (alias: id). Returns the resulting schema state. |