bricks-mcp

The most comprehensive open-source MCP server for Bricks Builder.

100+ tools to manage pages, templates, styles, SEO, content, and more — directly from Claude Code, Cursor, Windsurf, or any MCP-compatible AI assistant.

Architecture

Claude Code / Cursor / AI Assistant
        ↕ MCP Protocol (stdio)
   bricks-mcp (Node.js)
        ↕ REST API (Basic Auth)
   bricks-api-bridge (WordPress Plugin)
        ↕ PHP
   WordPress + Bricks Builder

The MCP server communicates with your WordPress site through the included REST API plugin. Your AI assistant gets full control over Bricks Builder — reading pages, updating elements, managing styles, and building sections.

Quick Start (5 Minutes)

1. Install the WordPress Plugin

The plugin/ folder in this repo contains the Bricks API Bridge WordPress plugin. Choose one of these install methods:

Option A: ZIP Upload (easiest)

Download bricks-api-bridge.zip from the latest release
Go to WordPress Admin → Plugins → Add New → Upload Plugin
Upload the ZIP and click "Install Now"
Click "Activate"

Option B: Manual Upload via FTP/SSH

Clone this repo or download it

Copy the plugin/ folder to your WordPress installation:

cp -r plugin/ /path/to/wordpress/wp-content/plugins/bricks-api-bridge/

Go to WordPress Admin → Plugins → Activate "Bricks API Bridge"

Option C: WP-CLI

# From the repo root
cd plugin && zip -r ../bricks-api-bridge.zip . && cd ..
wp plugin install bricks-api-bridge.zip --activate

After activation, the plugin registers REST API endpoints under /wp-json/bricks-bridge/v1/. No configuration needed — it works out of the box with WordPress Application Passwords.

2. Create an Application Password

In WordPress Admin → Users → Your Profile → Application Passwords:

Enter a name (e.g., "MCP Server")
Click "Add New Application Password"
Copy the generated password

3. Install the MCP Server

git clone https://github.com/developer2013/bricks-mcp-open.git
cd bricks-mcp-open
npm install   # or: bun install

4. Configure Credentials

Copy .env.example to .env and fill in your details:

cp .env.example .env

WORDPRESS_URL=https://your-site.com
WORDPRESS_USER=your-username
WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx

5. Add to Your AI Assistant

Claude Code — add to ~/.claude/.mcp.json:

{
  "mcpServers": {
    "bricks": {
      "command": "node",
      "args": ["/path/to/bricks-mcp-open/index.js"]
    }
  }
}

Or with Bun (faster startup):

{
  "mcpServers": {
    "bricks": {
      "command": "bun",
      "args": ["/path/to/bricks-mcp-open/index.js"]
    }
  }
}

Claude Code iOS / Android App — open Settings → MCP Servers → Add Server:

Name: bricks
Command: node (or bun)
Arguments: /path/to/bricks-mcp-open/index.js
Environment Variables:
- WORDPRESS_URL = https://your-site.com
- WORDPRESS_USER = your-username
- WORDPRESS_APP_PASSWORD = xxxx xxxx xxxx xxxx xxxx xxxx

Cursor / Windsurf — add the same config to .cursor/mcp.json in your project.

Hermes Agent (Nous Research) — add to config.yaml:

mcp_servers:
  bricks:
    command: node
    args: ["/path/to/bricks-mcp-open/index.js"]
    env:
      WORDPRESS_URL: https://your-site.com
      WORDPRESS_USER: your-username
      WORDPRESS_APP_PASSWORD: "xxxx xxxx xxxx xxxx xxxx xxxx"

Hermes has native MCP client support since v0.2.0 — all 105 tools appear in its tool list automatically. Works with any model (Hermes 3, Llama, OpenRouter, etc.).

Manage Your WordPress Site from Your Phone

Deploy the MCP server as a self-hosted MCP environment on Railway (or any Docker host), then connect it to the Claude Code mobile app. No Mac running in the background needed — the server runs 24/7 in the cloud.

How it works:

iPhone / Android (Claude Code App)
      ↕ Claude Self-Hosted MCP
Railway / Docker (MCP Server — always on)
      ↕ REST API
WordPress + Bricks Builder

