Respira WordPress MCP

Get WooCommerce sales report for week/month/year/custom range.

Update a WooCommerce product category.

Update WooCommerce order status.

Update an existing WooCommerce product.

Update stock quantity or stock status for a product.

Update a WooCommerce product tag.

EXPERIMENTAL: Activate a plugin. Requires plugin management to be enabled in Respira settings. Monitor the site after activation.

Analyze content for AI Engine Optimization (optimizing for AI search engines like Perplexity, ChatGPT). Checks structured data, content clarity, semantic HTML, entities, content depth, and FAQ opportunities.

Analyze image optimization opportunities including missing alt text, large files, and unoptimized formats.

Analyze page performance metrics including load time, image optimization, CSS/JS optimization, caching, and plugin performance impact.

Analyze a page against Rank Math SEO scoring. Returns detailed checks, current score, and ready-to-apply meta_updates. To apply fixes: use respira_update_page with the seo_title, seo_description, and focus_keyword fields from the meta_updates response.

Analyze content readability including Flesch Reading Ease score, sentence length, and paragraph structure.

Comprehensive SEO analysis including meta tags, heading structure, image alt text, internal linking, content quality, and schema markup.

Auto-apply accessibility fixes for a scan. Fixes supported: image-alt, color-contrast, label, heading-order, document-title, html-lang-valid.

Insert a Bricks component/template into a page. Clones the component elements with new IDs and inserts them at the specified position. Creates a snapshot before writing.

Apply Respira v2 builder patch operations (identifier by id/path/type+match_content).

Assign a menu to a theme location.

Apply multiple element operations to a page in a single atomic transaction. Extracts content once, applies all operations, and injects once.

Create a complete page from a declarative structure. Accepts builder-specific widget definitions and creates the page with all elements in one call. Returns page_id, edit_url, and preview_url.

Apply an operation across up to 100 pages. Supports strip_inline_styles, find_and_replace, and custom operations. Each page gets a snapshot for rollback. Rate limited to 3/hr.

Check for common SEO issues and get quick recommendations.

Check schema markup and structured data (JSON-LD, microdata) for AI parsing.

Convert HTML into native page builder content. Extracts CSS styles, maps sections to builder widgets, and creates a page with a fidelity report showing conversion accuracy.

Create a new Bricks global CSS class. Settings use Bricks composite key format (e.g. "_padding", "_margin", "_typography"). Returns the created class with its generated ID.

Create a new comment.

Create a new custom post.

Create a new navigation menu.

Create a new menu item. Can link to pages, posts, custom URLs, or categories.

Create a duplicate of an existing page for safe editing. IMPORTANT: Always use this before making changes to an original page. After creating a duplicate, edit the duplicate using wordpress_update_page. The user must then approve the duplicate in WordPress admin (Respira → Page Approvals) to replace the original page.

Create a duplicate of an existing post for safe editing. IMPORTANT: Always use this before making changes to an original post. After creating a duplicate, edit the duplicate using wordpress_update_post. The user must then approve the duplicate in WordPress admin (Respira → Page Approvals) to replace the original post.

Create a new term.

Create a new user.

EXPERIMENTAL: Deactivate a plugin. Requires plugin management to be enabled in Respira settings.

Delete a Bricks global class by ID. Returns the deleted class data for rollback. Warning: elements referencing this class will lose its styling.

Delete a comment.

Delete a custom post.

Delete a media file.

Delete a navigation menu.

Delete a menu item.

Delete an option.

Delete a page. IMPORTANT: By default, this only works on Respira-created duplicates. The force parameter only works if "Allow Direct Editing" is enabled in Respira settings (disabled by default for safety).

EXPERIMENTAL: Permanently delete a plugin. Requires plugin management to be enabled in Respira settings. The plugin must be deactivated first.

Delete a post. IMPORTANT: By default, this only works on Respira-created duplicates. The force parameter only works if "Allow Direct Editing" is enabled in Respira settings (disabled by default for safety).

Delete a term.

Delete a user.

Diff two Respira v2 snapshots and return structured fidelity deltas.

Duplicate an element in a page. The copy is inserted immediately after the original.

Extract the full structured content from a page as builder-native JSON. Use this to see the complete page layout with all sections, columns, and widgets. For targeted searches, prefer find_element (faster). For a lightweight overview, prefer find_builder_targets. Returns the raw builder data structure that can be modified and passed back to inject_builder_content.

List all editable builder modules/blocks on a page with their types, labels, and text content — without returning the full builder JSON. Use this for a quick overview of what is on a page. For finding a specific element by text or class, use find_element instead.

Find an element in a page by ID, type, CSS class, or text content. This is the PRIMARY tool for locating content to edit — use it instead of searching the database or reading PHP files. Works with all 11 page builders. Use identifier_type "content" to search by visible text (e.g. find a heading containing "2025" to update a year). Returns matching element(s) with their position, settings, and element ID for use with update_element.

Get detailed results of a specific accessibility scan including all violations, scores, and AI fix prompts.

Return the currently active site in the Respira multi-site configuration.

Get the Bricks color palette. Returns array of palette groups, each with {id, name, colors: [{id, raw, name}]}. Colors use raw hex values or CSS variable references.

Get a Bricks component/template by ID. Returns the full element structure ({id, title, type, elements}) that can be inspected or applied to a page.

