agent-mosaic-skill
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
BMBrick Photo-to-LEGO-Mosaic Skill
Convert any local photo into a LEGO-style brick mosaic preview — directly from your AI agent.
@bmbrick/photo-to-lego-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.
Renamed from
@bmbrick/agent-mosaic-skill(the old name still works but is deprecated — please migrate to the new name for future updates).
Visual Previews
Generated with the generate_lego_mosaic tool (3D render mode):
Square Tiles (square_1x1)
Original Photo | 48x48 Preview | 64x64 Preview |
|
|
|
Round Tiles (round_1x1)
Original Photo | 48x48 Preview | 64x64 Preview |
|
|
|
For more case studies and mosaic examples, check out our Pinterest Showcase.
Related MCP server: mcp-image-tools
Quick Start
npx -y @bmbrick/photo-to-lego-mosaic-skillMCP Client Configuration
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"lego-mosaic": {
"command": "npx",
"args": ["-y", "@bmbrick/photo-to-lego-mosaic-skill"]
}
}
}Cursor (.cursor/mcp.json):
{
"mcpServers": {
"lego-mosaic": {
"command": "npx",
"args": ["-y", "@bmbrick/photo-to-lego-mosaic-skill"]
}
}
}Tool: generate_lego_mosaic
Parameter | Type | Required | Default | Description |
| string | Yes | — | Absolute path to a local image |
| number | No | 48 | Preview width in studs (max 64) |
| number | No | 48 | Preview height in studs (max 64) |
| string | No |
|
|
| string | No |
| Render style |
| 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.mdfor seamless agent workflow integration3D Render Mode — InstancedMesh PBR rendering with realistic brick studs
Engineering Docs
Deep technical reference for the color quantization pipeline that powers this skill and bmbrick.com:
Color quantization pipeline: principles, history, and lessons — current architecture, architectural decisions, verified principles, failed experiments from 25+ versions of iteration, and parameter sensitivity reference.
Migrating from @bmbrick/agent-mosaic-skill
If you were using the old name, the migration is one search/replace:
Package name:
@bmbrick/agent-mosaic-skill→@bmbrick/photo-to-lego-mosaic-skillMCP tool name (in your agent's tool list):
generate_bmbrick_mosaic→generate_lego_mosaicBinary name (rare):
agent-mosaic-skill→photo-to-lego-mosaic-skill
The tool parameters (imagePath, columns, rows, etc.) and return shape are unchanged.
Development
License
Dual-licensed:
MIT — MCP wrapper,
skill/directory, agent integration surfaceRestricted —
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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Build and check custom brick sets with your agent: real parts, revisions, exports.
Image & PDF tools for AI agents: compress, convert, resize, PDF, AI vision, pipeline.
Video, audio, and image processing for AI agents: convert, transcribe, upscale - 150+ operations.
1000x1000 pixel canvas only AI agents can buy. Read the canvas and buy pixels via x402 (USDC).
Related MCP Servers
- AlicenseAqualityBmaintenanceIdentifies LEGO parts, sets, and minifigures from local image files using the Brickognize API. It provides specialized tools for specific item recognition and integrates LEGO identification capabilities into MCP-enabled environments.542 npm15MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to perform image processing tasks such as sprite sheet splitting, resizing, cropping, and batch operations on local images.MIT
- AlicenseNot gradedqualityDmaintenanceFuse bead MCP: convert images, generate AI art, matchcolors (CIEDE2000) estimate bead costs.MIT
- AlicenseNot gradedqualityFmaintenanceEnables text-only LLMs to understand images by converting them into structured text grids (colors, textures, regions) and OCR via MCP tools. Runs locally with zero external dependencies, providing a skill-based methodology for detailed image analysis.18 npm2MIT




