Lego Oracle

io.github.gregarioPublished by GitHub account gregariov0.1.1Updated Oct 25, 2026

LEGO sets, parts, minifigs, and inventories as an MCP server

VerifiedSTDIODesktop onlyKnowledge & MemoryData & Analytics

Overview

AI-generated overview

A local MCP server that gives an assistant an offline LEGO catalog of sets, parts, minifigures and themes for searching, lookups and comparisons.

What you can do
Search sets by name, theme, year or piece count, and get full set details with inventory, minifigures and theme hierarchy, or compare two to four sets side by side. Search parts by name, category, colour or material, get part details with colours and variants, and find which sets contain a given part. Search minifigures and get their details plus every set they appear in. Browse the LEGO theme hierarchy and find community alternate builds for a set's parts.
When to use it
Useful when you want an assistant to answer LEGO questions from a real catalog rather than guesses: identifying a set, checking what is in it, finding a brick, looking up a minifigure, or comparing sets before buying or building.
Requirements
Runs locally as an npm package via npx, so Node.js is needed. No configuration, accounts, API keys or environment variables are declared, and the README says data is embedded at build time with no network calls at runtime. Desktop MCP clients only.
Before you install
The catalog is a snapshot embedded at build time and refreshed by new package versions, so very recent sets may be missing. Data comes from Rebrickable, and the project states it is not produced or endorsed by the LEGO Group. Tools are read-only lookups; no credentials or payments are involved.

Installation

In SourceWeft

  1. Open Lego Oracle in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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]


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

bash
npx -y lego-oracle

Add to your IDE

Claude Code
bash
claude mcp add lego-oracle -- npx -y lego-oracle
Claude Desktop

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

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

Add to .cursor/mcp.json:

json
{  "mcpServers": {    "lego-oracle": {      "command": "npx",      "args": ["-y", "lego-oracle"]    }  }}
VS Code (Copilot)

Add to .vscode/mcp.json:

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

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

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

Add to settings.json:

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

Tools

Set Tools

ToolDescription
search_setsSearch for sets by name, theme, year, or piece count. Full-text search with filters.
get_setGet complete set details: inventory (grouped by part category), minifigures, theme hierarchy.
compare_setsCompare 2-4 sets side by side: piece count, year, theme, minifigs, shared parts.

Part Tools

ToolDescription
search_partsSearch parts by name, category, colour, or material.
get_partGet part details including available colours and mold/print variants.
find_part_in_setsFind which sets contain a specific part (optionally in a specific colour), sorted by quantity.

Minifig Tools

ToolDescription
search_minifigsSearch minifigures by name.
get_minifigGet minifig details and every set it appears in.

Discovery Tools

ToolDescription
browse_themesBrowse the LEGO theme hierarchy. Top-level themes or drill into sub-themes with set counts.
find_mocsFind community alternate builds (MOCs) for a set's parts.

Data

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

CategoryCount
Sets26,339
Parts61,702
Colours275
Minifigures16,646
Inventory entries1,483,652
Part relationships35,757
Themes490

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

Development

bash
npm installnpm run buildnpm test             # 141 tests

To refresh data from Rebrickable:

bash
npm run fetch-datanpm 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

Source: README.md at commit ef4087e

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts