Changelog and Release Notes

What's New in Respira CLI v0.1.0

The modern WordPress command line for developers working with AI coding agents.

Three npm packages

• @respira/cli: the oclif-based CLI with 29 commands across auth, sites, read, write, find-element, tools, docs, snapshots, exec, init-claude-code
• @respira/sdk: the typed TypeScript client with zod validation on every method
• @respira/cli-core: shared auth store (OS keychain with file fallback), output formatter, and API client with retry plus rate-limit handling

Anonymous mode

• respira read structure <url> works on any public WordPress site with no account
• respira read design-system <url> returns colors, fonts, and spacing from any public site

Builder-native

• Elementor, Divi (4 and 5), Bricks, WPBakery, Beaver Builder, Oxygen, Breakdance, Brizy, Thrive Architect, Flatsome UX Builder, native Gutenberg blocks, plus WooCommerce

Safety-first

• Every write creates a snapshot first
• --dry-run on every write command
• --diff on write edit-page and write edit-element emits before/after for agent review
• Destructive operations require --confirm

AI agent integrations

• respira init-claude-code sets up Claude Code in the current directory with a skill + shortcut commands
• JSON output when piped, so every agent framework can consume results

Installation

npm install -g @respira/cli
respira auth login
respira sites list

Documentation: /cli/introduction. Source: github.com/respira-press/respira-wordpress-cli.

Not a WP-CLI replacement. WP-CLI is excellent for server-side WordPress administration and the two tools are complementary.

What's New in v8.0.0 "Canopy"

Respira has always been strong on page builders and thin on the thing WordPress core is actually pushing people toward. 8.0 closes that. The coverage line is now 16 page builders plus the native Site Editor.

Measured on a live install: 197 tools on any WordPress site, 302 with the WooCommerce add-on (of which 105 are woocommerce_* tools), 269 WebMCP abilities, 37 skills.

The native WordPress Site Editor is a first-class target

• Block templates and template parts (wp_template, wp_template_part) with template hierarchy and source discovery, so you know whether a template is theme-provided, plugin-provided, or a database customisation
• Synced and unsynced patterns (wp_block). Registered theme and plugin patterns stay read-only. Editable user patterns support the synced/unsynced distinction
• Block navigation (wp_navigation) edited by exact block path, not by rewriting the navigation document. A guessed path is refused. A stale revision is refused
• Gutenberg design tokens and global styles

The safety contract for structural writes

• Every structural write is fingerprint-guarded against a stale base, snapshotted, read back through WordPress, and server-render verified. It returns verified only after WordPress actually rendered it
• Structural proposals: a write can be staged for human approval instead of applied
• The mutation-result contract is explicit: dry_run, pending_approval, verified, stored_unverified, no_match, or a failure with a reason
• An agent-facing activity history links audit entries to snapshots, proposals, approvals, and rollbacks

Structural writes are beta-gated

• Structural writes to site-level objects are beta-gated per site and OFF by default. Read-only discovery works everywhere. The gate stays until that write path has more live mileage

Two safety fixes found by auditing the safety layer itself

• A Divi 4 serializer rule written for brand-new pages was firing on every write path, retyping existing Code modules on pages it should only have passed through
• Undoing a Theme Builder create could trash a template the agent never created

Divi Theme Builder: a confirmation handshake, not an approval

• Divi Theme Builder global layouts are snapshotted and reversible but written live, not staged. They cannot be staged the way a page can, because Divi resolves a global layout by id and a duplicate would compete with the original
• The first attempt to rewrite a global header, footer, or body is now refused with respira_tb_live_edit_confirmation_required, naming the layout and saying it changes every page using it. Re-send with confirm_live_edit=true to proceed
• That is a confirmation, not an approval. A confirmed write goes live

Credit

• The FSE work was driven by a published field study from Dale Smith of revWorx, who builds exclusively on FSE block themes and documented, live-verified, that Respira's storefront tools went inert on that stack

Documentation: Site Editor (Full Site Editing).

What's New in the 7.5.x line

The 7.5.x line is about connecting more AI apps with less friction, and about the plugin telling the truth about itself so a connected app never offers something this install cannot do. The current latest build is v7.5.18.

