Agent Mosaic Skill MCP Server

Convert any local photo into a LEGO-style brick mosaic preview. MCP server + Node API powered by the BMBrick color quantization engine. Renamed from

Local serverstdio

What is the Agent Mosaic Skill MCP server?

Most file and storage access work still happens through a UI a human drives. Agent Mosaic Skill MCP server moves it into the conversation instead. Convert any local photo into a LEGO-style brick mosaic preview. MCP server + Node API powered by the BMBrick color quantization engine. Renamed from @bmbrick/agent-mosaic-skill.

The short version

  • 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

The tools it exposes

The server publishes 9 tools. What each one is for:

  • Agent-Ready — ships with a SKILL.md for seamless agent workflow integration
  • 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
  • imagePath — string
  • columns — number
  • rows — number
  • materialMode — string
  • renderMode — string
  • removeBackground — boolean

Getting it running

@bmbrick/photo-to-lego-mosaic-skill on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

How it compares

Plenty of file and storage access servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Agent Mosaic Skill's toolset — Agent-Ready, MIT, Restricted and 6 more — is a fair guide to whether it matches your workflow. It is maintained by able-rip; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 9 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Agent Mosaic Skill.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
Agent-Readyships with a SKILL.md for seamless agent workflow integration
MITMCP wrapper, skill/ directory, agent integration surface
Restricteddist/ engine files: free to use and distribute as-is, but no de-obfuscation, reverse engineering, or redistribution of modified versions
imagePathstring
columnsnumber
rowsnumber
materialModestring
renderModestring
removeBackgroundboolean

How to install the Agent Mosaic Skill MCP server

**Cursor** (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "lego-mosaic": {
      "command": "npx",
      "args": ["-y", "@bmbrick/photo-to-lego-mosaic-skill"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Agent Mosaic Skill to Agent-Ready.
  • Use Agent Mosaic Skill to MIT.
  • Use Agent Mosaic Skill to Restricted.

Frequently asked questions

It connects Agent Mosaic Skill to MCP-compatible AI assistants such as Claude and Cursor, exposing 9 tools (Agent-Ready, MIT, Restricted, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Agent Mosaic Skill directly.