# Brandsystem MCP — Brand Guidelines for AI

Builds a .brand/ runtime from a website, PDF, or Figma library so AI agents can use brand rules while generating content.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 15
- Author: Brandcode-Studio
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Brandcode-Studio/brandsystem-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/brandsystem-mcp-brand-guidelines-for-ai

## What it does

Brandsystem MCP turns a website, PDF guide, Figma library, or local files into a portable `.brand/` directory. The runtime can contain colors, fonts, logo details, DTCG tokens, voice rules, anti-patterns, and compliance data. Agents can load `brand-runtime.json` as shared brand context instead of receiving those rules in every prompt.

The Core profile exposes 12 tools for building, using, and checking a brand system. `brand_start` creates the core identity and can produce `DESIGN.md`, `design-synthesis.json`, `interaction-policy.json`, and an HTML report. Later sessions add visual identity, messaging, and persona data.

The server connects over stdio and is started with `npx -y @brandsystem/mcp`. It is local-first and does not require an account. A separate command can save the brand to Brandcode Studio for shared access.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add brandsystem-mcp -- npx -y @brandsystem/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add brandsystem-mcp-brand-guidelines-for-ai -- npx -y @brandsystem/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "brandsystem-mcp-brand-guidelines-for-ai": {
            "command": "npx",
            "args": [
                "-y",
                "@brandsystem/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "brandsystem-mcp-brand-guidelines-for-ai": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@brandsystem/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add brandsystem-mcp-brand-guidelines-for-ai npx -y @brandsystem/mcp
```

## When to use it
- build a brand system from a website or PDF
- extract colors, fonts, and logos from Figma
- give an agent one portable brand context
- check generated work against anti-patterns

## Example prompts
- Run `brand_start` on this website and create the core brand system.
- Use `brand_write` to make a social graphic for the product launch using `brand-runtime.json`.
- Run `brand_deepen_identity` and add composition and illustration rules.

## Similar
- [brand-guidelines](https://affpapa.org/en/nevibecode/skills/arnabbagxd-brand-guidelines.md) — skill · 1800 installs
- [brand-analyzer](https://affpapa.org/en/nevibecode/skills/brand-analyzer.md) — skill · 1100 installs
- [brand-designer](https://affpapa.org/en/nevibecode/skills/brand-designer.md) — skill · 1300 installs
- [Brand Guidelines Generator](https://affpapa.org/en/nevibecode/skills/brand-guidelines-generator.md) — skill · 4700 installs
- [build-a-brand](https://affpapa.org/en/nevibecode/skills/build-a-brand.md) — skill · 1700 installs
- [brand-visual-generator](https://affpapa.org/en/nevibecode/skills/brand-visual-generator.md) — skill · 1400 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md