ChatGPT connector, no key to paste

• Unauthenticated MCP discovery so ChatGPT (and other apps that probe before signing in) can find your site's connector, then complete a one-time browser sign-in. You add the site by URL, approve access once, and a site-scoped token is minted. This matches the browser sign-in path Claude and the other apps already used.

Server truth, so connected apps stop guessing

• The plugin now declares which capabilities this exact install actually exposes, computed from the REST routes registered on it. A connected app can read that and hide tools whose route is not present, which removes the "no route" failures that happen when the AI app is newer than the installed plugin.
• Connectivity and diagnostics improvements across the connect flow so a site that is reachable connects, and a site that is not says why.

i haven't written a per-patch breakdown of every 7.5.x build here yet. If you want the exact notes for a specific version, ask and i will point you at it.

What's New across 7.4.1 to 7.4.20

A long run of builder fixes after "Clearing", each one verified on the matching builder on a real install. The theme is the same as 7.4.0: what the agent writes is what lands, and when it cannot land, Respira says so instead of reporting a false success.

Elementor

• Elementor v4 atomic style writes now wire to the element, so an explicit styles block, digit-leading style ids, and global system colours (primary, secondary, text, accent) all render instead of being generated and then worn by nothing.

Bricks

• Full control-schema deconstruction: a scanner captures every Bricks element's real runtime control set into a committed snapshot, so the agent knows what each element actually accepts, and off-contract controls are flagged with a "did you mean" instead of being dropped silently.
• Bricks elements now mint the native 6-character ids the editor and front-end #brxe- selectors expect, Bricks Components survive a write with their cid and per-instance properties intact, and the SEO, schema, and readability checks now read Bricks content out of postmeta.

Oxygen 6

• Oxygen 6 now builds with its real native elements (OxygenElements\*), and picks up the rich EssentialElements\* Section, Heading, and Button blocks when the "Breakdance Elements for Oxygen" add-on is active, instead of collapsing a whole page into one HTML block. A legacy null that bricked the Oxygen 6 editor site-wide is coerced back to its empty shape on every save.

Divi 5

• Made-up layout names like hero_section no longer land as "Unknown Module" blocks: an unrecognised type is coerced to the nearest native divi/ block, nested correctly, with a loud warning to use real Divi types. Loose content shapes agents actually send now normalise into native, editable, rendering modules, and the Visual Builder opens with the correct content after a Respira write.

Beaver Builder

• Compound settings (border, typography, dimension, and friends) are coerced to the array shape Beaver reads, so a render, duplicate, or batch update no longer fatals with "Cannot use object of type stdClass as array".

Self-correcting errors, less token waste

• When a locate, update, or patch operation cannot find its target, the response now hands the agent the page's actual elements to pick from (each with its path, id, type, admin_label, and a short content excerpt), so the agent picks the right one on its next call instead of guessing.

This line also carried a critical site-down fix for Bedrock-style managed hosts (Kinsta and similar) on WordPress 6.9 and 7.0, where a bundled Abilities API polyfill could collide with the same class now shipping in core.

What's New in 7.4.0 "Clearing"

What the agent writes is what actually lands on the page. A deep pass through every supported builder, closing the gaps where a write reported success but the page stayed stale or blank.

Styling now lands

• Oxygen, Beaver Builder, Elementor v4 Atomic, Bricks, Divi 4 and Divi 5: style writes that previously saved to the database without changing the rendered page now render, each verified against the real front-end page.

Two builders moved from read to write

• Brizy: writes pages the Brizy editor opens and the front end renders. Front-end compile depends on Brizy's cloud compiler service, so the site needs internet.
• Visual Composer: writes in VC's canonical storage format. The editor loads the page, the front end renders, and VC recompiles on the next editor save.

Recovery goes deeper

• Custom CSS and page settings are now captured, and global objects are versioned: deleting a Bricks global class, a Divi preset, or an Elementor kit color leaves a recovery point.

Writes fail loudly, not silently

• When a value cannot be persisted in a shape the builder reads, Respira names exactly what did not land instead of reporting success, which cuts the retry loops that waste tokens.

12 builder legs verified end-to-end on real installs. Full notes: respira.press/releases/7.4.0.