Setup:

Deploy the MCP server to Railway using the included agent-service/Dockerfile
In Claude Console → MCP → Create Self-Hosted Environment
Generate an environment key and add it to your Railway deployment
The Claude Code mobile app automatically connects to your self-hosted environment

What you can do from your phone — no laptop needed:

You:  "List all my pages and their SEO scores"
You:  "Create a new landing page for my dental practice"
You:  "Update the hero headline on page 42 to 'Welcome to Our Practice'"
You:  "Run an SEO audit and fix all missing meta descriptions"
You:  "Add a testimonials section using the testimonials-slider preset"
You:  "Create a snapshot called 'before-redesign', then change the palette"

Action	Example Prompt
Build pages	"Create a hero section with dark gradient background"
Edit content	"Change the button text on page 42 to 'Book Now'"
SEO management	"Set meta description and OG image for all pages"
Style updates	"Update the primary color to #2563EB across the palette"
Backup & restore	"Create a snapshot called 'before-redesign'"
QA checks	"Check all links on page 42 for broken URLs"
Template management	"Clone the header template and modify the navigation"

The server runs 24/7 on Railway — your phone is just the control surface. All 105 tools are available anywhere, anytime.

6. Test the Connection

Ask your AI assistant:

"Use the bricks_connection_test tool to verify my WordPress connection."

Tool Categories (100+ Tools)

Category	Tools	Description
Pages	9	List, get, update, patch, append, build, clone, search pages
Scripts & Assets	5	Per-page CSS/JS management, GSAP flag control
SEO (Page)	6	Page-level SEO meta, schema markup, audit
Templates	8	Full template CRUD, clone, import, search
Backup & Snapshots	7	Named snapshots, multi-slot backups, restore
Global Classes	7	CSS class CRUD, bulk create, usage analysis
BEM Components	3	Generate, apply, and validate BEM class sets
Style System	10	Color palette, fonts, CSS variables, breakpoints
Theme Styles	2	Global theme style read/write
Presets	4	Section presets: list, instantiate, save, delete
SEO (Advanced)	13	Auto-fix, bulk update, sitemap, redirects, link check
WordPress Content	8	Posts, categories, tags CRUD
Menus	5	Navigation menu management
Site Management	9	Settings, page creation, validation, cache, stats
Media	3	Upload, list, edit media files
Multi-Site	3	Switch between WordPress sites at runtime
Utilities	3	Connection test, HTML→Bricks converter, batch ops

Multi-Site Support

Manage multiple WordPress sites from a single MCP server. Copy sites.json.example to sites.json:

{
  "default": "production",
  "sites": {
    "production": {
      "label": "Live Site",
      "url": "https://your-site.com",
      "username": "admin",
      "password": "xxxx xxxx xxxx xxxx xxxx xxxx"
    },
    "staging": {
      "label": "Staging",
      "url": "https://staging.your-site.com",
      "username": "admin",
      "password": "xxxx xxxx xxxx xxxx xxxx xxxx"
    }
  }
}

Switch sites at runtime:

"Switch to the staging site."

Usage Examples

Build a page section

"Create a hero section on page 42 with a full-width background, centered heading 'Welcome', a subtitle, and a CTA button."

Manage styles

"Update the color palette — set the primary color to #2563EB and secondary to #7C3AED."

SEO optimization

"Run an SEO audit on all published pages and auto-fix missing meta descriptions."

Backup before changes

"Create a snapshot of page 42 named 'before-redesign', then update the hero section."

Plugin Features

The included WordPress plugin (bricks-api-bridge) provides:

REST API endpoints for all Bricks Builder data
Security hardening — rate limiting, user enumeration protection, security headers
Responsive inference — automatic mobile/tablet breakpoint generation
Element validation — catches invalid IDs, broken parent-child links
Auto-fix — corrects common CSS issues (overflow, grid, container width)
Backup system — multi-slot backups + named snapshots
Design token import/export — JSON, ACSS, Tailwind formats

Feature Comparison

