MCP serverFlatsome MCP server, with undo on every edit.
A Flatsome MCP server lets Claude, ChatGPT or Cursor read and edit Flatsome UX Builder pages on a live WordPress site, shortcode by shortcode, product grids included. With Respira every edit lands on a copy first, and you can undo it for 90 days.
7 days free. No card. Runs on the AI subscription you already have.
- Support
- Full
- Flatsome tools
- Core set
- Latest release touching it
- 9.1.11
- Releases touching it
- 18
Respira is an independent MCP server. Not affiliated with, endorsed by, or sponsored by UX Themes / Flatsome.
What works today. What still needs you.
Read from the current MCP server release, first-class reads and writes across the builder structure.
Works now
- 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.
- UX Blocks, the reusable blocks Flatsome uses for headers, footers and mega menus, are posts of the
blockstype and go through the same shortcode reads and writes, by post ID. - Custom CSS at theme level (
flatsome_options[custom_css]) and per-page level are both writable.
Where a human still steps in
- Flatsome Studio, the library of ready-made layouts inside the UX Builder, is not connected. Importing from Studio goes through Flatsome's own UI; once a Studio layout is on a page it is ordinary UX Builder shortcodes and Respira edits it like any other.
- 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.
Hit one of these and the snapshot gives you a clean way back.
Flatsome runs on the universal tools.
Find, update, move and remove elements, build whole pages, snapshot and roll back. Reads return the builder structure and writes keep it intact.
Three prompts you can paste right now.
Each one assumes Respira is connected to a Flatsome site. Paste it into your AI tool and 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.
More recipes, per builder, in the Prompt Book.
Connect a Flatsome site in two minutes.
Chat apps sign in with the browser. Coding tools take one command. Anything else takes the config below.
One command
Detects Claude Code, Cursor, Codex, Windsurf and more, and writes the config.
npx add-mcp "npx -y @respira/wordpress-mcp-server"Or paste the config
Get the site URL and key from your setup page.
{
"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"
}
}
}
}- Claude Desktop on macOS reads
claude_desktop_config.json, notconfig.json. - Prefer no terminal at all? Sign in with your browser from Claude, ChatGPT or Cursor.
What changed for Flatsome lately.
The last 5 releases that mention Flatsome, filtered from the same changelog the releases page reads.
-
- find_element by content, text or class works on every builder. A
-
- wordpress_find_element searches content, text and class on every builder (plugin 9.1.11). The description says each match names its field with a snippet and that no match is a normal answer with found: 0. wordpress_apply
-
- Fidelity mode on every builder. Elementor, the block editor family,
-
- An edit reaches the page on every builder. update_element was changing the element on the page for 5 of 14 edits on Elementor, 7 on Beaver Builder, 4 on Bricks, 8 on Divi 5, none on Divi 4, 3 on Breakdance, 6 on WPBakery
-
- Flatsome dropped content it could not model. The shortcode parser had no tag
- Flatsome moved content between columns. Column boundaries were discarded on
- Flatsome refused edits it should have allowed. The write guard compared against
Questions people ask about Flatsome and MCP.
Is there an MCP server for Flatsome?
Yes. Respira is an independent MCP server that reads and writes Flatsome in its own format, with first-class reads and writes across the builder structure. It is not made by the Flatsome team.
Which tools does it use for Flatsome?
Flatsome runs through the universal tools: find, update, move and remove elements, build pages, snapshot and roll back. Reads return the builder structure, and writes keep it.
What happens when the agent gets an edit wrong?
Nothing on the live page. The agent edits a copy first, you approve it inside WordPress, and every write is snapshotted with 90 days of undo.
Do I need a developer or a terminal?
No. Sign in with your browser from Claude, ChatGPT or Cursor and approve the connection once. Coding tools get a one-line command.
Does it work with a Flatsome site that also runs WooCommerce?
Yes. The WooCommerce add-on adds 104 store tools on the same connection, with the same duplicate-first approval flow.
Looking for the Flatsome overview, with visuals and the conversion story? Flatsome features
The other builders, same server.
Start with one site. Free for 7 days.
Maker is €9 a month after the trial. No card for the trial, and it runs on the AI plan you already have, so there is no extra AI bill.