What's New in 7.3.0

Reversibility extends past page edits to destructive structure operations and whole-session cascades.

• Cascade rollback (session-level recovery). Deleting an ACF field group, custom post type, or taxonomy, or changing an option, now captures a recovery snapshot first. A whole-session restore rolls back a multi-step destructive mess in one call, returning every object the session touched to its pre-session state. New MCP tools wordpress_begin_session / wordpress_end_session / wordpress_restore_session.
• The ACF structures the agent builds are editable and correctly typed.
• Images sideload into the media library by default.

Verified end to end on a local Bricks + Elementor + ACF environment.

What's New in 7.2.0

Connect AI apps to your site with a one-time browser sign-in, no API key and no file.

• Connect by browser sign-in (OAuth 2.0). Claude Desktop, claude.ai, Claude Code, ChatGPT (Developer Mode), Cursor, and Codex add your site as a custom connector by URL. The app discovers respira.press as the authorization server, you approve access once in the browser, and a site-scoped token is minted.
• Backward compatible: the existing API-key, connect-by-link, and .mcpb paths keep working exactly as before.

What's New in 7.1.0 "Roots"

The biggest release since launch: a rebuilt React admin around live telemetry, and the plugin ability ecosystem made safe to use.

• Four new builders, 16 total: Spectra, Kadence Blocks, GenerateBlocks, and SeedProd (audit-only).
• Playbooks: teach an agent a multi-step workflow once, then rerun it as one callable WordPress ability.
• Custom Structures: agents create custom post types, taxonomies, and ACF field groups.
• Redesigned admin: a React-first wp-admin with a bridge view of agent ↔ Respira ↔ site, driven by eleven new REST endpoints.
• Public add-on SDK so third-party plugin authors can register their own MCP abilities.
• generate_activity_report: turns your audit log into a client-ready report your own agent shapes into prose.

What's New in 7.0.0 "Bloom"

Every page-builder adapter promoted to deeper-intelligence parity, in lockstep.

• Five cross-cutting invariants every adapter now inherits: render-validation gate, universal write-trace, Variables CRUD shape, source-driven catalog auto-scan, and per-property typed validators.
• Per-builder slices close the family-bug arcs surfaced across the 6.10.x line.
• 1076 standalone test assertions across 27 alpha cycles, zero failures.

What's New in 6.11.0 "Self-Heal"

A bug-bash release. Closes 14 customer-reported bugs across 5 named trial threads and all 7 open public GitHub issues, plus 5 cross-cutting audits.

• New respira_diagnose_connection tool surfaces edge-layer interception, so REST returning homepage HTML instead of JSON stops being opaque.
• JSON post-meta unicode safety across every adapter, MCP tool-schema audit, duplicator kses bypass fix, and render-trace fields on every write.

What's New in 6.6.0 "ACF Intelligence"

54 Advanced Custom Fields tools covering field reads and writes, field-group management, ACF Pro repeaters, flexible content, galleries, options pages, relationships, and bulk updates.

• Every write snapshot-backed and dry-run previewable.
• Works on the roughly 2 million WordPress sites that use ACF today.

What's New in 6.2.0 + 6.3.0 "Deep Intelligence"

The deepest Oxygen and Breakdance MCP integrations available.

• Oxygen (6.2.0): 49 components, 140+ schema properties, a fuzzy-matching settings validator, a data-repair pipeline, Oxygen 6 detection, and 10 layout patterns.
• Breakdance (6.3.0): 84 elements across 7 categories, 120+ schema properties, nesting validation, fuzzy matching, content/design preservation, and 8 layout patterns.

What's New in 6.0.0 "Storefront"

Three coordinated releases. Twelve builders. Real commerce. One layer.

Flatsome UX Builder — Builder #12

• Full support for the most popular WooCommerce theme on ThemeForest (200K+ sales)
• 55 element definitions with attributes, nesting rules, and responsive patterns
• Shared ShortcodeParser utility for Divi 4 and Flatsome with strict tag allowlists
• Theme-based detection, mixed-builder site support, snapshots on every write

15 New WooCommerce Commerce Tools (36 total)

