BMBrick Agent Mosaic Skill

Preview-only local mosaic generation for Agent and MCP workflows.

@bmbrick/agent-mosaic-skill lets an agent convert a local image into a BMBrick LEGO-style mosaic preview on the user's machine. The generated preview uses the same canonical BMBrick preview pipeline as the website, includes a BMBrick watermark, and does not return project data such as placement matrices, parts lists, PDFs, or unwatermarked HD exports.

Visual Previews

Generated using the generate_bmbrick_mosaic tool (3D render mode):

Usage

Run directly via npx:

npx -y @bmbrick/agent-mosaic-skill

MCP Configuration

Add this to your MCP settings file (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "bmbrick": {
      "command": "npx",
      "args": ["-y", "@bmbrick/agent-mosaic-skill"]
    }
  }
}

Tool: generate_bmbrick_mosaic

Inputs:

• imagePath: absolute local image path

• columns: preview width (default 48, max 64)

• rows: preview height (default 48, max 64)

• materialMode: square_1x1 (default) or round_1x1

• removeBackground: true/false

The result is a local PNG preview path + a link to bmbrick.com for unlocking full HD deliverables.

Boundaries

This is a preview-only tool. It provides a watermarked visual reference but does not expose:

• brick placement data

• parts lists

• PDF instructions

• unwatermarked HD exports

For the complete project, please visit bmbrick.com.

License

• MCP Wrapper & Skill: MIT

• Preview Engine: Restricted (Local watermarked preview use only)