English Français العربية

io.github.Forge-Space/branding-mcp

Official registry Archived Marketing and sales

AI-powered brand identity generation via MCP with design tokens, typography, and logo assets.

Source code Documentation

What can you do with io.github.Forge-Space/branding-mcp?

  • Color Palette Generation — HSL-based color harmonies (complementary, analogous, triadic, etc.) with WCAG contrast validation
  • Typography System — Modular type scales with curated font pairings
  • Spacing Scale — Geometric progression spacing system
  • Shadow/Elevation System — 6-level elevation scale with brand-tinted shadows, light/dark theme support
  • Border/Shape System — Style-aware radius scales and border widths for all 8 brand styles
  • Motion/Animation System — Duration scales, cubic-bezier easings, and transition presets per brand style
  • Gradient System — 5 style-aware gradient presets (hero, button, card, text, background)
  • Multi-Variant Logo — Wordmark, monogram, abstract, and icon variants with style-aware shapes

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @forgespace/branding-mcp
Claude Code 
claude mcp add branding-mcp -- npx -y @forgespace/branding-mcp@0.56.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "branding-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@forgespace/branding-mcp@0.56.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @forgespace/branding-mcp
  2. Features
  3. Quick Start
  4. Development
  5. Distribution
  6. Architecture
  7. Ecosystem Integration
  8. Community
  9. License

@forgespace/branding-mcp

AI-powered brand identity generation via MCP — part of the Forge Space open developer workspace.

Generate complete design systems — colors, typography, spacing, shadows, borders, motion tokens, gradients, multi-variant logos, favicons, and OG images with multi-format export. 58 MCP tools, zero API dependencies, algorithmic-first generation.

Features

  • Color Palette Generation — HSL-based color harmonies (complementary, analogous, triadic, etc.) with WCAG contrast validation
  • Typography System — Modular type scales with curated font pairings
  • Spacing Scale — Geometric progression spacing system
  • Shadow/Elevation System — 6-level elevation scale with brand-tinted shadows, light/dark theme support
  • Border/Shape System — Style-aware radius scales and border widths for all 8 brand styles
  • Motion/Animation System — Duration scales, cubic-bezier easings, and transition presets per brand style
  • Gradient System — 5 style-aware gradient presets (hero, button, card, text, background)
  • Multi-Variant Logo — Wordmark, monogram, abstract, and icon variants with style-aware shapes
  • Favicon Generation — 4 sizes (16, 32, 180 apple-touch, 512 PWA) from brand icon
  • OG Image Templates — Default, article, and social formats with brand gradients
  • Multi-Format Export — W3C Design Tokens, CSS custom properties, Tailwind preset, Figma tokens, React theme, Sass variables
  • Brand Validation — WCAG contrast checking, completeness scoring, consistency analysis
  • Brand Guidelines — HTML brand book generation

Quick Start

npm install
npm run build
Run from npm (stdio)
npx -y @forgespace/branding-mcp@latest
Install globally
npm install -g @forgespace/branding-mcp
forgespace-branding-mcp
IDE / client config
{
  "mcpServers": {
    "forgespace-branding": {
      "command": "npx",
      "args": ["-y", "@forgespace/branding-mcp@latest"]
    }
  }
}

Set ANTHROPIC_API_KEY when you want AI-assisted refinement. The server also works in algorithmic-only mode without external APIs.

MCP Tools

Core and vertical tools are available (58 total). The table below highlights the core set plus key vertical generators, including healthcare.

ToolDescription
generate_brand_identityComplete brand from name, industry, and style
generate_color_paletteColor palette with harmony and WCAG data
generate_typography_systemFont pairing + modular type scale
export_design_tokensExport brand to JSON/CSS/Tailwind/Figma/React/Sass
create_brand_guidelinesGenerate HTML brand book
validate_brand_consistencyCheck WCAG compliance and completeness
refine_brand_elementIterate on specific brand elements
generate_brand_assetsGenerate favicons and OG images from brand
generate_design_systemComplete design system in one call (identity + export)
generate_brand_fintechFintech-specific strategy with compliance and security
generate_brand_healthcareHealthcare strategy with care models and safety signals
MCP Resources
ResourceURIDescription
Brand Templatesbrand://templatesPre-configured industry templates
Brand Knowledgebrand://knowledgeColor theory and typography rules

Development

npm run dev          # Watch mode
npm run validate     # Lint + format + test
npm run test         # Run tests
npm run test:coverage # Coverage report
npm run build        # Build TypeScript

Distribution

  • npm — installable as @forgespace/branding-mcp
  • MCP Registry metadata — server.json and mcpName are included for registry submission
  • Tag release automation — pushing v* runs npm publish with provenance, then publishes the same version to the MCP Registry via GitHub OIDC
  • Weekly registry ops — .github/workflows/mcp-registry-status.yml refreshes one issue with npm and MCP Registry drift, visibility, and next actions
  • GitHub — Forge-Space/branding-mcp

Architecture

src/
├── index.ts                    # MCP server entry
├── lib/
│   ├── branding-core/          # Core library (reusable)
│   │   ├── generators/         # Color, typography, spacing, logo, gradients, favicons, OG
│   │   ├── exporters/          # Multi-format token export
│   │   ├── validators/         # WCAG, consistency checks
│   │   └── documents/          # Brand book generation
│   ├── config.ts               # Environment config
│   ├── logger.ts               # Pino logging
│   └── types.ts                # TypeScript interfaces
├── tools/                      # 58 MCP tool registrations
└── resources/                  # Templates + knowledge base

Ecosystem Integration

Part of the Forge Space ecosystem:

  • mcp-gateway — Register as MCP server (port 8033)
  • ui-mcp — Consumes brand tokens via brandId parameter
  • uiforge-webapp — Brand management UI at /branding/*
  • forge-patterns — Shared configs and conventions

Community

License

MIT

Frequently asked questions

What is io.github.Forge-Space/branding-mcp?

AI-powered brand identity generation via MCP with design tokens, typography, and logo assets.

How do I install io.github.Forge-Space/branding-mcp?

It runs on your machine. In Claude Code: claude mcp add branding-mcp -- npx -y @forgespace/branding-mcp@0.56.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Forge-Space/branding-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.Forge-Space/branding-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Forge-Space/branding-mcp?

It is published by Forge-Space. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.