Brandsystem MCP - Brand Guidelines for AI

@brandsystem/mcp turns the brand material you already have into context AI agents can use. Give it a website, PDF guide, Figma library, local files, or a Brandcode Studio brand. It produces a portable .brand/ runtime with design tokens, voice rules, provenance, and compliance checks. Its 34 documented tools cover brand, extract, build, brandcode.

People connecting design tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-20 · ★ 13 · #13 OF 74 MAINTAINED DESIGN · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Brandsystem MCP - Brand Guidelines for AI

Claude Code

claude mcp add brandcode-studio-brandsystem-mcp -- npx -y @brandsystem/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "brandcode-studio-brandsystem-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@brandsystem/mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @brandsystem/mcp - the @brandsystem scope differs from the repo owner (brandcode-studio); confirm it's the project's official package

registry namespace io.github.Brandcode-Studio is GitHub-verified and matches the repo owner

03 · What Brandsystem MCP - Brand Guidelines for AI can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can check progress, get next steps, or see a getting-started guide if no brand exists yet, extract logo (SVG/PNG), colors, and fonts from any website URL, generate design-synthesis.json and DESIGN.md from extracted evidence or the current brand state, and extract from Figma design files (higher accuracy). Two-phase: plan then ingest.

The 34 tools it gives your agent

Extracted from the project's README - what Brandsystem MCP - Brand Guidelines for AI lets an agent do.

brand_start
- Begin here. Creates a brand system from a website URL in under 60 seconds. Use mode='auto' for one-call setup with rendered and deep-site fallback on weak JS-re
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_generate_designmd
- Generate design-synthesis.json and DESIGN.md from extracted evidence or the current brand state.
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.
show all 34 tools
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 expl
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.

Latest releases

v0.16.1 · 2026-07-20

Three findings from the Codex 0.16.0 review, all conceded: · Fixed · Fenced errors keep MCP error semantics: the #45 error fence returned the structured envelope without isError: true, so generic MCP clients could…

v0.16.0 · 2026-07-19

Robustness release closing #45 (both 0.14 ingestion-fuzzing findings) plus the output_contract affordance. (No 0.15 was released; the 0.15 candidate list shipped here.) · Fixed · extractLogos bounded on hostile pages…

v0.14.4 · 2026-07-18

Ships the theme-dimension completion (#35 gap 1) to npm consumers, plus the canonical landing-page metadata. · Fixed · Dark-theme colors survive the source catalog (#54): dark entries get their own catalog field…

04 · Who maintains Brandsystem MCP - Brand Guidelines for AI

Brandsystem MCP - Brand Guidelines for AI is maintained by brandcode-studio. It's the only MCP server we track from this author; the repo dates to Mar 2026.

05 · Facts

category
design - ranked #13 of 74 actively-maintained design servers as of 2026-08-25.
release cadence
10+ releases in the last 90 days (latest 2026-07-20)
registry
io.github.Brandcode-Studio/brandsystem-mcp (active, first published 2026-07-17 · 17 versions)
packages
npm:@brandsystem/mcp

06 · Brandsystem MCP - Brand Guidelines for AI FAQ

Is Brandsystem MCP - Brand Guidelines for AI still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-20 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Brandsystem MCP - Brand Guidelines for AI do?

With this server connected, an agent can check progress, get next steps, or see a getting-started guide if no brand exists yet, extract logo (SVG/PNG), colors, and fonts from any website URL, generate design-synthesis.json and DESIGN.md from extracted evidence or the current brand state, and extract from Figma design files (higher accuracy). Two-phase: plan then ingest.

How do I install Brandsystem MCP - Brand Guidelines for AI?

Run `npx -y @brandsystem/mcp`. You can also paste the ready-made client config above.

Does Brandsystem MCP - Brand Guidelines for AI run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Brandsystem MCP - Brand Guidelines for AI