`colors`

Pack: rebrickable · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/colors for the schema, then POST the same URL with its arguments for the data.

Return the complete list of LEGO colors from Rebrickable with color id, name, RGB hex code, and is_trans flag. Use to get valid color_id values for filtering parts.

Example call

Arguments

{}

curl

curl -X POST https://gateway.pipeworx.io/rebrickable/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"colors","arguments":{}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('colors', {});

Response shape

Field	Type	Description
`count`	number	Total number of colors
`next`	string \| null	URL to next page
`previous`	string \| null	URL to previous page
`results`	array	Array of color objects

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Total number of colors"
    },
    "next": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL to next page"
    },
    "previous": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL to previous page"
    },
    "results": {
      "type": "array",
      "description": "Array of color objects",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "Color ID"
          },
          "name": {
            "type": "string",
            "description": "Color name"
          },
          "rgb": {
            "type": [
              "string",
              "null"
            ],
            "description": "RGB hex code"
          },
          "is_trans": {
            "type": "boolean",
            "description": "Whether color is transparent"
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the rebrickable pack

{
  "mcpServers": {
    "rebrickable": {
      "url": "https://gateway.pipeworx.io/rebrickable/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

colors