• Storefront design intelligence: analyze_shop_page, analyze_product_page, update_product_card_layout, add_low_stock_badge, add_sale_badge, update_checkout_layout
• Catalog operations: list_products_advanced, bulk_update_products, analyze_catalog_health, find_product_by_natural_language
• Pricing: bulk_update_prices (with dry-run), schedule_sale, revert_pricing
• Inventory: bulk_update_stock, find_low_stock
• All write tools create snapshots. 100-product hard cap on bulk operations.

Bundled WooCommerce Entitlement

• Studio and Founder plans now include the WooCommerce add-on at no extra cost
• Maker and Builder continue to purchase separately at €95/year

Context-Aware MCP Tool Filtering (MCP Server v6.0.0)

• Tools automatically filtered by detected builder and active plugins
• ~170 tools reduced to ~130 on typical sites
• Fail-open: full list returned if detection fails
• Cached with 1-minute TTL, invalidated on site switch

Bug Fixes

• Metrics undercounting: missing direct_edit_page, direct_edit_post, create_custom_post, update_custom_post, force_edit_custom_post actions
• Founder plan capacity: shows Unlimited instead of 999
• TagDiv/Newspaper detection: routes to WPBakery (TagDiv) instead of Gutenberg
• WooCommerce snapshot gap: all existing write tools now create before/after snapshots

Download: v6.0.0 on GitHub | WooCommerce Add-on v2.0.0 | Release notes

What's New in 5.5.3

Divi 5 Fixes

• inject_builder_content, update_element, batch_update, move_element — all Divi 5 mutations now correctly update the visual builder. The root cause: Divi's convert_divi_blocks_before_save filter was stripping block content from revisions created via wp_save_post_revision(). Revisions are now written directly to the database, bypassing Divi's filter.
• Trial badge no longer stuck after license upgrade — transient cache cleared on validation.

Divi 5 Simplified Settings Schema

