← Back to directory
B

Brandsystem MCP

Community
Turn existing brand guidelines into AI-usable portable brand runtime.
GitHub source repository ↗
★ 13 Stars Category · Dev Tools Popular Source revision eded428fa0b9
62FMRS · C

Brandsystem MCP provides a comprehensive suite of brand management tools enabling AI agents to follow brand guidelines. It supports extracting brand elements from websites, Figma, etc., generates design tokens and brand runtime, and provides checking, auditing, and compliance capabilities. It is particularly suitable for design and development teams aiming to integrate brand systems into AI workflows. However, be aware that extraction accuracy depends on algorithms and may require human intervention, and there is some configuration complexity.

Reliability
10/20
Security and permissions
12/20
Maintenance
12/20
Documentation
14/20
Setup experience
14/20
Read the FMRS scoring method →

Brandsystem MCP server is designed to convert existing brand materials, such as websites, PDFs, Figma files, into a portable .brand runtime that AI agents can understand and use. It provides a complete suite of tools covering the four stages of brand adoption: Core Identity, Visual Identity, Messaging, and Content Strategy. It generates structured brand data including design tokens, governance rules, provenance, and compliance checks, enabling AI to produce on-brand content consistently. The server is local-first, no account required by default, runs over stdio, and is compatible with multiple development tools.

Tools

brand_start
Begin here. Creates a brand system from a website URL in under 60 seconds, with auto mode for one-call setup.
brand_status
Check progress, get next steps, or see a getting-started guide if no brand exists yet.
brand_extract_web
Extract logo (SVG/PNG), colors, and fonts from any website URL.
brand_extract_visual
Screenshot the rendered page in headless Chrome and extract computed colors, fonts, and visual context from JS-heavy sites.
brand_extract_site
Discover representative pages, render them across desktop and mobile, capture screenshots, sample multiple components, and persist extraction-evidence.json.
brand_extract_figma
Extract from Figma design files (higher accuracy). Two-phase: plan then ingest.
brand_set_logo
Add/replace logo via SVG markup, URL, or data URI.
brand_compile
Generate DTCG design tokens, brand runtime contract, and interaction policy from extracted data.
brand_clarify
Resolve ambiguous brand values interactively (color roles, font confirmations).
brand_audit
Validate .brand/ directory for completeness and correctness.
brand_report
Generate portable HTML brand report. Upload to any AI chat as instant guidelines.
brand_init
Low-level directory scaffolding. Prefer brand_start instead.
brand_deepen_identity
Define composition rules, patterns, illustration style, and anti-patterns (6 interview sections).
brand_ingest_assets
Scan and catalog brand assets with MANIFEST.yaml metadata.
brand_preflight
Check HTML/CSS against brand rules -- catches off-brand colors, wrong fonts, anti-pattern violations.
brand_extract_messaging
Audit existing website voice -- fingerprint, vocabulary, claims, AI-isms, gaps.
brand_compile_messaging
Define perspective, voice codex (tone, vocabulary, AI-ism detection), and brand story.
brand_build_personas
Build buyer personas through a 7-question guided interview.
brand_build_journey
Define buyer journey stages (ships with 4 proven defaults).
brand_build_themes
Define editorial content themes balanced across awareness, engagement, and conversion.
brand_build_matrix
Generate messaging variants for every persona x journey stage combination.
brand_audit_content
Score content against brand rules (0-100) across multiple dimensions.
brand_check_compliance
Quick pass/fail compliance gate before publishing.
brand_audit_drift
Detect systematic brand drift across multiple pieces of content.
brand_runtime
Read the compiled brand runtime contract (single-document brand context for AI agents).
brand_context
Select a task-scoped slice of the runtime deterministically (task_type → sections, audience → persona match, compact budget). Returns matched selectors and explicit no-match.
brand_write
Load full brand context (visual + voice + strategy) for content generation.
brand_export
Generate portable brand files for Chat, Code, team sharing, or email.
brand_feedback
Report bugs, friction, or feature ideas to the brandsystem team.
brand_brandcode_connect
Connect a local .brand/ directory to a hosted Brandcode Studio brand and pull the current package.
brand_brandcode_sync
Pull updates from a previously connected hosted brand using sync-token-aware delta behavior.
brand_brandcode_status
Inspect the current Brandcode Studio connection, sync history, and local package summary.
brand_brandcode_live
Toggle connected read tools to refresh from the hosted runtime within a short cache TTL.

Setup

  1. Create .mcp.json in project root (Claude Code) or .cursor/mcp.json (Cursor) or use CLI installer.
{
  "mcpServers": {
    "brandsystem": {
      "command": "npx",
      "args": ["-y", "@brandsystem/mcp"]
    }
  }
}
  1. For Codex, Cline, etc., use npx @brandsystem/mcp install --client <client> --write to auto-configure.
  2. Ensure Node.js >= 20.18.1.
claude_desktop_config.json
{
  "mcpServers": {
    "brandsystem": {
      "command": "npx",
      "args": [
        "-y",
        "@brandsystem/mcp"
      ]
    }
  }
}

Fit and risk

Best for

  • Design teams needing consistent brand identity in AI-driven content.
  • Developers who want to automate brand guideline extraction and token compilation.
  • Teams using Claude Code, Cursor, and similar tools.
  • Marketing professionals and content creators managing brand assets.

Not for

  • General AI tasks that don't need brand management.
  • Users who only want a hosted brand service (might be better with @brandcode/mcp).
  • Those relying on Figma direct integration without extra Figma MCP server.
  • Users without Node.js 20+ or who prefer not to run local servers.

Required permissions

  • Reads the websites you specify for extractions (network access).
  • Reads local filesystem and writes to the .brand directory (within your project dir).
  • Accesses authentication credentials when connecting hosted Brandcode Studio (stored in .brand/brandcode-auth.json).
  • Sends optional feedback to the brand team.

Risks and side effects

  • Network communication with remote sites, possible copyright/privacy concerns.
  • Extracted data is algorithmically inferred, may have inaccuracies, needs human review.
  • Figma extraction requires an additional Figma MCP, adding configuration complexity.
  • Default core profile only exposes 12 tools; full functionality requires opting into full profile.

Troubleshooting

  1. If no .brand directory found, run brand_start first.
  2. If extraction yields no colors/fonts, site may be dynamic: try brand_extract_visual or brand_extract_site.
  3. If Figma extraction fails, ensure a separate Figma MCP server is connected.
  4. If logo not detected, use brand_set_logo to add manually.
  5. If server won't start, check Node.js version (>=20.18.1) and run `npx @brandsystem/mcp doctor`.

Use cases

Rapidly extract brand colors, fonts, and logos from a website.
Import brand tokens from Figma design libraries.
Define brand voice and anti-patterns for AI content generation.
Check content compliance against brand rules before publishing.
Create portable brand reports for sharing with teams and AI tools.
Connect to Brandcode Studio for syncing and single source of truth.

Supported clients

Claude DesktopFull support
Claude CodeFull support
CursorFull support
WindsurfFull support
ClineFull support
CodexFull support