lego-oracle
LEGO Oracle is an MCP server for exploring a comprehensive LEGO catalog (26k sets, 62k parts, 17k minifigs) backed by Rebrickable data — no network calls or configuration required at runtime.
Search LEGO sets by name, theme, year range, or piece count
Get full set details including part inventory (grouped by category), minifigures, and theme hierarchy
Compare 2–4 sets side by side — piece counts, release year, theme, minifig count, and shared parts
Search for parts by name, category, colour, or material
Get part details including available colours and mold/print variants
Find which sets contain a specific part (optionally filtered by colour), sorted by quantity
Search minifigures by name and get minifig details including every set a minifigure appears in
Browse the LEGO theme hierarchy — explore top-level themes and sub-themes with set counts
Find community MOCs (alternate builds) constructible from the parts of a specific set you already own
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.
Install
npx -y lego-oracleAdd to your IDE
claude mcp add lego-oracle -- npx -y lego-oracleAdd 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 for sets by name, theme, year, or piece count. Full-text search with filters. |
| Get complete set details: inventory (grouped by part category), minifigures, theme hierarchy. |
| Compare 2-4 sets side by side: piece count, year, theme, minifigs, shared parts. |
Part Tools
Tool | Description |
| Search parts by name, category, colour, or material. |
| Get part details including available colours and mold/print variants. |
| Find which sets contain a specific part (optionally in a specific colour), sorted by quantity. |
Minifig Tools
Tool | Description |
| Search minifigures by name. |
| Get minifig details and every set it appears in. |
Discovery Tools
Tool | Description |
| Browse the LEGO theme hierarchy. Top-level themes or drill into sub-themes with set counts. |
| 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 testsTo refresh data from Rebrickable:
npm run fetch-data
npm run buildAttribution
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 toolsbrowse_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
Scored across 10 tools
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.
All tool names follow a consistent verb_noun pattern (e.g., browse_themes, compare_sets, search_parts), with lowercase and underscores throughout.
10 tools is well-scoped for a LEGO data exploration server, covering all common operations without excess or shortfall.
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
Related MCP Connectors
Provides data for LEGO sets, minifigures, parts and elements. Not affiliated with LEGO® Group.
Find LEGO sets, compare regional retailer offers, and inspect recorded retail price history.
Read-only access to your Brickway LEGO and alt-brick collection: sets, builds, figures, catalog.
UK catalogue lookups: British coin mintages, LEGO set facts, Magic cards and set checklists.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables beginner-friendly Python and Pybricks development support through RAG-powered tools that search official documentation, suggest code snippets, and provide version-aware guidance for LEGO robotics programming.1-
- AlicenseAqualityDmaintenanceLEGO 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).416 npm1MIT
- AlicenseNot gradedqualityDmaintenanceConnects the 1001 Albums Generator dataset to AI assistants, enabling natural language exploration of your listening journey, taste analysis, and group comparisons.ISC
- AlicenseAqualityCmaintenanceEnables AI assistants to search millions of electronic components and ICs, retrieve specifications, compare alternates, and submit turnkey BOM procurement requests.4MIT