lego-oracle is an MCP (Model Context Protocol) server used to connect LEGO data to AI programming/conversation environments that support MCP. Its data comes from the Rebrickable catalog, and it is officially said to cover about 26,000 sets, 62,000 parts, and 17,000 minifigures, with the goal of letting AI assistants answer based on a real catalog rather than generating information out of thin air.
Uses: ask an AI assistant for LEGO set information, find specific bricks, query minifigures, browse themes, and compare different sets.
Main capabilities: provides 10 tools covering data types such as sets, parts, minifigures, and lists; zero configuration; compatible with all IDEs that support MCP. Data is embedded at build time, so no network requests are needed at runtime; data is updated daily via GitHub Actions, and when Rebrickable data changes, a new npm version is automatically published.
How to use: add the server to the IDE's MCP configuration file. The configuration locations given in the material include: ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%/Claude/claude_desktop_config.json on Windows, .cursor/mcp.json, .vscode/mcp.json, ~/.codeium/windsurf/mcp_config.json, and settings.json. The material does not provide the specific configuration file contents or data refresh commands, and only mentions that Rebrickable data can be refreshed.
Attribution note: data comes from Rebrickable; LEGO is a trademark of the LEGO Group, and this project is not made or endorsed by the LEGO Group.
