BMBrick Agent Mosaic Skill

Convert any local photo into a LEGO-style brick mosaic preview — directly from your AI agent.

@bmbrick/agent-mosaic-skill is an MCP server that lets Claude, Cursor, Windsurf, and other AI agents transform local images into high-fidelity 3D brick mosaics using the same canonical engine as bmbrick.com.

Visual Previews

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

Original Photo	48x48 Preview	64x64 Preview

Quick Start

npx -y @bmbrick/agent-mosaic-skill

MCP Client Configuration

Claude Desktop (claude_desktop_config.json):

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

Cursor (.cursor/mcp.json):

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

Tool: `generate_bmbrick_mosaic`

Parameter	Type	Required	Default	Description
`imagePath`	string	Yes	—	Absolute path to a local image
`columns`	number	No	48	Preview width in studs (max 64)
`rows`	number	No	48	Preview height in studs (max 64)
`materialMode`	string	No	`square_1x1`	`square_1x1` or `round_1x1`
`renderMode`	string	No	`3D`	Render style
`removeBackground`	boolean	No	false	Clean up white/transparent backgrounds

Returns: a local watermarked PNG preview + a link to unlock the full project at bmbrick.com.

Unlock Full Project

The preview is watermarked and intended for creative exploration. To get the complete deliverables — HD unwatermarked mosaic, brick-by-brick PDF instructions, parts list with ordering links, and CSV/XML placement matrices — visit bmbrick.com.

Features

Same Engine as bmbrick.com — canonical color science, quantization, and 3D rendering pipeline
Local & Private — all processing happens on your machine via Node.js
Agent-Ready — ships with a SKILL.md for seamless agent workflow integration
3D Render Mode — InstancedMesh PBR rendering with realistic brick studs

Development

License

Dual-licensed:

MIT — MCP wrapper, skill/ directory, agent integration surface
Restricted — dist/ engine files: free to use and distribute as-is, but no de-obfuscation, reverse engineering, or redistribution of modified versions

See LICENSE for full terms.

agent-mosaic-skill