gregario avatar

Lego Oracle

gregario/lego-oracle

Gives your AI assistant direct access to Rebrickable's complete LEGO catalog: 26k sets, 62k parts, 17k minifigs, all embedded at build time so there's no runtime API needed. You get ten tools covering search, comparison, and lookup across sets, parts, and minifigures. Search for sets by theme or year, find which sets contain a specific brick in a specific color, compare multiple sets side by side to see shared parts, or look up minifig appearances. The browse_themes tool lets you navigate LEGO's theme hierarchy, and find_mocs surfaces community alternate builds. Useful when you're cataloging a collection, hunting down replacement parts, or just answering "which sets have that piece" without hallucinations.

GitHub stars
1
tools
10
transport
STDIO
last updated
Mar 15, 2026

Tools

10 tools

Public tool metadata for what this MCP can expose to an agent.

search_setsSearch for sets by name, theme, year, or piece count. Full-text search with filters.

Search for sets by name, theme, year, or piece count. Full-text search with filters.

No parameter schema in public metadata yet.

get_setGet complete set details: inventory (grouped by part category), minifigures, theme hierarchy.

Get complete set details: inventory (grouped by part category), minifigures, theme hierarchy.

No parameter schema in public metadata yet.

compare_setsCompare 2-4 sets side by side: piece count, year, theme, minifigs, shared parts.

Compare 2-4 sets side by side: piece count, year, theme, minifigs, shared parts.

No parameter schema in public metadata yet.

search_partsSearch parts by name, category, colour, or material.

Search parts by name, category, colour, or material.

No parameter schema in public metadata yet.

get_partGet part details including available colours and mold/print variants.

Get part details including available colours and mold/print variants.

No parameter schema in public metadata yet.

find_part_in_setsFind which sets contain a specific part (optionally in a specific colour), sorted by quantity.

Find which sets contain a specific part (optionally in a specific colour), sorted by quantity.

No parameter schema in public metadata yet.

search_minifigsSearch minifigures by name.

Search minifigures by name.

No parameter schema in public metadata yet.

get_minifigGet minifig details and every set it appears in.

Get minifig details and every set it appears in.

No parameter schema in public metadata yet.

browse_themesBrowse the LEGO theme hierarchy. Top-level themes or drill into sub-themes with set counts.

Browse the LEGO theme hierarchy. Top-level themes or drill into sub-themes with set counts.

No parameter schema in public metadata yet.

find_mocsFind community alternate builds (MOCs) for a set's parts.

Find community alternate builds (MOCs) for a set's parts.

No parameter schema in public metadata yet.

Sponsors

Readme

LEGO Oracle

LEGO sets, parts, minifigs, and inventories. An MCP server.

npm version npm downloads MIT Licence Node.js 18+ MCP Compatible lego-oracle MCP server



View the full README on GitHub

Details

Repository
github.com/gregario/lego-oracle
Package
lego-oracle
Transport
STDIO
Registry
MCP registry, active

More from gregario