# gregario/lego-oracle [Health: Active]

**Category:** 🧠 Knowledge & Memory  
**Repository:** https://github.com/gregario/lego-oracle  
**GitHub Stars:** 3  
**npm Downloads (last month):** 297  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gregario-lego-oracle

## Description
LEGO sets, parts, minifigs, colours, and inventories from Rebrickable. 10 tools for searching sets, finding parts by colour, browsing themes, comparing sets, and discovering MOC alternate builds. 26k sets, 62k parts, 17k minifigs embedded.

## Tools
Capabilities this server exposes over MCP:

- **search_sets** — Search for sets by name, theme, year, or piece count. Full-text search with filters.
- **get_set** — Get complete set details: inventory (grouped by part category), minifigures, theme hierarchy.
- **compare_sets** — Compare 2-4 sets side by side: piece count, year, theme, minifigs, shared parts.
- **search_parts** — Search parts by name, category, colour, or material.
- **get_part** — Get part details including available colours and mold/print variants.
- **find_part_in_sets** — Find which sets contain a specific part (optionally in a specific colour), sorted by quantity.
- **search_minifigs** — Search minifigures by name.
- **get_minifig** — Get minifig details and every set it appears in.
- **browse_themes** — Browse the LEGO theme hierarchy. Top-level themes or drill into sub-themes with set counts.
- **find_mocs** — Find community alternate builds (MOCs) for a set's parts.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "lego-oracle": {
    "command": "npx",
    "args": ["-y","lego-oracle"]
  }
}
```

## Documentation

## What gregario/lego-oracle MCP server does

The gregario/lego-oracle MCP server gives an MCP-compatible client structured access to LEGO catalog data sourced from Rebrickable. Its dataset includes 26,339 sets, 61,702 parts, 275 colours, 16,646 minifigures, more than 1.4 million inventory entries, 35,757 part relationships, and 490 themes. The project is distributed under the MIT license.

Set queries can use names, themes, years, or piece counts. A set lookup returns inventory grouped by part category, minifigures, and its position in the theme hierarchy. Set comparison accepts two to four sets and reports differences such as piece count, release year, theme, minifigures, and shared parts.

Part-focused queries support names, categories, colours, and materials. Individual part records include available colours and mold or print variants, while inventory searches identify sets containing a part and can restrict results to a colour. Minifigure searches work by name and can return every set containing a selected figure.

## How it works

The catalog is embedded during the build rather than fetched for each request. As a result, the server does not make network calls at runtime and does not require a Rebrickable API key. Rebrickable data is refreshed daily through GitHub Actions, and new npm releases are published when the source data changes.

Discovery tools cover the LEGO theme hierarchy and community alternate builds. Theme browsing can start at top-level themes or continue into sub-themes with set counts. MOC searches find alternate models that use the parts from a specified set.

## Setup and configuration

The documented installation uses Node.js 18 or newer and the npm package:

```bash
npx -y lego-oracle
```

The server is configured as a local stdio MCP process. For Claude Desktop, Cursor, and Windsurf, the README shows an MCP entry using `npx` with `-y lego-oracle` as the arguments. No environment variables, credentials, or additional runtime configuration are documented.

For development, the repository uses `npm install`, `npm run build`, and `npm test`. The test command is documented as running 141 tests. Refreshing the source data requires `npm run fetch-data` followed by `npm run build`.

## Tools and capabilities

The gregario/lego-oracle MCP server exposes these ten tools:

- `search_sets`, `get_set`, and `compare_sets` for set discovery, details, and side-by-side analysis.
- `search_parts`, `get_part`, and `find_part_in_sets` for part and colour-based catalog queries.
- `search_minifigs` and `get_minifig` for minifigure searches and appearance history.
- `browse_themes` for navigating themes and sub-themes.
- `find_mocs` for locating community alternate builds based on a set’s parts.

## Limitations and notes

The server’s information is limited to the embedded Rebrickable catalog and its update schedule. Because data is packaged at build time, a newly changed catalog may require a newer npm release before it appears in results. The project states that LEGO is a trademark of the LEGO Group and that the project is not produced or endorsed by LEGO.

The gregario/lego-oracle MCP server is intended for catalog lookup and discovery. The supplied material does not document purchasing, inventory ownership, prices, set instructions, or live availability features.

_Full upstream README: https://allmcps.com/mcp/gregario-lego-oracle/readme_