All AI app guides

Developer agents

Connect Codex to Brickmaster

Add Brickmaster as a Streamable HTTP server in Codex, then authenticate once through its MCP server controls.

Set up Codex

Brickmaster remote MCP server

https://api.brickmaster.app/mcp
  1. In the ChatGPT desktop app or Codex IDE extension, open Settings → MCP servers → Add server. Choose Streamable HTTP, name it Brickmaster, and enter the URL below. Save and restart when prompted.
  2. Select Authenticate for Brickmaster. In Codex CLI, the equivalent action is `codex mcp login brickmaster` after adding the configuration below.
  3. Complete Brickmaster sign-in, select one or more collections, and choose one default.
  4. Use /mcp to confirm the server is connected, then ask Codex a collection question.

~/.codex/config.toml

[mcp_servers.brickmaster]
url = "https://api.brickmaster.app/mcp"

What happens during authorization

The AI app opens Brickmaster in your browser. Brickmaster shows the requesting application and its exact return address, then asks you to sign in and choose which collections it may read. The AI app receives a Brickmaster-only MCP credential—never your Brickmaster sign-in token or Supabase session.

Never paste an API key, Supabase token, Brickmaster session, client secret, or custom Authorization header into the AI app. A compatible host discovers Brickmaster's public OAuth flow from the server URL.

What Codex can ask

  • List only the collections you selected when connecting
  • Summarize sets, minifigures, ownership, build states, brands, and locations
  • Search your collection and inspect one item's safe catalog and build context
  • Find duplicate copies and collectible-minifigure series gaps
  • Compare LEGO theme progress and review bounded build history
  • Search Brickmaster's global LEGO and alt-brick set catalog

Prompts to try

  • Do I own Rivendell, and how many copies do I have?
  • Which sealed sets under 1,000 pieces could I build this weekend?
  • Show my duplicate sets and loose minifigures.
  • Which LEGO themes am I closest to completing?
  • Summarize what I built this year and how long it took.

Change access or disconnect

In Brickmaster, open Settings → AI connections. You can change this app's selected collections, disconnect it, or disconnect every AI app. Brickmaster revocation takes effect immediately even if Codex still displays the old connection.

The AI app processes tool inputs and results under its own terms, retention, and training policies. Brickmaster excludes email addresses, household members, prices paid, sellers, acquisition sources, private notes, OAuth details, and internal database fields. The connector cannot add, edit, or delete anything. Read Brickmaster's privacy policy for details.