Random Design MCP server

Random Design MCP

TypeScript MCP server that returns randomized English Markdown frontend design directions. It uses curated catalogs and optional soft compatibility scoring. It does not call an LLM.

Website: https://random-design-mcp.h0b0.dev

Install

Use the published npm package from any MCP client that supports stdio servers:

{
  "mcpServers": {
    "random-design": {
      "command": "npx",
      "args": ["-y", "random-design-mcp"]
    }
  }
}

Tools

generatedesigndescription returns one randomized Markdown design direction. All input fields are optional, but passing context makes the result easier to use:

{
  productType?: string;
  audience?: string;
  priority?: string;
  compatibility?: boolean; // defaults to true
}

mobile app, or pricing page.

• productType: what you are designing, such as landing page, dashboard,

enterprise buyers.

• audience: who the interface is for, such as developers, founders, or

such as conversion, readability, premium feel, dense data display, or playful experimentation.

• priority: what the design should optimize for or pay extra attention to,

to true, which keeps generated parameters more coherent and practical. Set it to false for unconstrained combinations that can intentionally mix clashing eras, styles, palettes, layouts, and materials.

• compatibility: controls how wild the random combination can be. It defaults

get_version takes no arguments and returns the package version from package.json. Use it to confirm which published or cached MCP package version an MCP client is running.

Development

npm install
npm run build
npm run check

Preview one generated design direction locally:

npm run dev

Optional preview context:

RANDOM_DESIGN_PRODUCT_TYPE="Landing page" \
RANDOM_DESIGN_AUDIENCE="Developers" \
RANDOM_DESIGN_PRIORITY="Conversion" \
RANDOM_DESIGN_COMPATIBILITY=false \
npm run dev