Bricks Builder MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with full access to Bricks Builder page content, enabling programmatic page building, template management, and element manipulation through natural language.

Features

• 29 tools for full Bricks Builder management
• Read, write, search, and manipulate Bricks page elements
• Template management with type filtering (header, footer, section, content, popup)
• Snapshot system for rollback before destructive changes
• Element tree view, bulk updates, move, and duplication
• Global classes and custom CSS management
• Multi-site support: manage multiple Bricks sites from one server instance
• CPT support: works with any custom post type, not just pages/posts
• Response trimming and pagination with totals

Available Tools (29)

Element Manipulation (10 tools)

Snapshot / Rollback (4 tools)

Template Management (5 tools)

Page Management (3 tools)

CSS & Styling (4 tools)

Local Helpers (2 tools — no API calls)

Site Settings (1 tool)

Requirements

• Node.js 18+
• WordPress site with Bricks Builder theme installed and active
• WordPress Application Password

Quick Setup

1. Install the companion WordPress plugin

Copy bricks-mcp.php to your WordPress mu-plugins directory:

wp-content/mu-plugins/bricks-mcp.php

This mu-plugin is required — it exposes Bricks Builder data to the REST API. It:

• Enables REST API access for the bricks_template post type
• Registers meta REST fields on pages, posts, and templates for reading/writing _bricks_page_content_2 (elements) and _bricks_page_css_2 (custom CSS)
• Adds custom endpoints:
  • GET /bricks/v1/get-global-classes — read global CSS classes
  • POST /bricks/v1/set-global-classes — write global CSS classes
  • GET /bricks/v1/get-settings — read Bricks global settings

All endpoints require authentication (edit_posts capability; manage_options for settings).

2. Clone and build

git clone https://github.com/webshr/bricks-builder-mcp.git
cd bricks-builder-mcp
npm install
npm run build

3. Configure in Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "bricks": {
      "command": "node",
      "args": ["/path/to/bricks-builder-mcp/dist/index.js"],
      "env": {
        "BRICKS_SITES": "prod,test",
        "BRICKS_PROD_URL": "https://your-domain.com",
        "BRICKS_PROD_USERNAME": "wp-username",
        "BRICKS_PROD_PASSWORD": "application-password",
        "BRICKS_TEST_URL": "https://staging.your-domain.com",
        "BRICKS_TEST_USERNAME": "admin",
        "BRICKS_TEST_PASSWORD": "application-password"
      }
    }
  }
}

4. Configure in Cursor / other MCP clients

Same config pattern -- see your client's MCP documentation.

Authentication

Uses WordPress Application Passwords (Basic Auth). Create one at: WordPress Admin > Users > Profile > Application Passwords

Multi-site Support

This server supports managing multiple Bricks Builder sites simultaneously:

1. BRICKS_SITES: Comma-separated list of site identifiers (e.g., prod,test,etc.)
2. Per-site variables: For each site ID, set BRICKS_{ID}_URL, BRICKS_{ID}_USERNAME, and BRICKS_{ID}_PASSWORD
3. Tool usage: Every tool accepts a site parameter. If omitted, the first configured site is used as default.

CPT Support

All element and CSS tools accept a post_type parameter that defaults to pages but works with any registered custom post type (e.g., posts, product, portfolio).

Response Format

List endpoints return paginated responses:

{
  "data": [...],
  "total": 25,
  "total_pages": 1
}

Changelog

v1.0.0

• 29 tools for full Bricks Builder management
• 10 element tools: get, set, add, update, remove, find, bulk update, move, duplicate, tree view
• 4 snapshot tools: save, restore, list, delete
• 5 template tools with type filtering (header, footer, section, content, popup)
• 3 page tools: list (with search and include_all), create, clone
• 4 CSS tools: get/set global classes, get/set page CSS
• 2 local helpers: element type catalog (22 types), element JSON generator
• Multi-site support with per-site credentials
• CPT support for all element/CSS tools
• Element validation with warnings
• Response trimming and pagination with totals

Contributing

PRs welcome. Please open an issue first to discuss changes.

License

MIT