What is Bricks MCP Open?
Bricks MCP Open is an MIT licensed MCP server for Bricks Builder with 105 tools in 17 modules. A Node.js process on your machine talks to a companion WordPress plugin, Bricks API Bridge, over the REST API, so an agent can build pages, edit styles, run SEO audits and take snapshots.
Bricks MCP Open is a server for Bricks Builder, the WordPress site builder. The README describes an open source MCP server for Bricks with 100 plus tools to manage pages, templates, styles, SEO and content from any MCP compatible assistant.
It has two parts. A Node.js MCP server runs on your machine over stdio, and the Bricks API Bridge plugin on the WordPress site exposes REST endpoints. Credentials are a WordPress application password.
What the 105 tools cover
| Area | Tools | What it does |
|---|---|---|
| Pages | 9 | List, get, update, patch, append, build, clone and search pages |
| Templates | 8 | Create, read, update, delete, clone, import and search templates |
| Style system | 10 | Colour palette, fonts, CSS variables and breakpoints |
| Global classes | 7 | Class CRUD, bulk create and usage analysis |
| SEO (page and advanced) | 19 | Meta, schema, audit, auto-fix, sitemap, redirects, link check |
| Backup and snapshots | 7 | Named snapshots, multi-slot backups and restore |
Who it is for
Best for
- Agencies and freelancers who build client sites in Bricks and want an agent to repeat structure, classes and SEO work.
- Teams moving an Elementor site to Bricks, using the bundled Elementor to Bricks converter as a first pass.
- Anyone who wants snapshots and multi-site switching around agent edits.
Not for
- Sites that do not run Bricks Builder 2.0 or later. The README lists that as a requirement.
- Gutenberg editing. The README's own comparison table shows no Gutenberg support.
- WooCommerce, ACF and Gravity Forms work. The README lists those under its separate premium edition.
Use it with UiChemy
Bricks MCP Open works on Bricks sites. UiChemy's Composer writes HTML, CSS and JS for Elementor or Gutenberg pages instead. For the trade-offs between AI routes, see UiChemy vs Bricks AI. Click Get Started on uichemy.com.
Connect Bricks MCP Open: 105 Tools for Bricks Builder Sites to your AI client
git clone https://github.com/developer2013/bricks-mcp-open.gitInstall the bridge plugin
Download bricks-api-bridge.zip from the latest release and upload it under Plugins, Add New, Upload Plugin, then activate it. It registers REST endpoints under /wp-json/bricks-bridge/v1/.
Create an application password
In your WordPress profile, add an application password for the server and copy it.
Install the server
Clone the repository, then run npm install or bun install inside the folder.
Set credentials
Copy .env.example to .env and fill WORDPRESS_URL, WORDPRESS_USER and WORDPRESS_APP_PASSWORD.
Register it in your client
Add the config above to your client's MCP file. Then ask the agent to run the bricks_connection_test tool to verify the link.
Client configuration
{
"mcpServers": {
"bricks": {
"command": "node",
"args": ["/path/to/bricks-mcp-open/index.js"]
}
}
}Endpoints and ports
/wp-json/bricks-bridge/v1/Endpoints registered by the Bricks API Bridge plugin.https://your-site.comTarget site, set in .env.your-usernameAccount that owns the application password.~/mcp-config/bricks-sites.jsonOptional custom location for a multi-site sites.json.anim | static | offControls the startup banner.What you can do with it
- Bridge plugin plus serverStructured REST endpoints on the WordPress side keep the agent working with Bricks data rather than raw database edits.
- Snapshots before changesNamed snapshots and multi-slot backups let you roll a page back after an agent edit.
- Elementor to Bricks starterA structural conversion turns an Elementor export into native Bricks elements and marks unsupported widgets with labelled placeholders.
- Editable CSS guardAn optional guard warns or blocks when editable CSS is sent to the private page-assets bundle that the builder does not show.
- Multi-site switchingKeep several sites in a sites.json file and switch between them by asking.
- Batch operationsThe README lists batch operations of up to 20 per request.
- Responsive inferenceThe plugin can generate tablet and mobile breakpoint settings automatically.
- Design token import and exportTokens move in JSON, ACSS and Tailwind formats.
Tools it exposes
bricks_connection_test
Checks that the server can reach your WordPress site.
bricks_update_page
Updates a page's Bricks content. Take a snapshot first.
bricks_import_page
Pushes a prepared Bricks element array into a page.
bricks_update_page_assets
Writes per-page infrastructure CSS and JS into a private bundle.
bricks_update_page_settings
Edits Bricks page settings, including page-level custom CSS.
bricks_elementor_to_bricks
Translates an Elementor JSON export into a Bricks element array with a coverage report. It does not write to the site.
Pages and templates
Page and template CRUD, clone, patch, append, search and import.
Style system and classes
Palette, fonts, CSS variables, breakpoints, global classes and BEM sets.
SEO tools
Page SEO meta, schema, audit, bulk update, sitemap, redirects and link checks.
Snapshots and multi-site
Named snapshots, multi-slot backups, restore and runtime site switching.
Frequently asked questions
What is Bricks MCP Open?
It is an MIT licensed MCP server for Bricks Builder that exposes 105 tools in 17 modules. It pairs a local Node.js process with the Bricks API Bridge WordPress plugin so an AI agent can manage pages, templates, styles, SEO, media and backups.
How do I install Bricks MCP Open?
Install and activate the Bricks API Bridge plugin on your site, create an application password, clone the repository and run npm install, then fill in the .env file. Finally add the server to your MCP client's config and run the connection test tool.
Which Bricks and WordPress versions does it need?
The README requires Bricks Builder 2.0 or later, WordPress 6.0 or later and PHP 8.0 or later. The server itself needs Node.js 18 or later, or Bun 1.0 or later.
How many tools does Bricks MCP Open have?
The README states 105 tools across 17 modules, from page and template management to the style system, SEO, backups and multi-site switching. A separate premium edition with more than 260 tools is advertised but is not part of this repository.
Can Bricks MCP Open convert Elementor pages to Bricks?
It includes bricks_elementor_to_bricks for a first pass. You export an Elementor template as JSON, run the tool, and review the result. Common widgets map to native elements, and widgets such as Pro sliders or forms become placeholders you rebuild by hand. See the Elementor to Bricks skill.
Does Bricks MCP Open work with Gutenberg?
No. The README comparison table lists Gutenberg support as absent for this project. It targets Bricks Builder sites only. For block editor sites look at Respira for WordPress or MCP Abilities Elementor for Elementor.
Is it safe to let an agent edit a live Bricks site?
The README offers snapshots, backups and an optional editable-CSS guard, but nothing makes writes risk free. Take a snapshot before a change and try the server on a staging copy first. The tools can overwrite page content.
Does Bricks MCP Open work in Claude Code, Cursor and Windsurf?
The README says the server works with Claude Code, Cursor, Windsurf or any MCP compatible assistant, and gives config examples for Claude Code, Cursor and a Hermes Agent setup. The same stdio command works in each.


