Bricks MCP Server

Bricks MCP

AI-powered assistant for Bricks Builder. Control your website with natural language through MCP-compatible AI tools like Claude.

Talk to your website. It listens.

What It Does

Bricks MCP is a WordPress plugin that implements an MCP (Model Context Protocol) server, letting AI assistants read and write your Bricks Builder site. Connect Claude, Gemini, or any MCP-compatible client and manage pages, templates, global classes, theme styles, WooCommerce layouts, and more — all through natural language.

Features

• 20+ MCP tools covering the full Bricks Builder data model
• Read and write pages, templates, elements, and global settings
• WooCommerce support (product pages, cart, checkout, account templates)
• Global classes, theme styles, typography scales, color palettes, variables
• Media library management with Unsplash integration
• WordPress menus, fonts, and custom code management
• Built-in connection tester and config snippet generator
• Works with Claude Code, Claude Desktop, Gemini, and any MCP client

Requirements

• WordPress 6.4+
• PHP 8.2+
• Bricks Builder 1.6+

Installation

1. Download the latest release from GitHub Releases
2. Upload to your WordPress site via Plugins > Add New > Upload Plugin
3. Activate the plugin
4. Go to Settings > Bricks MCP to configure

Connecting Your AI Tool

Claude Code

claude mcp add bricks-mcp https://yoursite.com/wp-json/bricks-mcp/v1/mcp --transport http

Claude Desktop / Other MCP Clients

Add to your MCP config (.mcp.json or equivalent):

{
  "mcpServers": {
    "bricks-mcp": {
      "type": "http",
      "url": "https://yoursite.com/wp-json/bricks-mcp/v1/mcp",
      "headers": {
        "Authorization": "Basic BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

Authentication uses WordPress Application Passwords (Users > Profile > Application Passwords).

Available Tools

Configuration

Go to Settings > Bricks MCP in WordPress admin:

• Enable MCP Server — toggle the server on/off
• Require Authentication — restrict access to authenticated users
• Custom Base URL — for reverse proxies or custom domains
• Dangerous Actions — enable write access to global Bricks settings and code execution

Extending

Add custom tools using the bricks_mcp_tools filter:

add_filter( 'bricks_mcp_tools', function( $tools ) {
    $tools['my_custom_tool'] = [
        'name'        => 'my_custom_tool',
        'description' => 'My custom tool description',
        'inputSchema' => [
            'type'       => 'object',
            'properties' => [],
        ],
        'handler'     => function( $args ) {
            return ['result' => 'success'];
        },
    ];
    return $tools;
});

Local Development

npm install
npm run start        # Start WordPress (Docker via wp-env)
npm run test         # Run PHPUnit tests
npm run lint         # WordPress coding standards check
npm run lint:fix     # Auto-fix linting issues

Local site: http://localhost:8888 (admin / password)

License

GPL-2.0-or-later