MiniRackBuilder

Use MiniRackBuilder from your AI assistant

AI assistant buttons are hidden in the planner on this device.

MiniRackBuilder has a free MCP server. Connect it once and your AI assistant can search real 6", 7" and 10" mini racks and parts, check that a build fits, save it, and change it while you watch in the browser. No account or API key needed.

Server address

MCP server URL

Paste this wherever your app asks for a remote MCP server or connector URL. It uses Streamable HTTP and needs no sign-in.

https://minirackbuilder.com/mcp

Connect your app

Claude (claude.ai and Claude Desktop)

  1. Open Customize > Connectors (on Team or Enterprise plans an Owner adds it under Organization settings > Connectors).
  2. Choose Add, then Add custom connector.
  3. Name it MiniRackBuilder, paste the server URL above and click Continue. Keep No sign-in, then click Add.
  4. In a chat, turn it on under + > Connectors. The connector works the same in the desktop app.

Claude Code

Terminal

Add --scope user to use it in every project. Run /mcp inside Claude Code to check that it connected.

claude mcp add --transport http minirackbuilder https://minirackbuilder.com/mcp

ChatGPT

  1. On chatgpt.com, open Plugins, choose + and then Add custom MCP server. On some plans this is under Settings > Apps after turning on Developer mode.
  2. Enter the name MiniRackBuilder and the server URL above, and choose No authentication.
  3. Confirm the warning, create it, and turn it on in the chat where you want to use it.

Custom MCP servers are only offered on some ChatGPT plans, and OpenAI renames these menus from time to time.

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project)
{
  "mcpServers": {
    "minirackbuilder": {
      "url": "https://minirackbuilder.com/mcp"
    }
  }
}

VS Code (GitHub Copilot agent mode)

.vscode/mcp.json

Or run MCP: Add Server from the Command Palette, choose HTTP and paste the server URL. Note the key is servers, not mcpServers.

{
  "servers": {
    "minirackbuilder": {
      "type": "http",
      "url": "https://minirackbuilder.com/mcp"
    }
  }
}

opencode

Terminal

Run opencode mcp list to check that it connected. To add it by hand instead, put {"type": "remote", "url": "https://minirackbuilder.com/mcp", "oauth": false} under mcp.servers.minirackbuilder in your opencode config. Older opencode versions put the name directly under mcp.

opencode mcp add minirackbuilder --url https://minirackbuilder.com/mcp

Other apps

Any app that supports remote MCP servers over Streamable HTTP can use the server URL above. Apps that only run local servers cannot connect to it.

What to expect

Example prompt

Paste into your assistant
Using the MiniRackBuilder MCP server, plan an 8U 10-inch homelab rack with a 2.5GbE PoE switch, a mini PC running Proxmox, a patch panel and a PDU. Check that everything fits the rack depth and the power budget, save it, and give me the link.

Tools the assistant can use

ToolWhat it doesMain inputs
search_racksFind rack enclosures by height, width (6, 7, 10 or 19 inch), depth or keyword, with current prices.query, format, min_u, max_u, min_depth_mm, max_depth_mm, region, limit
search_partsFind switches, mini PCs, PDUs, patch panels, shelves, PCIe cards and accessories that fit.query, category, format, max_u, max_depth_mm, has_poe, region, limit
get_part_detailsFull specs and price for up to 10 parts: size, ports, power, drive bays, mounting options.slugs or slug, region
search_catalog_extrasList 3D-printable mounts, starter builds and community parts.kind, query, limit
validate_buildCheck a build without saving it: overlaps, rack width and depth, shelves, power, cables.rack, slots, rear_slots, cables, extras, …
create_buildSave a new build. It is Unlisted (link only) unless you ask the assistant to make it Public in catalog.rack, slots, title, visibility, …
update_buildChange a saved build with its edit key. Only the parts it sends change, and open browser tabs in live mode update right away.build_id, edit_token, base_rev, visibility, …
get_buildRead a saved build and its current revision. Never shows the edit key.build_id
delete_buildDelete a build for good, only when you ask for it.build_id, edit_token
render_rack_previewDraw the rack as a picture so the assistant can check its own work.build_id or build, view, theme

Rack pictures for READMEs and docs

Every saved build has a picture at https://minirackbuilder.com/b/<id>/rack.png that follows the latest version of the build. Options:

HTML that follows the reader's dark or light mode

Replace <id> with your build ID. Your build page has buttons that copy this with the ID filled in.

<a href="https://minirackbuilder.com/b/<id>">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://minirackbuilder.com/b/<id>/rack.png?theme=dark">
    <img alt="My rack" src="https://minirackbuilder.com/b/<id>/rack.png?theme=light" width="680">
  </picture>
</a>

Troubleshooting

For developers: /.well-known/mcp.json · /llms.txt