• All divi/* modules now accept a settings object with 30+ shorthand keys for content and styling.
• Content: title, content, body, button_text, button_url, src, alt, url, author, job_title, number, etc.
• Styling: background_color, text_color, font_family, font_size, font_weight, text_alignment, padding, margin, heading_color, heading_font, heading_font_size, header_level/tag, button_color, button_bg_color, button_border_color, column_structure.
• New divi/person module definition.

See Divi 5 Simplified Settings for the full reference with examples.

Download: v5.5.3 on GitHub

What's New in 5.2.0 "Elemental"

The biggest upgrade to Respira's page builder intelligence. 39 new tools. 125 total.

Element-Level Editing (7 tools)

• find_element, update_element, move_element, duplicate_element, remove_element, batch_update, reorder_elements — target individual widgets without downloading the entire page.

Page Building

• build_page — create a complete page from a declarative structure in one API call. Returns preview URL.
• 27 widget shortcuts: add_heading, add_button, add_image, add_text, add_video, and 22 more.

HTML-to-Builder Conversion

• convert_html_to_builder — converts HTML/CSS prototypes into native builder content with CSS extraction, section mapping, style translation, and fidelity scoring.

Bulk Operations

• bulk_pages_operation — apply changes across up to 100 pages. Built-in ops: strip_inline_styles, find_and_replace, custom. Rate-limited with mandatory snapshots.

Stock Images

• search_stock_images and sideload_image — search Openverse, sideload with CC attribution, SSRF-protected.

Tool Governance

• Admin UI to disable/enable any MCP tool per-site. Single enforcement chokepoint for REST, Abilities API, and MCP.

API Key Access Profiles

• Generate keys with scoped permissions: Full Access, Read Only, Content Editor, or Builder. Two-layer security with governance.

Builder Intelligence

• Elementor dynamic schemas — runtime widget schema generation with "did you mean?" validation.
• Divi 5 intelligence — 40+ modules, 7 page patterns, design tokens, 13-point validation.
• Beaver Builder HTML conversion pipeline.
• Bricks CSS regeneration on inject and approval merge.
• Oxygen ct_template detection fix (checks both meta keys).

Infrastructure

• Version migration engine for safe upgrades from any previous version.
• Dual tool naming: respira_* (preferred) alongside deprecated wordpress_*.
• Version negotiation endpoint + plugin version header.
• UTF-8 passthrough for multibyte characters.
• Frontend cache purge for 9 cache plugins.
• RankMath SEO analysis tool.
• Direct edit mode — writes go straight to original when enabled.
• Top API Keys dashboard table for usage visibility.

Fixes: Oxygen ct_template detection, SQLite/Playground compatibility, trial-to-paid license orphans, duplicate admin banners, direct edit mode, trial emails for paid users, Gemini MCP schema compliance, Bricks approval merge cache.

Recommended Versions

• Respira for WordPress plugin: 5.2.0+
• MCP server: 5.2.0+

What's New

• Fixed character-based length counting for SEO meta title/description (was byte-based — Cyrillic showed ~1.75x actual length).
• Fixed Unicode-aware word tokenizer for non-ASCII scripts in word count and keyword density.
• Fixed Open Graph detection for RankMath, AIOSEO, and SEOPress (was only detecting Yoast).
• Fixed schema detection for RankMath and AIOSEO sites.

What's New

• Fixed include: "meta" now resolves to meta.allowlisted as expected.
• Fixed Divi Theme Builder meta writes reflected in before/after hashes.
• Added 10 Divi Theme Builder meta keys to the default allowlist.

What's New

• Added Bricks browser_events map for WebMCP DOM event awareness.
• Added Bricks duplicate filter gate for ID-dedup sync.
• Fixed Bricks 2.2 "inject succeeds but frontend shows no change" — CSS regeneration now fires on every inject.
• Fixed wrong Bricks meta key in AI context (missing _2 suffix).

What's New

• Added agency-first MCP setup from dashboard: account-wide multi-site export now includes stacked Starter + Agency inventory.
• Added guided MCP setup paths in dashboard: file downloads, one-time install command, and AI setup prompt.
• Added stronger setup security guidance for config/token handling and token rotation.
• Added safer write routing for original content: explicit confirmation flow for live vs duplicate targets when direct editing is enabled.
• Improved MCP token efficiency defaults with compact responses and better patch/discovery flows.

Recommended Versions

• Respira for WordPress plugin: 4.2.0+
• MCP server: 4.0.0+

What's New

• Clarified how Respira fits into the official WordPress Abilities API and MCP Adapter stack.
• Documented the four supported surfaces: standalone MCP server, default/public adapter server, dedicated Respira adapter server, and browser surfaces.
• Added dedicated docs for WordPress AI Stack Compatibility and Elementor Angie.
• Updated browser and desktop setup docs so the official adapter is presented as a compatible path rather than a separate product story.

Latest stable plugin version

Download: respira-for-wordpress-4.0.7.zip

What's New

• Fixed Elementor URL-control validation crashes by handling link-field array payloads before URL sanitization.
• Hardened fallback Elementor save path to clear _elementor_element_cache when direct _elementor_data writes are used.
• Added regression coverage for Elementor root-only wrapping and fallback save behavior.
• Added normalized X-Respira-Agent-* telemetry capture across plugin and MCP flows for clearer client attribution in logs/stats.

Recommended For

• All Elementor users, especially if you saw intermittent 500s during module updates.

Download

respira-for-wordpress-4.0.7.zip

What's New

• Strengthened Elementor payload normalization to prevent nested/double-serialized _elementor_data saves.
• Added type coercion guards to stop array payloads from reaching scalar sanitizers (ltrim()-style crashes).
• Added WooCommerce taxonomy CRUD parity for categories/tags and product assignment support.
• Updated Browser AI/WebMCP inventory contracts to current tool registry totals.

What's New

• Major wp-admin IA/UX refresh in 4.0.0 (Overview, Setup, Approvals, Reports, Add-ons, Logs, Settings).
• 4.0.1-4.0.3 shipped Elementor write-flow hardening and structured diagnostics for MCP clients.
• 4.0.2 centralized editing controls under Respira → Settings, with Setup → Health & Permissions as a focused read-only summary.
• 3.3.1 updated official WordPress MCP Adapter compatibility (mcp_adapter_init + legacy fallback).

What's New

• Added Divi 5 documentation and Migration Copilot toolkit docs.

Latest stable version

Download: respira-for-wordpress-1.9.1.zip

What's New

• Custom post updates (meta + CSS) - Update custom post types with meta and customCss
• Builder-aware Custom CSS - Detects Divi/Elementor and saves CSS to the right place
• Elementor CSS regeneration - Automatically clears/regenerates Elementor CSS cache after updates

Features

• Safe editing with automatic page duplication
• No SSH required, works with any WordPress hosting
• Built-in security validation for XSS and SQL injection
• Support for 12 page builders: Gutenberg, Divi, Elementor, WPBakery, Oxygen, Bricks, Beaver Builder, Brizy, Visual Composer, Thrive Architect, Breakdance
• Full menu management with hierarchy
• Taxonomy management (categories, tags, custom)
• User and comment management
• SEO, AEO, and performance analysis
• Core Web Vitals monitoring
• WPML multilingual support
• Complete audit logging

Download

respira-for-wordpress-1.8.41.zip

Notes

• Stability improvements
• Performance optimizations
• Page builder compatibility enhancements

Download

respira-for-wordpress-1.8.40.zip

Notes

• Added custom CSS API endpoints
• Enhanced Elementor cache management
• Improved builder detection

WooCommerce Add-on v4.0.0

The storefront layer stops assuming a page builder. 105 tools total. Requires Respira for WordPress plugin 8.0.0 or newer.

Storefront intelligence is FSE-first with page-builder fallback

• On a block theme, analysing a shop page returns real structural analysis against the native archive-product template instead of "no page builder detected". Where a page builder is present, the builder path still runs

Badges match WooCommerce's own product card

• Sale and low-stock badges are positioned inside the product image, where WooCommerce puts them
• An existing badge means the write is refused as a no-op rather than duplicated, so re-running a prompt does not stack badges

Product-card fields addressed by canonical block name

• woocommerce/product-image, woocommerce/product-price, woocommerce/product-title, woocommerce/product-button
• Requested attributes are intersected with the installed block's registered attributes, so an unrecognised key is refused rather than silently accepted

Reporting

• Bounded, HPOS-compatible revenue reporting, sales time-series, top products, orders, and privacy-safe customer reporting

Read-only store discovery

• Store configuration, payment gateways, shipping zones, and tax rates

Approval-gated native webhooks

• HTTPS targets only, allowlisted topics only, write-only secrets, and a human approval on every webhook change

Credit

• The FSE gap was found and published by Dale Smith of revWorx, who builds exclusively on FSE block themes and verified live that the storefront tools were inert there

WooCommerce Add-on v3.2.0

Product configurator editing for stores running STAGGS. 87 tools total.

• Eight configurator tools: detect STAGGS, enable or disable the configurator per product, list attribute groups, and rewrite option items (labels, prices, defaults) through the STAGGS/Carbon Fields helpers
• Allow-listed writes: any key outside the known-safe set refuses the whole request rather than half-applying it
• Verified live against the real STAGGS plugin, round-trip included

WooCommerce Add-on v3.1.0

Your store becomes discoverable and shoppable by AI assistants. 79 tools, up from 56.

• Product feeds in six formats (Google Shopping XML, OpenAI/ChatGPT JSONL, Meta, Pinterest, TikTok, generic CSV), rebuilt in the background on schedule and minutes after products change, plus a store llms.txt at the site root
• The AI-readiness score becomes a fix loop: an ordered fixlist, GTIN and gallery writes on update_product, image alt-text writes, robots.txt AI-crawler checks
• Signed cart links that fill a shopper's cart and land on your own checkout, with agent-origin order attribution and a revenue report
• 14 write tools for WooCommerce Subscriptions, Bookings and Memberships, tested against the real extensions, dry-run by default
• A new wp-admin screen under WooCommerce, Respira ARC, as the home for feeds, the quality score, cart links and agent-origin orders
• The readable half also ships standalone as Respira ARC, a free plugin submitted to WordPress.org

See Agent-Ready Commerce for the full documentation.

WooCommerce Add-on v3.0

Complete WooCommerce agent coverage: 56 tools.

• Variations, attributes, and the WooCommerce 10.9 colour and image swatches
• Brands, coupons, customers (PII-aware), order notes, and refunds with dry-run by default
• AI-readiness scoring per product and across the catalog

Latest MCP server version

The current MCP server release is v8.0.0, shipped alongside plugin v8.0.0 and WooCommerce add-on v4.0.0.

Install: npx @respira/wordpress-mcp-server

npm: @respira/wordpress-mcp-server

What's New

Measured by booting the server and calling tools/list: 197 tools on any WordPress site, 302 with the WooCommerce add-on active (105 of those are woocommerce_* tools), alongside 269 WebMCP abilities and 37 skills.

• Site Editor tools: block templates and template parts, synced and unsynced patterns, block navigation, and design tokens
• Navigation is edited by exact block path. A guessed path is refused, and a stale revision is refused
• Every structural mutation returns one of dry_run, pending_approval, verified, stored_unverified, no_match, or a failure with a reason. verified is only returned after WordPress rendered the result
• Structural writes to site-level objects are beta-gated per site and off by default. Read-only discovery is available everywhere
• Activity tools that link audit entries to snapshots, proposals, approvals, and rollbacks
• Divi Theme Builder global layout writes require the confirm_live_edit=true handshake after the first refusal with respira_tb_live_edit_confirmation_required

MCP server v3.3.5

Install: npx @respira/wordpress-mcp-server

npm: @respira/wordpress-mcp-server

What's New

• Added normalized agent telemetry headers on WordPress requests (X-Respira-Agent-*).
• Setup/discovery now sends the same agent signature headers as runtime tool calls.

What's New

• Added WooCommerce taxonomy tools for categories and tags (list/get/create/update/delete).
• Added product category/tag assignment fields to MCP write schemas.
• Updated Desktop MCP inventory contract to 82 WordPress tools + 21 WooCommerce tools (103 total with add-on active).

Compatibility

• Requires WooCommerce add-on 1.0.2+ for taxonomy endpoint execution.

What's New

• Added once-per-day npm update checks with a persistent local cache.
• Added respira_mcp_update prompt hints when a newer MCP version is available.
• Improved 5xx error handling so WordPress critical errors surface structured diagnostics.

Notes

• Set RESPIRA_MCP_DISABLE_UPDATE_CHECK=1 to disable the automatic update check.

What's New

• Added automatic v2 capability negotiation (/wp-json/respira/v2/status) with v1 fallback.
• Added snapshot toolchain support (list/get/diff/restore) and builder patch support.
• Added include-driven fidelity reads for richer context payloads.

Latest MCP server version

Install: npx @respira/wordpress-mcp-server

npm: @respira/wordpress-mcp-server

What's New

• Custom post meta support - wordpress_update_custom_post accepts meta for arbitrary post meta
• Custom CSS support - wordpress_update_custom_post accepts customCss (builder-aware)
• Compatibility guard - Requires Respira for WordPress plugin v1.9.1+ for these custom post updates

Features

• 11 page builder support (Divi, Elementor, Bricks, Oxygen, Gutenberg, Breakdance, etc.)
• Module-level content updates
• Duplicate-before-edit safety
• SEO and performance analysis with Core Web Vitals
• WPML multilingual support
• Full menu management with hierarchy

CLI Options

npx @respira/wordpress-mcp-server --setup   # Run setup wizard
npx @respira/wordpress-mcp-server --list    # List configured sites
npx @respira/wordpress-mcp-server --test    # Test default site connection
npx @respira/wordpress-mcp-server --help    # Show help

Notes

• Fixed axios interceptor async handling
• Resolved [object Promise] error in plugin installation
• Improved error messaging

Notes

• Updated npm package description
• Added SEO-focused keywords
• Improved documentation

Free version for WordPress.org

A limited free version with Gutenberg support.

Features

• Gutenberg (Block Editor) support
• 30 edits per month
• 3-day audit log
• Read-only menu endpoints
• Read-only taxonomy endpoints
• Security validation (XSS, SQL injection)
• REST API access

What's New in 1.0.2

• Added /usage endpoint for checking edit limits
• Added read-only menu endpoints (GET /menus, GET /menus/{id})
• Added read-only taxonomy endpoints
• Added read-only taxonomy endpoints
• Added 3 API key limit enforcement
• Added automatic audit log cleanup