Skip to main content
Glama
lego-oracle

lego-oracle


Ask your AI assistant about LEGO sets, find specific bricks, look up minifigures, browse themes, and compare sets. All backed by Rebrickable's catalog (26k sets, 62k parts, 17k minifigs), not hallucinations.

10 tools. Zero config. Works with every MCP-compatible IDE.

lego-oracle MCP server gregario/lego-oracle MCP server

Install

npx -y lego-oracle

Add to your IDE

claude mcp add lego-oracle -- npx -y lego-oracle

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

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

Add to .cursor/mcp.json:

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

Add to .vscode/mcp.json:

{
  "servers": {
    "lego-oracle": {
      "command": "npx",
      "args": ["-y", "lego-oracle"]
    }
  }
}

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

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

Add to settings.json:

{
  "context_servers": {
    "lego-oracle": {
      "command": {
        "path": "npx",
        "args": ["-y", "lego-oracle"]
      }
    }
  }
}

Related MCP server: brickem-mcp-server

Tools

Set Tools

Tool

Description

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.

Part Tools

Tool

Description

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.

Minifig Tools

Tool

Description

search_minifigs

Search minifigures by name.

get_minifig

Get minifig details and every set it appears in.

Discovery Tools

Tool

Description

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.

Data

All data is embedded at build time from Rebrickable. No network calls at runtime.

Category

Count

Sets

26,339

Parts

61,702

Colours

275

Minifigures

16,646

Inventory entries

1,483,652

Part relationships

35,757

Themes

490

Data is updated daily via GitHub Actions. New npm versions are published automatically when Rebrickable data changes.

Development

npm install
npm run build
npm test             # 141 tests

To refresh data from Rebrickable:

npm run fetch-data
npm run build

Attribution

Data from Rebrickable. LEGO is a trademark of the LEGO Group. This project is not produced by or endorsed by the LEGO Group.

License

MIT

Available Tools

10 tools
browse_themesA

Browse the LEGO theme hierarchy. With no input, returns all top-level themes with set counts. With a theme name, returns its sub-themes and sets. Use this to explore what LEGO themes exist or drill into a specific theme.

Inputs: theme.

compare_setsA

Compare 2 to 4 LEGO sets side by side. Shows piece count, year, theme, minifig count, and shared parts between sets. Use this when someone is deciding between sets or wants to know what parts overlap.

Inputs: set_nums (required).

find_mocsA

Find community alternate builds (MOCs) that can be made from a specific LEGO set's parts. Use this when someone wants to know what else they can build with parts they already own.

Inputs: set_num (required).

find_part_in_setsA

Find which LEGO sets contain a specific part, optionally in a specific colour. Use this when a builder wants to know where to source a particular brick. Results sorted by quantity (most pieces first).

Inputs: part_num (required), color, limit.

get_minifigA

Get complete details for a specific LEGO minifigure including every set it appears in. Use this when you know a minifig name or fig number and want to find which sets include it.

Inputs: name, fig_num.

get_partA

Get complete details for a specific LEGO part including available colours and mold/print variants. Use this when you know a part number (like 3001) and need its specifications, colour availability, or related parts.

Inputs: part_num (required).

get_setA

Get complete details for a specific LEGO set including piece inventory, minifigures, and theme. Use this when you know a set number (like 75192-1) or set name and need full information. Returns inventory grouped by part category.

Inputs: name, set_num.

search_minifigsA

Search for LEGO minifigures by name. Use this when looking for specific characters or minifig types. Returns fig numbers and names: use get_minifig for full details and set appearances.

Inputs: query (required), limit.

search_partsA

Search for LEGO parts by name, category, colour, or material. Use this when looking for specific brick types, plates, tiles, or other elements. Returns part numbers and names: use get_part for full details.

Inputs: color, limit, query, category, +1 more.

search_setsA

Search for LEGO sets by name, theme, year, or piece count. Use this when looking for sets matching specific criteria. Returns a summary list: use get_set for full details on a specific set.

Inputs: limit, query, theme, year_max, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool targets a distinct function: browsing themes, comparing sets, finding alternate builds, searching/getting parts/minifigs/sets. The search/get pairing is clear and avoids ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., browse_themes, compare_sets, search_parts), with lowercase and underscores throughout.

    Tool Count5/5

    10 tools is well-scoped for a LEGO data exploration server, covering all common operations without excess or shortfall.

    Completeness5/5

    The tool surface covers all essential workflows: browsing themes, searching and retrieving details for sets/parts/minifigs, comparing sets, and finding alternate builds. No obvious gaps.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      LEGO minifigure price lookup and identification. Search 18,000+ minifigs by name, theme, or description. Prices for used and new condition. Powered by brick'em (brickem.io).
      4
      16 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to search millions of electronic components and ICs, retrieve specifications, compare alternates, and submit turnkey BOM procurement requests.
      4
      MIT