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.
MCP Resources
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.jsonandmcpNameare 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.ymlrefreshes 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
brandIdparameter - uiforge-webapp — Brand management UI at
/branding/* - forge-patterns — Shared configs and conventions
Community
License
MIT