Log inSubmit server
Brandsystem MCP logo

Brandsystem MCP

by Brand-System

Extracts brand identity into portable tokens, runtime rules, reports, and compliance checks for AI workflows.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Brandsystem MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "brand-system-brandsystem-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@brandsystem/mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 12 tools correctly (19d ago).

Overview

Brand-System/brandsystem-mcp MCP server extracts brand identity from websites, rendered pages, Figma files, PDFs, and local sources, then compiles it into a portable `.brand/` runtime. Its tools cover identity extraction, design tokens, voice and content rules, personas, messaging, reports, and compliance checks across four progressive sessions. Use it when agents need structured brand context instead of relying on manually pasted guidelines. It runs locally over stdio and can connect to Brandcode Studio for hosted brand synchronization.

Use cases

  • Extract brand identity from a website
  • Compile design tokens and runtime rules
  • Audit content for brand compliance
  • Build personas and messaging variants
  • Check HTML and CSS for brand drift

Key features

  • Website and rendered-page brand extraction
  • Figma, PDF, and local brand-source support
  • DTCG token and runtime compilation
  • Voice, persona, and content strategy tools
  • Content scoring and compliance gates
  • Portable HTML and brand-file exports

Tools12

What Brandsystem MCP lets your agent do. Expand a tool for its parameters.

Verified live~3.7k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

18/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @brandsystem/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars15Stargazers on the source repository.
npm downloads400Package downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed12Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Brandsystem MCP works

What Brand-System/brandsystem-mcp MCP server does

Brand-System/brandsystem-mcp MCP server turns existing brand material into structured files that AI tools can read. Sources can include a website, rendered web pages, Figma design files, PDF guides, or local assets. The resulting .brand/ directory may contain core identity data, DTCG tokens, a brand runtime contract, an interaction policy, design synthesis files, a portable design brief, a visual HTML report, and extracted logo assets.

The workflow is organized into four progressive areas. Core identity captures colors, fonts, and logos. Visual identity adds composition rules, illustration guidance, patterns, and anti-patterns. Messaging covers voice analysis, vocabulary, claims, tone, and brand story. Content strategy supports personas, journey stages, editorial themes, and persona-by-stage messaging variants.

How it works

Start with brand_start, supplying a client name and website URL. Its automatic mode can perform a basic extraction, use rendered-page analysis for JavaScript-heavy sites, and fall back to deeper multi-page inspection when the first pass is insufficient. Individual tools are available when you need more control, such as brand_extract_web, brand_extract_visual, brand_extract_site, or the two-phase Figma extraction flow.

After evidence is collected, brand_generate_designmd creates design synthesis data and a DESIGN.md file, while brand_compile produces DTCG tokens, the runtime contract, and interaction policy. brand_clarify handles uncertain values interactively. Later sessions enrich the same runtime rather than requiring a separate brand context for each task.

The compiled files can be read directly by compatible agents or exported for sharing. The server also exposes brand://runtime and brand://policy resources. Content tools can score material from 0 to 100, run a pass/fail publishing gate, detect drift, and check HTML or CSS against brand rules.

Setup and configuration

Install the npm package with an MCP client configuration that runs npx -y @brandsystem/mcp. The README provides installation commands for Codex, Claude Code, Cursor, Windsurf, Claude Desktop, and Cline. For JSON-based configurations, add the package as a stdio MCP server; the installer can write client settings when invoked with --write, while the default behavior is a dry run.

No account is required for the local-first workflow. A project can commit the generated .brand/ directory and load brand-runtime.json as agent context. Brandcode Studio is an optional hosted connection for teams that need brand synchronization.

Tools and capabilities

Brand-System/brandsystem-mcp MCP server includes tools for:

  • Extracting logos, colors, fonts, computed styles, screenshots, and multi-page evidence.
  • Generating DTCG tokens, runtime contracts, interaction policies, design briefs, and HTML reports.
  • Defining visual identity, messaging, personas, journeys, themes, and messaging matrices.
  • Loading full or task-scoped brand context for writing and other agent tasks.
  • Auditing brand directories, HTML, CSS, content, and cross-document brand drift.
  • Exporting brand files and sending product feedback to the brandsystem team.

Limitations and notes

JavaScript-heavy websites may require rendered or deep-site extraction, and ambiguous brand values can require human confirmation through brand_clarify. The local runtime is the main artifact; hosted synchronization is an optional Brandcode Studio workflow rather than a prerequisite.

The server provides authoring and validation tools for a brand runtime. Generated reports and runtime files can instead be uploaded or supplied to other AI tools as portable brand context.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Brandsystem MCP

Brand-System/brandsystem-mcp is an MCP server that connects AI tools to brand sources such as websites, Figma files, PDFs, and local assets. Its main tools extract identity, compile DTCG tokens and runtime policies, generate reports, load brand context, and audit content, HTML, and CSS for compliance.

Install it by configuring an MCP client to run `npx -y @brandsystem/mcp`, or use the package installer with a named client and `--write`.

Yes, Brand-System/brandsystem-mcp works with Cursor over stdio. Add an MCP entry that runs `npx -y @brandsystem/mcp`, or use the installer with `--client cursor`; the installer can write the configuration when `--write` is supplied.

Run `brand_start` with a client name, website URL, and `mode="auto"`. It extracts colors, fonts, and logos, then can escalate to rendered-page or deeper multi-page extraction, compile the runtime, and generate design and report files.

Related MCP servers

All in Marketing All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBrandsystem MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/brand-system-brandsystem-mcp?style=directory)](https://allmcps.com/mcp/brand-system-brandsystem-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/brand-system-brandsystem-mcp"><img src="https://allmcps.com/api/badge/brand-system-brandsystem-mcp?style=directory" alt="Brandsystem MCP on AllMCPs" /></a>