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 mcp add lego-oracle -- npx -y lego-oracle

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

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

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

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

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

Tools

Set Tools

Part Tools

Minifig Tools

Discovery Tools

Data

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

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