What is Bricks Builder MCP?
Bricks Builder MCP is a Node server by webshr that gives an MCP client 29 tools for Bricks Builder sites. It reads and edits page elements, manages templates and global classes, and saves snapshots for rollback. A small mu-plugin must be installed on the WordPress site first.
Bricks Builder MCP is a Model Context Protocol server for sites built with the Bricks theme. It reads and writes Bricks page data through the WordPress REST API, using an Application Password for login.
It relies on a companion mu-plugin, bricks-mcp.php, which the README marks as required. The plugin exposes Bricks data and a few custom endpoints that the server then calls.
What the 29 tools cover
- Ten element tools to get, set, add, update, remove, find, move, duplicate and bulk update elements, plus a tree view.
- Four snapshot tools to save, list, restore and delete page state before risky changes.
- Five template tools, with type filters for header, footer, section, content and popup.
- Page tools, global class and page CSS tools, two local helpers and a global settings reader.
Who it is for
Best for
- Developers and agencies running one or more Bricks sites who want agent assisted edits with rollback.
- Bulk changes across elements, such as one setting update on many matching elements.
- Teams that need custom post type support, since element and CSS tools accept a post type.
Not for
- Sites that do not use the Bricks theme.
- People who cannot add a mu-plugin to the site or create an Application Password.
Use it with UiChemy
This server edits Bricks sites. UiChemy's Composer works on Elementor or Gutenberg pages, so the two do not overlap. To weigh the routes, read UiChemy vs Bricks AI. Click Get Started on uichemy.com.
Connect Bricks Builder MCP: Manage Bricks Pages With an AI Agent to your AI client
git clone https://github.com/webshr/bricks-builder-mcp.git && cd bricks-builder-mcp && npm install && npm run buildInstall the companion plugin
Copy bricks-mcp.php into wp-content/mu-plugins. It enables REST access for the bricks_template post type and exposes page content, CSS, global classes and settings.
Create an Application Password
In WordPress open Users, Profile, Application Passwords and add one for the server. The README says all endpoints require authentication.
Clone and build
Run the commands above. The README lists Node.js 18 or later and an active Bricks Builder theme as requirements.
Configure your client
Add the JSON above to your MCP client. The README shows Claude Code in claude.json and says Cursor and others use the same pattern. List more sites in BRICKS_SITES.
Client configuration
{
"mcpServers": {
"bricks": {
"command": "node",
"args": ["/path/to/bricks-builder-mcp/dist/index.js"],
"env": {
"BRICKS_SITES": "prod",
"BRICKS_PROD_URL": "https://your-domain.com",
"BRICKS_PROD_USERNAME": "wp-username",
"BRICKS_PROD_PASSWORD": "application-password"
}
}
}
}Endpoints and ports
/bricks/v1/get-global-classesCustom endpoint added by the mu-plugin/bricks/v1/set-global-classesCustom endpoint added by the mu-plugin/bricks/v1/get-settingsCustom endpoint, needs manage_optionsWhat you can do with it
- Element level editingRead the whole elements array or work on one element: add, update, move, duplicate, remove, or search by type, text or class.
- Snapshots for rollbackSave a page before a destructive change and restore it later if the result is wrong.
- Template managementList, read, create, update and delete templates, with type filters for headers, footers, sections, content and popups.
- Global classes and CSSRead and set global CSS classes in merge or replace mode, and read or set custom CSS for a page.
- Multi-site setupBRICKS_SITES names several sites with their own credentials, and every tool takes a site parameter.
- Custom post typesElement and CSS tools accept a post_type value, so they work beyond pages and posts.
- Paginated responsesList calls return trimmed data with totals and page counts, which keeps responses small.
Tools it exposes
bricks_get_page_elements
Gets the Bricks elements array for a page or post by ID.
bricks_add_element
Adds one element with automatic parent and child linking and validation.
bricks_update_element
Updates a specific element's settings with a shallow merge.
bricks_find_element
Searches elements by type, text content or CSS class.
bricks_bulk_update_elements
Updates several elements at once with validation.
bricks_snapshot_page
Saves the page state before changes are made.
bricks_restore_snapshot
Restores page elements from a saved snapshot.
bricks_list_templates
Lists templates, filtered by type and search.
bricks_clone_page
Clones a page's Bricks content with regenerated IDs.
bricks_set_global_classes
Adds or updates global CSS classes in merge or replace mode.
Frequently asked questions
What is Bricks Builder MCP?
It is an MIT licensed Node MCP server by webshr that gives AI assistants 29 tools for Bricks Builder. They read and write page elements, templates, global classes and page CSS through the WordPress REST API, with snapshot and restore tools for rollback.
How do I install Bricks Builder MCP?
Copy bricks-mcp.php into wp-content/mu-plugins, create a WordPress Application Password, then clone the repo and run npm install and npm run build. Finally add the node command and your site environment variables to your MCP client configuration.
Does Bricks Builder MCP need a WordPress plugin?
Yes. The README says the companion mu-plugin is required. It enables REST access for the bricks_template post type, registers the meta fields for elements and page CSS, and adds endpoints for global classes and settings.
Can Bricks Builder MCP undo a bad change?
It has snapshot tools to save, list, restore and delete page state, so an agent can snapshot before a destructive edit. The README does not describe automatic snapshots, so ask the agent to save one first.
Does Bricks Builder MCP work with Claude Code and Cursor?
The README gives a Claude Code configuration in claude.json and says Cursor and other MCP clients use the same pattern. It needs Node.js 18 or later and an active Bricks theme on the WordPress site.
Can Bricks Builder MCP manage several Bricks sites?
Yes. Set BRICKS_SITES to a comma separated list such as prod and test, then give each site a URL, username and Application Password. Every tool takes a site parameter, and the first configured site is the default.
Is Bricks Builder MCP free?
The README states the MIT license, so the source is free to use under those terms. GitHub shows no detected license file. You still need your own Bricks Builder theme license, which the README does not cover.
What are alternatives to Bricks Builder MCP?
Another Bricks server is Bricks MCP Open. For multi builder editing, see Respira WordPress MCP. To move an Elementor site across, the Elementor to Bricks migration skill works on draft duplicates, which suits a staged move.


