What is the Dembrandt MCP server?
Dembrandt is an open source CLI that renders a site in Chromium and returns its logo, colors, typography, spacing, borders, shadows and motion as design tokens. The dembrandt-mcp server exposes that extraction to an AI coding agent as tools, with job polling, DTCG export, drift checks and a DESIGN.md generator.
Dembrandt extracts any website's design system in one command, and the same project ships an MCP server named dembrandt-mcp. Playwright renders the page, Dembrandt reads computed styles from the DOM, groups them, and returns design tokens.
Through MCP, your agent can ask for the color palette of a URL, then hand the result to analysis and export tools. Extraction returns a job id, which you poll with get_job_status before using the pure tools.
What changes in your agent's output
- The agent gets measured colors, type, spacing, borders, shadows and motion from a real page, not an eyeballed palette.
- Setting
pagesabove 1 crawls and merges several pages. The README says this gives a markedly stronger token set than a single page. export_dtcgproduces W3C design tokens, andgenerate_design_mdwrites a DESIGN.md that an agent can read as a brief.compute_driftandget_findingsflag token changes and contrast or consistency issues.
What it can read
- Colors with semantic roles, palette, CSS variables and gradients.
- Typography with fonts, sizes, weights, sources and font file URLs.
- Spacing scales, border radius and widths, shadows, and motion curves.
- Components such as buttons, badges, inputs and links, plus breakpoints, icons and frameworks.
Who the Dembrandt MCP server is for
Best for
- Auditing your own site's tokens and keeping them from drifting between releases.
- Benchmarking a competitor's visual system for documentation and learning, within the site's terms.
- Feeding a design system build with real values before an agent writes components, then using the shadcn MCP server to pull matching components.
Not for
- Canvas or WebGL sites. The README says there is no DOM to read, so they cannot be analyzed.
- Copying a third-party brand. The project's intended-use note says not to reproduce brand identities, logos or trademarks.
- Reading a drawn file. The Figma MCP server is the right source for that.
- Extraction by prompt inside a larger toolkit. The designlang MCP server covers similar ground through a different CLI.
Use it with UiChemy
Dembrandt hands your agent the tokens of a design. If the end goal is a WordPress site, UiChemy builds there: Figma to WordPress converts a design, and Composer edits the result in Elementor or Gutenberg. Click Get Started on uichemy.com.
Connect Dembrandt MCP Server: Design Tokens From Any Website to your AI client
claude mcp add --transport stdio dembrandt -- npx -y --package dembrandt dembrandt-mcpInstall the browser once
Dembrandt drives Chromium through playwright-core, which ships no browser. Run
npx dembrandt install-browseronce, or the tool fails with a browser engine not available error. Node.js 18 or later is required.Add the server
Run the command above for Claude Code, or put the JSON config in your project's
.mcp.json. Other MCP clients can launch the same command.Ask for a site
Ask your agent to extract the color palette of a URL. Extraction returns a job id.
Poll and export
Call
get_job_statuswith the job id, thenget_findings,export_dtcgorgenerate_design_mdon the same id.
Client configuration
{
"mcpServers": {
"dembrandt": {
"command": "npx",
"args": ["-y", "--package", "dembrandt", "dembrandt-mcp"]
}
}
}Endpoints and ports
dembrandt-mcpBinary inside the dembrandt package, started with npxpagesSet above 1 to crawl and merge several pagescookie, headerReach pages behind a sessionhttps://github.com/dembrandt/dembrandt/blob/main/docs/usage.mdFlag reference for the CLIWhat you can do with it
- Real DOM measurementsPlaywright renders the page and Dembrandt reads computed styles, then analyzes color usage and groups similar typography.
- Multi-page mergeSet pages above 1, name paths explicitly, or let the sitemap option discover pages for cross-page confidence.
- Dark, mobile and slow modesExtraction accepts
darkMode,mobileandslowoptions for the dark theme, a 390 by 844 viewport and heavy sites. - Authenticated pagesThe
cookieandheaderoptions reach pages behind a session, anduserAgentandnoSandboxcover Docker and CI containers. - Agent-readable outputDESIGN.md and DTCG exports give an agent a brief and a token file to follow.
- Drift gate for CIThe CLI's compare flag exits 1 when tokens move, and a GitHub Action annotates the PR with the drifted tokens.
- WCAG contrast on real pairsThe wcag option grades contrast on foreground and background pairs read from the DOM.
Tools it exposes
get_design_tokens
Extracts the full token set from a URL and returns a job id.
get_color_palette
Extracts the color palette of a page.
get_typography
Extracts fonts, sizes, weights and sources.
get_component_styles
Extracts styles for buttons, badges, inputs and links.
get_surfaces
Extracts surface and background styles.
get_spacing
Extracts the margin and padding scales.
get_brand_identity
Extracts brand identity details of the page.
get_job_status
Polls an extraction job until its tokens are ready.
compute_drift
Compares extractions and reports tokens that moved.
get_findings
Returns contrast and consistency issues for a finished job.
export_dtcg
Exports a finished job as W3C design tokens.
generate_design_md
Writes a DESIGN.md that an AI agent can read.
render_report
Renders a report for a finished job.
Frequently asked questions
What is the Dembrandt MCP server?
It is the dembrandt-mcp binary in the dembrandt package. It exposes Dembrandt's website design extraction to an AI agent as MCP tools, so the agent can pull colors, typography, spacing and components from a URL and export them as design tokens.
How do I install Dembrandt MCP?
Run npx dembrandt install-browser once, then claude mcp add --transport stdio dembrandt -- npx -y --package dembrandt dembrandt-mcp. Or add the same command to a project .mcp.json. Dembrandt requires Node.js 18 or later.
Which agents does Dembrandt MCP support?
The README says to use it as a tool in Claude Code, Cursor, Windsurf, or any MCP-compatible client, and it gives a .mcp.json entry that other clients can adapt. It runs as a local stdio server.
What does the DESIGN.md export do?
The generate_design_md tool writes a DESIGN.md file for AI agents, summarizing the extracted design system so a coding agent can follow it while building. The CLI offers the same output through its design-md flag.
Does Dembrandt work on every website?
No. The README lists limits: canvas and WebGL sites cannot be analyzed, hover and focus states come from CSS and are not fully interactive, and heavy JavaScript sites need hydration time. Only run it where the terms of service allow automated access.
Is Dembrandt free, and what license does it use?
The CLI is MIT licensed and free, as the repository states. Sponsorship funds an optional layer: baseline drift gates in CI and a hosted app for snapshot history. Local use needs no login.
How is Dembrandt different from the Figma MCP server?
The Figma MCP server reads a design file that someone drew. Dembrandt reads a site that is already built, from its rendered styles. Pick Dembrandt when you need what a live page actually uses, and Figma when the design file is the source.



