Design Lounge MCP

What design-lounge-mcp does

design-lounge-mcp gives an AI agent access to the Design Lounge catalogue, a design library containing interface pieces, palettes, type pairings, icons, motion recipes, and starter recipes for common product types. The server also installs the Design Lounge skill, which guides an agent toward a consistent visual system rather than inventing unrelated colours, fonts, or component styles across screens.

Its MCP-specific capabilities extend beyond the static skill files. Agents can search the library with visual references for pieces, themes, and pairings; select a design direction deterministically so repeated runs stay consistent; and review a page produced by the agent. Reviews examine AI-generated design signals, divergence from the selected kit, accessibility, and search or answer visibility across SEO, AEO, and GEO. The review can include laptop- and phone-sized screenshots.

How it works

The local package runs as a command-line MCP server through npx. A compatible client starts it with the design-lounge-mcp@latest package, and the server reads the bundled Design Lounge skill and library. After the first start, the client should be reloaded so it detects the installed skill.

For screenshot-based reviews, the agent should run install_browser once. The local server can work with project files and can retain the context needed by the local workflow. The project also exposes a hosted MCP endpoint at https://www.designlounge.live/api/mcp for clients that cannot run a local process. That endpoint provides the library and can review public URLs.

Setup and configuration

In Claude Code, add the server with:

claude mcp add design-lounge --scope user -- npx -y design-lounge-mcp@latest

Other MCP clients can use an equivalent stdio configuration:

{
  "mcpServers": {
    "design-lounge": {
      "command": "npx",
      "args": ["-y", "design-lounge-mcp@latest"]
    }
  }
}

The README names Cursor, Windsurf, Claude Desktop, VS Code, and Codex as clients that can use this configuration. Claude.ai, ChatGPT, and other clients that cannot launch local programs can connect to the hosted URL as a custom connector.

The separate skill installer requires Node.js 22.20 or newer:

npx skills add SusanAcharya/Design-Lounge

Installing the skill alone provides the catalogue and design guidance but not the MCP server’s search, direction, or review tools.

Tools and capabilities

• Search pieces, themes, and pairings with an image for each result.
• Choose repeatable design directions that help keep separate sites distinct.
• Apply a palette, type pairing, component family, and compatible pieces as a shared kit.
• Review completed pages for AI giveaways, kit drift, accessibility, SEO, AEO, and GEO issues.
• Produce laptop- and phone-sized screenshots during local reviews.
• Browse catalogue material covering heroes, footers, landing pages, portfolios, dashboards, phone screens, and motion.

Limitations and notes

The hosted endpoint cannot read local files, preserve project history, install the skill, or take screenshots. It can review public URLs instead. The skill by itself is not a human design review; the MCP server’s review provides the additional automated checks.

Design Lounge is free to use in products with credit retained. The catalogue must not be republished as a catalogue. When the library lacks a suitable piece, the intended workflow is to report that gap rather than invent a replacement from the library.