Get the Bricks theme styles configuration. Returns an object keyed by style ID, each containing label, settings (with element-type groups like "heading", "text-basic", "button"), and conditions.

Get Bricks global CSS variables and typography scales. Returns {variables: [{id, name, value, category}], categories: [{id, name, scale?}]}. Categories with a "scale" property are typography scales.

Detect which page builder is active on the site and get its version, support level (Full Intelligence / Smart Defaults / Basic), available modules/widgets, and capabilities. Call this first before working with builder content to understand what format to use.

Get comment details by ID.

Get Core Web Vitals metrics (LCP, FID, CLS) for a page.

Get custom post details.

Get single media item details.

Get a navigation menu with all its items. Includes WPML translation info if available.

Get a single menu item by ID.

Get option value by name.

Get post type details.

Check version compatibility between the MCP server and the WordPress plugin. Returns plugin version, supported version range, and available features.

Get WordPress site context. By default this returns a compact summary to reduce token use; set detail="full" only when you need the full plugin/theme inventory.

Get one Respira v2 snapshot by UUID.

Get taxonomy details.

Get term details.

Get theme documentation and available template files.

Get user details by ID.

REPLACE (or append to) the entire page builder layout. WARNING: By default this REPLACES all existing content — use mode:"append" to add content without destroying existing elements. For editing a single module, use wordpress_update_module instead. Use exactly: gutenberg, divi, elementor, bricks, beaver, oxygen, breakdance, brizy, thrive, visual-composer, wpbakery. For Divi, diviVersion is required ("4" or "5").

EXPERIMENTAL: Install a plugin from WordPress.org or a ZIP URL. Requires plugin management to be enabled in Respira settings. Use with caution.

List previous accessibility scans with scores and violation counts.

List all Bricks saved templates/components (reusable element groups). Returns array of {id, title, type, modified}. Components are stored as bricks_template custom post type.

List all Bricks global CSS classes with their settings (CSS properties). Returns array of {id, name, settings, category}. Use this to discover existing design tokens before creating new ones.

List all comments with optional filtering.

List posts of a custom post type.

List all media files (images, videos, etc.).

List all items in a menu with their hierarchy.

List all registered menu locations and their assigned menus.

List all navigation menus. Includes WPML translation info if available.

List WordPress options (with optional search filter).

List all pages with optional filtering.

EXPERIMENTAL: List all installed plugins with their status, version, and update availability. Requires plugin management to be enabled in Respira settings.

List all registered post types.

List all blog posts with optional filtering.

List every site available in the current Respira multi-site configuration and show which one is active.

List Respira v2 snapshots with optional filters.

List all registered taxonomies.

List terms in a taxonomy.

List all users with optional filtering by search term.

Move an element to a different container or position within the page.

Get full content of a specific page including meta data and builder information.

Get full content of a specific post.

Remove an element from a page.

Reorder child elements within a container.

Restore content and allowlisted meta from a Respira v2 snapshot UUID.

Run a WCAG accessibility scan on a page. Returns violations grouped by severity (critical, serious, moderate, minor) with auto-fix suggestions. Supports standards: wcag2a, wcag2aa, wcag21a, wcag21aa, wcag22aa, section508.

Search for free stock images via Openverse (Creative Commons). Returns image URLs, titles, authors, and licenses.

Download a stock image from an allowed domain and add it to the WordPress Media Library. Auto-generates CC attribution caption. Allowed domains: openverse.org, wordpress.org, unsplash.com, pexels.com, pixabay.com.

Switch to a different WordPress site in the active Respira multi-site configuration.

Update the Bricks color palette (full replace). Pass the complete palette array. Returns previous and current values for rollback.

Update an existing Bricks global class. Merges provided fields into the existing class — omitted fields are preserved. Returns previous and current state for rollback.

Update Bricks theme styles (full replace). Pass the complete styles object. Returns previous and current values for rollback. Affects site-wide typography, colors, and element defaults.

Update Bricks global CSS variables and typography. Pass variables array and optionally categories. Returns previous and current values for rollback.

Update a comment.

Update a custom post. When direct editing is enabled and you target an original item, Respira returns a confirmation_required preflight by default so you can choose live/original or duplicate.

Update settings or content on a specific element in a page. This is the PRIMARY tool for making content changes — use it for text edits, style changes, image swaps, link updates, etc. Works with all 11 page builders. First use find_element to locate the element, then pass the same identifier here with the updates object containing the new values.

Update media metadata (title, alt text, caption).

Batch update media items (alt text, title, caption). Up to 50 items per call. Useful for fixing missing alt text across multiple images.

Update a navigation menu.

Update a menu item.

Update a specific module within a page builder page. Supports finding modules by admin_label, path, or type. Only updates the specified module while preserving all other content.

Update an option value.

Update a page. When direct editing is enabled and you target an original page, Respira returns a confirmation_required preflight by default so you can choose live/original or duplicate.

EXPERIMENTAL: Update a plugin to the latest version. Requires plugin management to be enabled in Respira settings. Make sure you have backups before updating.

Update a post. When direct editing is enabled and you target an original post, Respira returns a confirmation_required preflight by default so you can choose live/original or duplicate.

Update a term.

Update user information.

Upload a media file (image, document, video) to WordPress. Supports base64 encoded files, file URLs, or file paths.

Validate content for security issues before saving.