# Rebrickable LEGO MCP for AI Agents AI Agent Connect > Rebrickable LEGO MCP lets you query the entire LEGO universe through your agent. Search for specific sets, parts, minifigures, themes, and colors with full catalog data from any AI agent. It turns your agent into a dedicated LEGO archivist, making it easy to find specific parts for custom builds, check color availability for bricks, and browse the official catalog for inspiration without leaving your chat interface. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_hjVsq0Mams0ZwRWzCcC6X9UK0wrJx6IOaxJWby3h/ai-agent-connect - **Tags:** lego, catalog-data, hobbyist, parts-database, inventory-tracking ## Description This LEGO catalog connector links to the official database to let you explore the entire universe through natural conversation. It turns your agent into a dedicated LEGO archivist, making it easy to find specific parts for custom builds or browse the official catalog for inspiration without leaving your workspace. Instead of jumping between different browser tabs to search for part numbers or check color availability, you can simply ask your agent to do the heavy lifting. It is a huge time-saver when you are deep into a custom build and need to know exactly which pieces are in a specific set or if a certain brick exists in a specific color. Because Vinkius hosts this Connector, you can connect it to your favorite tools and start querying the LEGO ecosystem immediately. It handles the data retrieval so you can stay in your creative flow. Whether you are looking for specific themes, piece counts, or detailed inventories, the information is always just a prompt away. You can quickly verify if a part is a spare or part of the main assembly, ensuring your build is accurate every time. It removes the friction of manual data entry and catalog navigation, letting you focus on the actual assembly. ## Tools ### list_sets Use list_sets to search LEGO sets filtered by theme, year, or part number. It returns a clean list of sets matching your criteria. ### get_minifig Use get_minifig to get the name, theme, year, and image URLs for a specific LEGO minifigure. It helps you identify characters and their associated sets quickly. ### get_set_parts Use get_set_parts to pull the full parts inventory for a set, including quantities and spare parts. This gives you a complete piece breakdown. ### get_theme Use get_theme to get the name, parent theme, and set count for a specific LEGO theme. It helps you understand the theme hierarchy. ### list_themes Use list_themes to list all LEGO themes and sub-themes with their IDs and set counts. This gives you a broad overview of the catalog. ### get_part Use get_part to retrieve the name, category, and available colors for a specific LEGO part number. This is great for verifying part details. ### get_part_colors Use get_part_colors to see which color IDs and names are available for a specific part. It is essential for matching colors in custom builds. ### get_set Use get_set to get the name, year, theme, and piece count for a specific LEGO set. This provides a quick snapshot of any set's data. ### list_colors Use list_colors to get a full list of LEGO colors including IDs, names, and RGB values. This is useful for consistent color planning. ### list_minifigs Use list_minifigs to search and list LEGO minifigures with filters for part numbers and pagination. It makes finding specific characters easy. ### list_parts Use list_parts to search the catalog for LEGO parts using filters for part number patterns. This helps you find the right pieces quickly. ## Prompt Examples **Prompt:** ``` What's inside LEGO set 75192? ``` **Response:** ``` The Millennium Falcon (75192-1) contains a massive inventory of parts. - **Piece Count**: 921 - **Minifigure Count**: 10 - **Key Components**: Includes various slopes, tiles, and specialized pieces. *Note: For a full breakdown of every individual part number and quantity, just let me know and I can pull the complete list.* ``` **Prompt:** ``` Is there a 2x4 brick in Dark Blue? ``` **Response:** ``` Yes, the 2x4 brick (Part 3001) is available in **Dark Blue** (ID: 140). It is also available in several other colors, including: - **Dark Green** (137) - **Light Bluish Gray** (86) - **Dark Red** (59) - **Yellow** (14) ``` **Prompt:** ``` List some Star Wars sets from 2023. ``` **Response:** ``` Here are some notable Star Wars sets from 2023: | Set Number | Name | Piece Count | | :--- | :--- | :--- | | 75350 | Droid Army | 450 | | 75331 | Luke Skywalker's X-Wing | 1,300 | | 75344 | Darth Vader's TIE Advanced | 1,200 | *Would you like more details on any of these?* ``` ## Capabilities ### Pull complete parts lists Get a full breakdown of every piece, quantity, and spare part for any specific LEGO set. ### Search the official parts catalog Find specific bricks, tiles, and elements using part numbers or general descriptions. ### Find specific minifigures Retrieve names, themes, years, and image URLs for specific LEGO characters. ### Browse all LEGO themes Explore the entire hierarchy of LEGO themes and sub-themes with set counts. ### Check part color availability See which colors a specific part is available in for accurate MOC building. ### List all LEGO colors Get a full list of official LEGO colors including IDs, names, and RGB values. ## Use Cases ### Verifying part colors for a custom build A builder wants to know if a 2x4 brick exists in Dark Blue. Ask your agent to use get_part_colors on part 3001 to see the full list of available IDs and names. ### Finding sets from a specific year A collector wants to see every Star Wars set from 2023. Use list_sets with year and theme filters to get a clean list of every release from that period. ### Checking a set's piece inventory A user wants to see what's inside a specific set. Use get_set_parts for set 10497 to get a full breakdown of pieces, quantities, and spare parts. ### Locating a specific minifigure A fan wants to find a specific character. Use get_minifig to pull the theme, piece count, and image URLs for a specific character. ## Benefits - Stop manual searching. Use get_set_parts to see exactly what's in a set without opening extra tabs. - Precise part discovery. Use get_part to find specific bricks and see every color they come in. - Faster MOC planning. Use list_colors and get_part_colors to match your vision to real LEGO availability. - Theme exploration. Use list_themes to quickly see how many sets exist in a specific category. - Minifigure hunting. Use list_minifigs to find specific characters across the entire catalog. ## How It Works The bottom line is you get a direct line to the Rebrickable database without leaving your chat interface. 1. Subscribe to the Rebrickable LEGO MCP on Vinkius. 2. Enter your Rebrickable API Key into your client configuration. 3. Ask your agent to find sets, parts, or inventories. ## Frequently Asked Questions **How can I use Rebrickable LEGO to find parts for my custom build?** You can ask your agent to search the entire LEGO parts catalog. It will find specific part numbers, categories, and every color that part is available in so you can plan your build accurately. **Can the Rebrickable LEGO MCP tell me what's inside a specific set?** Yes. You can ask for the parts inventory of any set number. It will return a complete list of every piece, including the quantity of each and any spare parts included. **Does the Rebrickable LEGO MCP include minifigure details?** It does. Your agent can pull names, themes, years, and image URLs for specific minifigures, helping you track down the exact characters you need. **Can I use Rebrickable LEGO to see all available LEGO colors?** Yes, the Connector can list every color in the LEGO catalog. It provides the color IDs, names, and RGB values for all official colors. **How do I find all sets for a specific theme?** Just ask your agent to list sets for a specific theme or year. It will browse the catalog and return the set numbers, names, and piece counts for you. **Is Rebrickable LEGO good for finding sub-themes?** Yes, it can list all LEGO themes and their sub-themes. This is great for seeing how different categories are organized within the larger LEGO universe. **How do I get a Rebrickable API key?** Visit [**rebrickable.com/api**](https://rebrickable.com/api/), sign in with your Rebrickable account, and your API key will be displayed on the page. Copy it — it's a long alphanumeric string. **Can I search for sets by theme?** Yes! Use `list_sets` with `theme_id` to filter by theme. First use `list_themes` to find the theme ID (e.g. Star Wars = 170), then pass it to list_sets. You can also filter by year or part number. **Can I see the parts inventory for a set?** Yes! Use `get_set_parts` with the set number (e.g. "75192-1" for the Millennium Falcon). Returns every part with its part number, color ID, quantity and whether it's a spare. Set inc_minifig_parts to true to include minifig parts. **How many results can I get at once?** The API supports up to 1000 results per request. Use the `page_size` parameter (max 1000, default 100) and `page` for pagination. The total count and next/previous URLs are returned in each response.