What is the branding-mcp server?
branding-mcp is an algorithm-first MCP server for brand identity work, installed with npm install @forgespace/branding-mcp and started with npx -y @forgespace/branding-mcp@latest. It gives an agent 58 tools covering color palettes with WCAG checks, typography pairings, spacing and motion tokens, logos, favicons and multi-format design token export.
branding-mcp generates a brand identity algorithmically: color harmonies, typography pairings, spacing and shadow scales, motion tokens and gradients, without calling an outside design API for the core work.
An optional AI refinement step can use an Anthropic API key for extra polish, but the server's 58 tools work in algorithm-only mode without one.
What it changes in your workflow
- An agent generates a complete brand identity from a name and an industry, instead of picking colors by guesswork.
- Color palettes come with a WCAG contrast check built in, catching an inaccessible pairing before it ships.
- Design tokens export in several formats at once: JSON, CSS, Tailwind, Figma-ready and React or Sass variables.
- A brand guideline document can be generated as HTML, giving a team something to reference beyond a raw token export.
What it covers
| branding-mcp | |
|---|---|
| Core | Color, typography, spacing, shadow and motion tokens |
| Assets | Logos, favicons and Open Graph image generation |
| Checks | WCAG contrast validation on generated palettes |
| Export | JSON, CSS, Tailwind, Figma, React, Sass |
Who it is for
Best for
- Agents that need a full, consistent brand identity fast, rather than picking individual colors by hand.
- Teams that want generated design tokens ready to drop into Tailwind, Sass or a React theme.
- Projects that want a WCAG contrast check on a palette before it is treated as final.
Not for
- Turning an existing written brand guideline into a portable, enforceable runtime, rather than generating a new identity from scratch, is the job Brandsystem MCP does instead.
- Following the DTCG token standard across three tiers for a system that already exists, rather than generating a brand new one, is the scope the Design Tokens skill covers instead.
- Pulling design tokens out of an already-live website, rather than generating a brand new identity from a name, is the narrower job Dembrandt MCP does for an agent.
- Producing brand assets such as a logo, slides and banners by hand with an agent's help, rather than through algorithmic generation, is what the Design skill for brand work offers instead.
Use it with UiChemy
This server produces tokens and assets for a brand identity, not a finished page. Once a palette and type scale are set, UiChemy Composer can carry them into an editable Elementor or Gutenberg build. Click Get Started on uichemy.com.
Connect Branding MCP: Generate a Brand Identity and Design Tokens to your AI client
npx -y @forgespace/branding-mcp@latestInstall the package
Run npm install @forgespace/branding-mcp, or skip straight to the npx command below.
Add the server entry
Put the config above in your client's MCP settings; no API key is required for the algorithm-only tools.
Optional AI refinement
Set an Anthropic API key in your environment if you want the optional AI-assisted refinement step on top of the algorithmic output.
Restart and generate
Restart your client and ask it to generate a brand identity for a name and an industry to confirm the connection.
Client configuration
{
"mcpServers": {
"branding": {
"command": "npx",
"args": ["-y", "@forgespace/branding-mcp@latest"]
}
}
}What you can do with it
- Algorithm-first generationColor, typography, spacing and motion tokens are produced by rule-based generation, so the core tools work with no outside API.
- Built-in WCAG checksGenerated color palettes are checked for contrast compliance as part of generation, not as a separate audit step.
- 58 tools across brand workCovers palettes, typography, tokens, logos, favicons, Open Graph images and guideline documents in one server.
- Multi-format token exportThe same generated tokens export to JSON, CSS, Tailwind, Figma, React and Sass without regenerating them per format.
- Optional AI refinementAn Anthropic API key enables an extra refinement pass on top of the algorithmic output, for teams that want it.
- Guideline document generationcreate_brand_guidelines turns raw tokens into an HTML reference document a team can share.
Tools it exposes
generate_brand_identity
Produces a full brand identity, including color, typography and token output, from a name and an industry.
generate_color_palette
Generates a color harmony with a built-in WCAG contrast check.
generate_typography_system
Produces font pairings and a type scale for headings and body text.
export_design_tokens
Exports generated tokens in JSON, CSS, Tailwind, Figma, React or Sass format.
create_brand_guidelines
Generates an HTML brand guideline document from the identity's tokens.
validate_brand_consistency
Checks a set of tokens or assets for WCAG compliance and internal consistency.
generate_design_system
Produces a complete design system, bundling color, type, spacing and motion tokens in one call.
Frequently asked questions
What is the branding-mcp server?
It is an MCP server that generates a brand identity algorithmically: color palettes with WCAG checks, typography pairings, design tokens, logos and guideline documents, through 58 tools in one package.
How do I install branding-mcp?
Run npm install @forgespace/branding-mcp, then add an MCP server entry with command npx and args -y, @forgespace/branding-mcp@latest; no API key is needed for the core generation tools to work right away.
Does it need an API key?
No, not for the core algorithm-only tools. An Anthropic API key only turns on an optional extra refinement pass on top of the algorithmic color, typography and token output already produced.
Does it check accessibility?
Yes. Generated color palettes go through a built-in WCAG contrast check, and validate_brand_consistency can re-check a set of tokens or assets against the same standard before they ship to a live site.
What token formats can it export?
export_design_tokens supports JSON, CSS, Tailwind, Figma-ready, React and Sass output from the same generated tokens, so one generation step can feed several different codebases and design teams at the same time.
Can it generate a logo?
Yes, among the broader asset set. The 58 tools cover logo, favicon and Open Graph image generation alongside the core color, typography and spacing token work the server already does.
Can it produce a document a team can reference?
Yes. create_brand_guidelines turns the generated tokens into an HTML brand guideline document, giving a team something concrete to check new work against beyond a raw token export sitting alone in a repository.


