# brick'em MCP Server

MCP server for LEGO minifigure price lookup and identification. Connects to the [brick'em](https://brickem.io) catalog of 18,000+ LEGO minifigures with real price data.

Ask your AI assistant: *"What is my LEGO minifigure worth?"*

## Tools

| Tool | Description |
|------|-------------|
| `scan_image` | **NEW** Send a photo of a minifigure and get it identified with prices. AI-powered image recognition. |
| `lookup_minifigure` | Look up a minifigure by BrickLink ID or name. Returns prices, image, theme. |
| `search_minifigures` | Fuzzy search by name with optional theme filter. Top 10 results with prices. |
| `get_theme_minifigures` | List all minifigures for a theme (Star Wars, Harry Potter, Marvel, etc.) sorted by value. |
| `identify_minifigure` | Describe a minifigure's appearance (colors, accessories, theme) and get best matches. |

### Supported Themes

Star Wars, Marvel, Harry Potter, Ninjago, City, Castle, Pirates, Collectible Minifigures, Disney, Lord of the Rings, Jurassic World, Indiana Jones, Minecraft, Super Mario, LEGO Movie, Speed Champions, Ideas, Simpsons, Ghostbusters, Monkie Kid, DREAMZzz, and 40+ more.

## Install

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "brickem": {
      "command": "npx",
      "args": ["-y", "brickem-mcp-server"]
    }
  }
}
```

### Claude Code

```bash
claude mcp add brickem -- npx -y brickem-mcp-server
```

### Cursor

Add to `.cursor/mcp.json` in your project or `~/.cursor/mcp.json` globally:

```json
{
  "mcpServers": {
    "brickem": {
      "command": "npx",
      "args": ["-y", "brickem-mcp-server"]
    }
  }
}
```

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "brickem": {
      "command": "npx",
      "args": ["-y", "brickem-mcp-server"]
    }
  }
}
```

### Smithery

```bash
npx -y @smithery/cli install brickem-mcp-server --client claude
```

## Usage Examples

Once installed, ask your AI assistant:

- *Send a photo of a minifigure* — "What minifigure is this and what is it worth?"
- "What is LEGO minifigure sw0002 worth?"
- "Search for Darth Vader minifigures"
- "Show me the most valuable Harry Potter minifigures"
- "I have a minifigure with a green ninja suit and golden weapons, what is it?"
- "How much are Star Wars clone trooper minifigures worth?"
- "Find all Collectible Minifigures Series figures"

## Data

- **18,000+** LEGO minifigures in the catalog
- **7,200+** with price data (used and new condition)
- Prices in USD sourced from historical marketplace data
- Covers all major LEGO themes from 1975 to present

## Development

```bash
git clone https://github.com/MichiganBricks/brickem-mcp-server.git
cd brickem-mcp-server
npm install
npm run build
```

Test locally:

```bash
npm start
```

Or with hot reload:

```bash
npm run dev
```

## About brick'em

[brick'em](https://brickem.io) is a LEGO minifigure scanner and price lookup tool. Scan your LEGO minifigures with your camera to instantly identify them and see what they're worth.

## License

MIT