Builder integration · Flatsome

Run an MCP server for Flatsome.

UX Builder editing for the Flatsome WooCommerce theme. Shortcode-aware reads and writes that respect Flatsome's nested element model.

Respira gives AI coding agents a structure-aware way to read and write Flatsome content through a duplicate-first workflow. Every write is snapshotted. Every change can be reviewed before going live.

Live status

What ships today for Flatsome

Everything below is read from this repo at build time: tool registrations come from the MCP server adapter files; changelog entries are filtered from the same source the /releases timeline uses.

Tools

uses core tools

Latest touch

6.3.5

Apr 16, 2026

Releases

3

touching Flatsome

Support

Full support

level

Last 3 releases mentioning Flatsome

What works

Capabilities shipped today

Concrete features in the current MCP server release. Tool names link directly to the adapter.

  • Flatsome UX Builder shortcodes parsed with full attribute preservation and nesting support.
  • Per-element writes via the standard find/update flow work on rows, columns, sections, banners, sliders, and product-related elements.
  • WooCommerce category, product, and shop-page edits work through the standard Woo addon tools alongside Flatsome layouts.
  • Flatsome studio templates (header, footer, mega-menus) are readable; per-template per-page assignment is editable.
  • Custom CSS at theme level (flatsome_options[custom_css]) and per-page level are both writable.

Known limits

Where you still need a human pass

Honest list of edges. If you hit one of these, the snapshot workflow gives you a clean rollback path.

  • Flatsome Studio (cloud library) imports go through Flatsome's own UI. The MCP can edit a layout once it's on the site, not pull from Studio.
  • Flatsome's real-time UX Builder preview is not driven from the MCP — Respira writes; you refresh the editor to see results.
  • Some legacy Flatsome 2.x layouts using unmaintained third-party shortcodes can lose attributes on round-trip. Duplicate first.

Tools

Flatsome uses the universal toolset

Flatsome edits run through Respira's universal tools: respira_find_element, respira_update_element, respira_update_page (for full-page replacement only), respira_get_snapshot, and respira_create_page_duplicate. See the complete tool catalog.

Example prompts

Three prompts you can paste right now

Each one assumes Respira is connected to your WordPress site through the MCP server below. Copy a prompt, paste into your MCP client, run.

Update product-category banners

For every WooCommerce product category, find the banner element in its Flatsome description and swap the headline from "Shop now" to "New collection". Snapshot each first.

Refresh the homepage hero slider

On the homepage, find the first ux_slider element. Replace slide 1's headline with "Holiday edition" and update its CTA URL to /holiday.

Audit color usage

List every distinct hex color value used in Flatsome shortcodes across all pages. Group by frequency.

Setup

Connect Respira's MCP server

Drop this into your MCP client config (Claude Desktop, Cursor, Codex, Windsurf — any MCP-compatible client). Generate an API key from your Respira dashboard first.

Flatsome MCP server config

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"],
      "env": {
        "WORDPRESS_URL": "https://yoursite.com",
        "WORDPRESS_API_KEY": "respira_your_api_key_here"
      }
    }
  }
}

Other builder MCPs

Connect a Flatsome site to Respira in two minutes.

Free trial, no card. Edit your site from your favorite AI coding assistant through a snapshot-protected MCP server.