Frequently Asked Questions

General Questions

What is Brick Directory?

Brick Directory is an AI-powered service that makes LEGO information instantly accessible. You can chat with our AI assistant to get information about LEGO sets, parts, minifigures, and pricing, or integrate LEGO data into your own AI assistant using our MCP server.

Is Brick Directory affiliated with LEGO?

No. Brick Directory is an independent project and is not affiliated with, sponsored by, or endorsed by the LEGO Group. LEGO® is a trademark of the LEGO Group.

Is Brick Directory free to use?

Yes! Brick Directory is currently free to use. We’re in beta and focused on building the best LEGO data experience possible.

Where does your data come from?

We use data from three primary sources:

We’re grateful to these services for making their data available.

Using Brick Directory

How do I use the chat interface?

  1. Visit chat.brick.directory
  2. Sign in with your Google or Facebook account (we don’t store passwords!)
  3. Start asking questions in plain English!

Example questions:

What kind of questions can I ask?

You can ask about:

Is my chat history saved?

Yes, your chat history is saved by default so you can refer back to previous conversations.

Can I delete my chat history?

Yes! You can delete individual messages one by one.

How do I connect my Rebrickable account?

To enable advanced features like collection management and build analysis:

  1. Click your avatar in the top-right of the chat interface
  2. Click the Settings item in the account menu
  3. Scroll to the Rebrickable Integration section
  4. Click Setup Guide
  5. Follow the guided tutorial
  6. Click Save Credentials

Security Note: Your password is sent directly to Rebrickable.com via client-side authentication in your browser and never touches our servers. We only store the user token returned by Rebrickable to access your collection data.

You can disconnect your Rebrickable account at any time by removing the credentials in Settings.

Don’t have a Rebrickable account? Visit rebrickable.com to create a free account.

How do I connect my Brickset account?

To enable Brickset collection and wishlist management:

  1. Click your avatar in the top-right of the chat interface
  2. Click the Settings item in the account menu
  3. Scroll to the Brickset Integration section
  4. Click Setup Guide
  5. Follow the 4-step wizard:

Security Note: Your password is sent via our backend proxy to Brickset.com and immediately discarded after obtaining your user hash. We only store your API key and user hash (both encrypted with AES-256). Your password is never stored in our system.

You can disconnect your Brickset account at any time by removing the credentials in Settings.

Don’t have a Brickset account? Visit brickset.com to create a free account.

Can I use both Rebrickable and Brickset?

Yes! You can connect both services simultaneously. Each service offers different features:

When you ask to “add to my collection” without specifying which service, the AI will ask whether you want to add to Rebrickable, Brickset, or both.

MCP Integration

What is MCP?

MCP (Model Context Protocol) is a standard protocol that allows AI assistants to access external data sources. With MCP, you can integrate Brick Directory directly into Claude Desktop, ChatGPT, Gemini, and other AI assistants.

How do I set up MCP integration?

Follow our detailed setup guide: MCP Setup Guide

The basic steps are:

  1. Install an MCP-compatible AI assistant (e.g., Claude Desktop)
  2. Configure the Brick Directory MCP server
  3. Start asking LEGO questions directly in your AI assistant!

Which AI assistants support MCP?

MCP is supported by:

Why should I use MCP instead of the web chat?

MCP allows you to use your preferred AI assistant with Brick Directory data, giving you more flexibility and control. You can combine LEGO data with other knowledge sources and workflows as well as other MCP servers. For example, you can ask your AI assistant to read the list of your sets from Google Drive and then ask for more information about those sets.

Account & Privacy

Do I need an account?

What information do you collect?

We collect:

See our Privacy Policy for full details.

Is my data secure?

Yes. We use industry-standard security:

How do I delete my account?

Contact us at support@brick.directory with your account deletion request. We’ll delete your account and associated data within 30 days.

Do you comply with GDPR and CCPA?

Yes. We comply with both GDPR (EU) and CCPA (California) regulations. You have the right to access, correct, or delete your data at any time.

Technical Questions

Why isn’t the AI giving me accurate answers?

AI responses are generally accurate but not perfect. If you encounter inaccurate information:

  1. Try rephrasing your question
  2. Be more specific (e.g., include set numbers)
  3. Use the in-app feedback feature to report response issues directly in the chat
  4. For general questions, visit our discussion forum

We continuously improve our AI’s accuracy based on user feedback.

Why is pricing information sometimes outdated?

Pricing data is sourced from BrickLink and is updated regularly, but market prices change frequently. For critical purchasing decisions, we recommend verifying prices directly on BrickLink.

Can I use Brick Directory for commercial purposes?

Currently, Brick Directory is intended for personal use. If you’d like to use it for commercial purposes, please contact us at hello@brick.directory to discuss licensing.

Is there an API?

The MCP server effectively functions as an API. For direct API access or bulk data needs, please contact us at hello@brick.directory.

Why is the service sometimes slow?

We’re working on performance improvements! Slowness can occur due to:

We’re continuously optimizing performance.

Data & Content

How often is the data updated?

Can I suggest missing features?

Absolutely! We welcome feature requests:

The discussion forum is the best place to share ideas and see what other users are requesting!

Do you have information about unofficial LEGO-compatible brands?

Currently, we focus exclusively on official LEGO products. We may expand to compatible brands in the future.

Troubleshooting

I can’t log in

Try these steps:

  1. Make sure you’re using the correct Google or Facebook account
  2. Check if you’re already signed in to the OAuth provider in your browser
  3. Clear your browser cookies and cache
  4. Try signing out of all accounts and signing in again
  5. Try a different browser or incognito/private mode
  6. Still stuck? Ask for help in our discussion forum

The chat isn’t responding

  1. Check your internet connection
  2. Refresh the page
  3. Try logging out and back in
  4. Check if we’re experiencing an outage in our discussion forum

MCP integration isn’t working

Common issues:

See the MCP Setup Guide for detailed troubleshooting.

I found a bug!

Thank you for helping us improve! Please report bugs:

Include:

For issues with AI responses: Use the in-app feedback feature in the chat interface.

Pricing & Billing

Is Brick Directory really free?

Yes! Brick Directory is currently free during our beta period. We may introduce premium features in the future, but we’re committed to keeping core functionality free.

Will you always be free?

Our goal is to keep Brick Directory free for personal use. We may introduce:

But core LEGO data access will remain free.

What are your Terms of Service?

Read our full Terms of Service.

Key points:

Can I redistribute data from Brick Directory?

No. Data from Rebrickable and BrickLink is subject to their terms of service. You should access data through Brick Directory for personal use, not for redistribution.

Still Have Questions?

We’re here to help!

Didn’t find your answer? Contact us and we’ll help you out!