gregario/lego-oracle
FreeNot checkedLEGO sets, parts, minifigs and inventories from Rebrickable: search and compare sets, find parts by colour, browse themes and discover alternate builds.
About
LEGO sets, parts, minifigs and inventories from Rebrickable: search and compare sets, find parts by colour, browse themes and discover alternate builds.
README
LEGO Oracle
LEGO sets, parts, minifigs, and inventories. An 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
npx -y lego-oracle
Add to your IDE
Claude Code
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):
{
"mcpServers": {
"lego-oracle": {
"command": "npx",
"args": ["-y", "lego-oracle"]
}
}
}
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"lego-oracle": {
"command": "npx",
"args": ["-y", "lego-oracle"]
}
}
}
VS Code (Copilot)
Add to .vscode/mcp.json:
{
"servers": {
"lego-oracle": {
"command": "npx",
"args": ["-y", "lego-oracle"]
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"lego-oracle": {
"command": "npx",
"args": ["-y", "lego-oracle"]
}
}
}
Zed
Add to settings.json:
{
"context_servers": {
"lego-oracle": {
"command": {
"path": "npx",
"args": ["-y", "lego-oracle"]
}
}
}
}
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
Installing gregario/lego-oracle
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/gregario/lego-oracleFAQ
Is gregario/lego-oracle MCP free?
Yes, gregario/lego-oracle MCP is free — one-click install via Unyly at no cost.
Does gregario/lego-oracle need an API key?
No, gregario/lego-oracle runs without API keys or environment variables.
Is gregario/lego-oracle hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install gregario/lego-oracle in Claude Desktop, Claude Code or Cursor?
Open gregario/lego-oracle on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Unyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
by UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
by blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
by Mitsubishi-FusoTemplate MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectSupabase
Database, auth and storage
by SupabaseEverything
Reference / test server with prompts, resources, and tools.
Compare gregario/lego-oracle with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