Feature	bricks-mcp	Novamira	cristianuibar/bricks-mcp	sabiertas/bricks-mcp-server
Focus	Bricks Builder	Generic WordPress	Bricks Builder	Bricks Builder
Tools	105	22 (12 core + 10 Gutenberg)	11	10
Approach	REST API (structured endpoints)	PHP execution + filesystem	REST API	REST API
Agent Service	Autonomous 5-phase pipeline	-	-	-
Mobile Control	Telegram bot (iPhone/Android)	-	-	-
Multi-Site	Runtime switching	-	-	Environment vars
BEM Support	Generate + Apply + Validate	-	-	-
SEO Tools	19 (meta + audit + redirects)	-	-	-
Backup System	Snapshots + Multi-slot	-	-	-
Section Presets	25 ready-to-use	-	-	-
Security Hardening	Rate limit + Headers	-	-	-
Responsive Inference	Auto breakpoints	-	-	-
WordPress Content	Posts + Categories + Tags + Menus	Via PHP execution	-	-
Batch Operations	Up to 20 per request	-	-	-
Design Tokens	Import/Export (JSON, ACSS)	-	-	-
Auto-Fix	Overflow, grid, container	-	-	-
Gutenberg Support	-	Block Editor Queue	-	-
PHP Execution	-	Direct PHP eval	-	-
License	MIT	AGPL-3.0	GPL-2.0	MIT

Requirements

Node.js >= 18 or Bun >= 1.0
WordPress >= 6.0
Bricks Builder >= 2.0
PHP >= 8.0

Agent Service (Autonomous Page Builder)

The agent-service/ directory contains an autonomous agent that builds entire WordPress pages from industry briefs — using Claude + the MCP server in a 5-phase pipeline:

Industry Brief → Historian → Design → Code → Update → QA → Fix Loop

Build from your iPhone or Android — Use the Telegram bot or the Claude Code mobile app as your control center: trigger builds, QA, fixes, and screenshots from anywhere
CLI Mode — Single builds or overnight batch processing
Budget Control — Per-phase cost caps, total cost tracking
Docker Ready — Deploys to Railway, Fly.io, or any container host

See agent-service/README.md for setup instructions.

Premium

Looking for more? The premium edition includes 260+ tools with:

AI Build Pipeline — Build entire pages from a URL in one command
Learning System — Remembers CSS fixes and improves over time
Math Library — 33 modules for design tokens, color harmony, spring physics
Visual QA — Puppeteer screenshots, pixel comparison, accessibility audits
Design Intelligence — Brand archetypes, competitive benchmarking, typography suggestions
WooCommerce, ACF, Gravity Forms integrations
Bio-inspired animations — Levy stagger, density-intensity, quorum sensing

Contact us for premium access

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License. See LICENSE.

Name		Name	Last commit message	Last commit date
Latest commit History 19 Commits
agent-service		agent-service
docs		docs
plugin		plugin
tests		tests
tools		tools
utils		utils
.env.example		.env.example
.gitignore		.gitignore
.mcp.json.example		.mcp.json.example
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
config.js		config.js
index.js		index.js
package-lock.json		package-lock.json
package.json		package.json
site-manager.js		site-manager.js
sites.json.example		sites.json.example

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

bricks-mcp

Architecture

Quick Start (5 Minutes)

1. Install the WordPress Plugin

2. Create an Application Password

3. Install the MCP Server

4. Configure Credentials

5. Add to Your AI Assistant

Manage Your WordPress Site from Your Phone

6. Test the Connection

Tool Categories (100+ Tools)

Multi-Site Support

Usage Examples

Build a page section

Manage styles

SEO optimization

Backup before changes

Plugin Features

Feature Comparison

Requirements

Agent Service (Autonomous Page Builder)

Premium

Contributing

License

About

Uh oh!

Releases 1

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

bricks-mcp

Architecture

Quick Start (5 Minutes)

1. Install the WordPress Plugin

2. Create an Application Password

3. Install the MCP Server

4. Configure Credentials

5. Add to Your AI Assistant

Manage Your WordPress Site from Your Phone

6. Test the Connection

Tool Categories (100+ Tools)

Multi-Site Support

Usage Examples

Build a page section

Manage styles

SEO optimization

Backup before changes

Plugin Features

Feature Comparison

Requirements

Agent Service (Autonomous Page Builder)

Premium

Contributing

License

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages