@forgespace/branding-mcp 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.5.0] - 2026-02-28
+
+### Added
+
+- New MCP tool: `generate_design_system` — complete design system in one call (identity + token export combined)
+- 10 new tests for design system tool (198 total across 16 suites)
+
 ## [0.4.0] - 2026-02-28
 
 ### Added

package/README.md

@@ -5,7 +5,7 @@
 [![CI](https://github.com/Forge-Space/branding-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Forge-Space/branding-mcp/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Generate complete design systems — colors, typography, spacing, shadows, borders, motion tokens, gradients, multi-variant logos, favicons, and OG images with multi-format export. 8 MCP tools, zero API dependencies, algorithmic-first generation.
+Generate complete design systems — colors, typography, spacing, shadows, borders, motion tokens, gradients, multi-variant logos, favicons, and OG images with multi-format export. 9 MCP tools, zero API dependencies, algorithmic-first generation.
 
 ## Features
 
@@ -45,16 +45,17 @@ npm run build
 
 ### MCP Tools
 
-| Tool                         | Description                                        |
-| ---------------------------- | -------------------------------------------------- |
-| `generate_brand_identity`    | Complete brand from name, industry, and style      |
-| `generate_color_palette`     | Color palette with harmony and WCAG data           |
-| `generate_typography_system` | Font pairing + modular type scale                  |
-| `export_design_tokens`       | Export brand to JSON/CSS/Tailwind/Figma/React/Sass |
-| `create_brand_guidelines`    | Generate HTML brand book                           |
-| `validate_brand_consistency` | Check WCAG compliance and completeness             |
-| `refine_brand_element`       | Iterate on specific brand elements                 |
-| `generate_brand_assets`      | Generate favicons and OG images from brand         |
+| Tool                         | Description                                            |
+| ---------------------------- | ------------------------------------------------------ |
+| `generate_brand_identity`    | Complete brand from name, industry, and style          |
+| `generate_color_palette`     | Color palette with harmony and WCAG data               |
+| `generate_typography_system` | Font pairing + modular type scale                      |
+| `export_design_tokens`       | Export brand to JSON/CSS/Tailwind/Figma/React/Sass     |
+| `create_brand_guidelines`    | Generate HTML brand book                               |
+| `validate_brand_consistency` | Check WCAG compliance and completeness                 |
+| `refine_brand_element`       | Iterate on specific brand elements                     |
+| `generate_brand_assets`      | Generate favicons and OG images from brand             |
+| `generate_design_system`     | Complete design system in one call (identity + export) |
 
 ### MCP Resources
 

package/dist/index.js

@@ -11,6 +11,7 @@ import { registerCreateBrandGuidelines } from './tools/create-brand-guidelines.j
 import { registerValidateBrandConsistency } from './tools/validate-brand-consistency.js';
 import { registerRefineBrandElement } from './tools/refine-brand-element.js';
 import { registerGenerateBrandAssets } from './tools/generate-brand-assets.js';
+import { registerGenerateDesignSystem } from './tools/generate-design-system.js';
 import { registerBrandTemplates } from './resources/brand-templates.js';
 import { registerBrandKnowledge } from './resources/brand-knowledge.js';
 async function main() {
@@ -28,6 +29,7 @@ async function main() {
     registerValidateBrandConsistency(server);
     registerRefineBrandElement(server);
     registerGenerateBrandAssets(server);
+    registerGenerateDesignSystem(server);
     registerBrandTemplates(server);
     registerBrandKnowledge(server);
     const transport = new StdioServerTransport();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,8BAA8B,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,gCAAgC,CAAC,MAAM,CAAC,CAAC;IACzC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,gCAAgC,CAAC,MAAM,CAAC,CAAC;IACzC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAEpC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;AACzD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,qCAAqC,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAEjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,8BAA8B,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,gCAAgC,CAAC,MAAM,CAAC,CAAC;IACzC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,gCAAgC,CAAC,MAAM,CAAC,CAAC;IACzC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAErC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;AACzD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,qCAAqC,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/generate-design-system.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGenerateDesignSystem(server: McpServer): void;
+//# sourceMappingURL=generate-design-system.d.ts.map

package/dist/tools/generate-design-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-design-system.d.ts","sourceRoot":"","sources":["../../src/tools/generate-design-system.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyGzE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuDpE"}

package/dist/tools/generate-design-system.js

@@ -0,0 +1,104 @@
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { generateColorPalette, generateTypographySystem, generateSpacingScale, generateShadowSystem, generateBorderSystem, generateMotionSystem, generateGradientSystem, generateSvgLogo, defaultLogoConfig, exportDesignTokens, exportCssVariables, exportTailwindPreset, exportFigmaTokens, exportReactTheme, exportSassVariables, } from '../lib/branding-core/index.js';
+import { brandStyleSchema, colorHarmonySchema, colorThemeSchema, exportFormatSchema, fontCategorySchema, hexColorSchema, typeScaleRatioSchema, } from '../lib/branding-core/validators/token-schema.js';
+import { logger } from '../lib/logger.js';
+const STYLE_DEFAULTS = {
+    minimal: { heading: 'sans-serif', body: 'sans-serif' },
+    bold: { heading: 'display', body: 'sans-serif' },
+    elegant: { heading: 'serif', body: 'serif' },
+    playful: { heading: 'display', body: 'sans-serif' },
+    corporate: { heading: 'sans-serif', body: 'sans-serif' },
+    tech: { heading: 'sans-serif', body: 'monospace' },
+    organic: { heading: 'serif', body: 'sans-serif' },
+    retro: { heading: 'display', body: 'serif' },
+};
+const EXPORTERS = {
+    json: exportDesignTokens,
+    css: exportCssVariables,
+    tailwind: exportTailwindPreset,
+    figma: exportFigmaTokens,
+    react: exportReactTheme,
+    sass: exportSassVariables,
+};
+function buildIdentity(params) {
+    const defaults = STYLE_DEFAULTS[params.style];
+    const harmony = (params.harmony ?? 'complementary');
+    const theme = params.theme;
+    const scaleRatio = (params.scaleRatio ?? 'major-third');
+    const colors = generateColorPalette(params.baseColor, harmony, theme);
+    const typography = generateTypographySystem(params.headingCategory ?? defaults.heading, params.bodyCategory ?? defaults.body, scaleRatio);
+    const spacing = generateSpacingScale();
+    const shadows = generateShadowSystem(colors.primary.hex, theme);
+    const borders = generateBorderSystem(params.style);
+    const motion = generateMotionSystem(params.style);
+    const gradients = generateGradientSystem(colors, params.style);
+    const logoConfig = {
+        ...defaultLogoConfig(params.brandName, colors.primary.hex),
+        font: typography.headingFont,
+        style: params.style,
+    };
+    const logo = generateSvgLogo(logoConfig);
+    return {
+        id: `brand_${randomUUID().slice(0, 8)}`,
+        name: params.brandName,
+        tagline: params.tagline,
+        industry: params.industry,
+        style: params.style,
+        colors,
+        typography,
+        spacing,
+        shadows,
+        borders,
+        motion,
+        gradients,
+        logo,
+        createdAt: new Date().toISOString(),
+    };
+}
+export function registerGenerateDesignSystem(server) {
+    server.tool('generate_design_system', 'Generate a complete design system with brand identity and exported tokens in one call. ' +
+        'Combines generate_brand_identity + export_design_tokens for a streamlined workflow.', {
+        brandName: z.string().min(1).max(100).describe('Brand name'),
+        industry: z.string().min(1).max(100).describe('Industry or sector'),
+        style: brandStyleSchema.describe('Visual style direction'),
+        tagline: z.string().max(200).optional().describe('Brand tagline'),
+        baseColor: hexColorSchema.optional().describe('Base color preference'),
+        harmony: colorHarmonySchema.optional().describe('Color harmony type'),
+        theme: colorThemeSchema.optional().describe('Light/dark/both'),
+        headingCategory: fontCategorySchema.optional().describe('Heading font category'),
+        bodyCategory: fontCategorySchema.optional().describe('Body font category'),
+        scaleRatio: typeScaleRatioSchema.optional().describe('Typography scale ratio'),
+        exportFormats: z
+            .array(exportFormatSchema)
+            .min(1)
+            .max(6)
+            .describe('Token export formats to include'),
+    }, async (params) => {
+        try {
+            logger.info({ brandName: params.brandName, formats: params.exportFormats }, 'Generating design system');
+            const identity = buildIdentity(params);
+            const exports = {};
+            for (const format of params.exportFormats) {
+                const exporter = EXPORTERS[format];
+                const result = exporter(identity);
+                exports[format] = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+            }
+            const output = {
+                identity,
+                exports,
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: `Error generating design system: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=generate-design-system.js.map

package/dist/tools/generate-design-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-design-system.js","sourceRoot":"","sources":["../../src/tools/generate-design-system.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgespace/branding-mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "MCP server for AI-powered brand identity generation — color palettes, typography systems, design tokens, and brand guidelines with multi-format export",
   "type": "module",
   "main": "dist/index.js",

package/src/__tests__/unit/design-system-tool.test.ts

@@ -0,0 +1,176 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerGenerateDesignSystem } from '../../tools/generate-design-system.js';
+
+function createMockServer(): McpServer & { registeredTools: Map<string, unknown> } {
+  const tools = new Map<string, unknown>();
+  return {
+    registeredTools: tools,
+    tool(name: string, _desc: string, _schema: unknown, handler: unknown) {
+      tools.set(name, handler);
+    },
+  } as McpServer & { registeredTools: Map<string, unknown> };
+}
+
+describe('generate_design_system tool', () => {
+  let server: ReturnType<typeof createMockServer>;
+  let handler: (
+    params: Record<string, unknown>
+  ) => Promise<{ content: Array<{ text: string }>; isError?: boolean }>;
+
+  beforeAll(() => {
+    server = createMockServer();
+    registerGenerateDesignSystem(server);
+    handler = server.registeredTools.get('generate_design_system') as typeof handler;
+  });
+
+  it('registers the tool', () => {
+    expect(server.registeredTools.has('generate_design_system')).toBe(true);
+  });
+
+  it('generates identity with all subsystems', async () => {
+    const result = await handler({
+      brandName: 'TestBrand',
+      industry: 'tech',
+      style: 'minimal',
+      exportFormats: ['json'],
+    });
+
+    const output = JSON.parse(result.content[0].text);
+    const identity = output.identity;
+
+    expect(identity.name).toBe('TestBrand');
+    expect(identity.colors).toBeDefined();
+    expect(identity.typography).toBeDefined();
+    expect(identity.spacing).toBeDefined();
+    expect(identity.shadows).toBeDefined();
+    expect(identity.borders).toBeDefined();
+    expect(identity.motion).toBeDefined();
+    expect(identity.gradients).toBeDefined();
+    expect(identity.logo).toBeDefined();
+  });
+
+  it('includes requested export formats', async () => {
+    const result = await handler({
+      brandName: 'TestBrand',
+      industry: 'tech',
+      style: 'bold',
+      exportFormats: ['css', 'tailwind'],
+    });
+
+    const output = JSON.parse(result.content[0].text);
+    expect(output.exports.css).toBeDefined();
+    expect(output.exports.tailwind).toBeDefined();
+    expect(output.exports.json).toBeUndefined();
+  });
+
+  it('exports valid CSS variables', async () => {
+    const result = await handler({
+      brandName: 'CSSTest',
+      industry: 'design',
+      style: 'elegant',
+      exportFormats: ['css'],
+    });
+
+    const output = JSON.parse(result.content[0].text);
+    expect(output.exports.css).toContain('--');
+    expect(output.exports.css).toContain(':root');
+  });
+
+  it('exports valid Tailwind preset', async () => {
+    const result = await handler({
+      brandName: 'TailwindTest',
+      industry: 'tech',
+      style: 'tech',
+      exportFormats: ['tailwind'],
+    });
+
+    const output = JSON.parse(result.content[0].text);
+    expect(output.exports.tailwind).toContain('theme');
+    expect(output.exports.tailwind).toContain('extend');
+  });
+
+  it('supports all 6 export formats at once', async () => {
+    const result = await handler({
+      brandName: 'AllFormats',
+      industry: 'retail',
+      style: 'playful',
+      exportFormats: ['json', 'css', 'tailwind', 'figma', 'react', 'sass'],
+    });
+
+    const output = JSON.parse(result.content[0].text);
+    expect(Object.keys(output.exports)).toHaveLength(6);
+  });
+
+  it('applies optional parameters', async () => {
+    const result = await handler({
+      brandName: 'CustomBrand',
+      industry: 'health',
+      style: 'organic',
+      tagline: 'Live naturally',
+      baseColor: '#2D8B4E',
+      harmony: 'analogous',
+      theme: 'light',
+      headingCategory: 'serif',
+      bodyCategory: 'sans-serif',
+      scaleRatio: 'golden-ratio',
+      exportFormats: ['json'],
+    });
+
+    const output = JSON.parse(result.content[0].text);
+    expect(output.identity.tagline).toBe('Live naturally');
+    expect(output.identity.style).toBe('organic');
+  });
+
+  it('returns error for invalid input gracefully', async () => {
+    const result = await handler({
+      brandName: 'Test',
+      industry: 'tech',
+      style: 'minimal',
+      exportFormats: ['json'],
+    });
+
+    expect(result.isError).toBeUndefined();
+    expect(result.content[0].text).toBeDefined();
+  });
+
+  it('generates unique brand IDs', async () => {
+    const params = {
+      brandName: 'UniqueTest',
+      industry: 'tech',
+      style: 'minimal' as const,
+      exportFormats: ['json'],
+    };
+
+    const r1 = await handler(params);
+    const r2 = await handler(params);
+    const id1 = JSON.parse(r1.content[0].text).identity.id;
+    const id2 = JSON.parse(r2.content[0].text).identity.id;
+    expect(id1).not.toBe(id2);
+  });
+
+  it('all brand styles produce valid output', async () => {
+    const styles = [
+      'minimal',
+      'bold',
+      'elegant',
+      'playful',
+      'corporate',
+      'tech',
+      'organic',
+      'retro',
+    ];
+
+    for (const style of styles) {
+      const result = await handler({
+        brandName: `${style}Brand`,
+        industry: 'test',
+        style,
+        exportFormats: ['json'],
+      });
+
+      expect(result.isError).toBeUndefined();
+      const output = JSON.parse(result.content[0].text);
+      expect(output.identity.style).toBe(style);
+    }
+  });
+});

package/src/index.ts

@@ -13,6 +13,7 @@ import { registerCreateBrandGuidelines } from './tools/create-brand-guidelines.j
 import { registerValidateBrandConsistency } from './tools/validate-brand-consistency.js';
 import { registerRefineBrandElement } from './tools/refine-brand-element.js';
 import { registerGenerateBrandAssets } from './tools/generate-brand-assets.js';
+import { registerGenerateDesignSystem } from './tools/generate-design-system.js';
 
 import { registerBrandTemplates } from './resources/brand-templates.js';
 import { registerBrandKnowledge } from './resources/brand-knowledge.js';
@@ -34,6 +35,7 @@ async function main(): Promise<void> {
   registerValidateBrandConsistency(server);
   registerRefineBrandElement(server);
   registerGenerateBrandAssets(server);
+  registerGenerateDesignSystem(server);
 
   registerBrandTemplates(server);
   registerBrandKnowledge(server);

package/src/tools/generate-design-system.ts

@@ -0,0 +1,163 @@
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import {
+  generateColorPalette,
+  generateTypographySystem,
+  generateSpacingScale,
+  generateShadowSystem,
+  generateBorderSystem,
+  generateMotionSystem,
+  generateGradientSystem,
+  generateSvgLogo,
+  defaultLogoConfig,
+  exportDesignTokens,
+  exportCssVariables,
+  exportTailwindPreset,
+  exportFigmaTokens,
+  exportReactTheme,
+  exportSassVariables,
+} from '../lib/branding-core/index.js';
+import {
+  brandStyleSchema,
+  colorHarmonySchema,
+  colorThemeSchema,
+  exportFormatSchema,
+  fontCategorySchema,
+  hexColorSchema,
+  typeScaleRatioSchema,
+} from '../lib/branding-core/validators/token-schema.js';
+import type { BrandIdentity, BrandStyle, ExportFormat, FontCategory } from '../lib/types.js';
+import { logger } from '../lib/logger.js';
+
+const STYLE_DEFAULTS: Record<BrandStyle, { heading: FontCategory; body: FontCategory }> = {
+  minimal: { heading: 'sans-serif', body: 'sans-serif' },
+  bold: { heading: 'display', body: 'sans-serif' },
+  elegant: { heading: 'serif', body: 'serif' },
+  playful: { heading: 'display', body: 'sans-serif' },
+  corporate: { heading: 'sans-serif', body: 'sans-serif' },
+  tech: { heading: 'sans-serif', body: 'monospace' },
+  organic: { heading: 'serif', body: 'sans-serif' },
+  retro: { heading: 'display', body: 'serif' },
+};
+
+const EXPORTERS: Record<ExportFormat, (brand: BrandIdentity) => string | object> = {
+  json: exportDesignTokens,
+  css: exportCssVariables,
+  tailwind: exportTailwindPreset,
+  figma: exportFigmaTokens,
+  react: exportReactTheme,
+  sass: exportSassVariables,
+};
+
+function buildIdentity(params: {
+  brandName: string;
+  industry: string;
+  style: BrandStyle;
+  tagline?: string;
+  baseColor?: string;
+  harmony?: string;
+  theme?: string;
+  headingCategory?: FontCategory;
+  bodyCategory?: FontCategory;
+  scaleRatio?: string;
+}): BrandIdentity {
+  const defaults = STYLE_DEFAULTS[params.style];
+  const harmony = (params.harmony ?? 'complementary') as Parameters<typeof generateColorPalette>[1];
+  const theme = params.theme as Parameters<typeof generateColorPalette>[2];
+  const scaleRatio = (params.scaleRatio ?? 'major-third') as Parameters<
+    typeof generateTypographySystem
+  >[2];
+
+  const colors = generateColorPalette(params.baseColor, harmony, theme);
+  const typography = generateTypographySystem(
+    params.headingCategory ?? defaults.heading,
+    params.bodyCategory ?? defaults.body,
+    scaleRatio
+  );
+  const spacing = generateSpacingScale();
+  const shadows = generateShadowSystem(colors.primary.hex, theme);
+  const borders = generateBorderSystem(params.style);
+  const motion = generateMotionSystem(params.style);
+  const gradients = generateGradientSystem(colors, params.style);
+  const logoConfig = {
+    ...defaultLogoConfig(params.brandName, colors.primary.hex),
+    font: typography.headingFont,
+    style: params.style,
+  };
+  const logo = generateSvgLogo(logoConfig);
+
+  return {
+    id: `brand_${randomUUID().slice(0, 8)}`,
+    name: params.brandName,
+    tagline: params.tagline,
+    industry: params.industry,
+    style: params.style,
+    colors,
+    typography,
+    spacing,
+    shadows,
+    borders,
+    motion,
+    gradients,
+    logo,
+    createdAt: new Date().toISOString(),
+  };
+}
+
+export function registerGenerateDesignSystem(server: McpServer): void {
+  server.tool(
+    'generate_design_system',
+    'Generate a complete design system with brand identity and exported tokens in one call. ' +
+      'Combines generate_brand_identity + export_design_tokens for a streamlined workflow.',
+    {
+      brandName: z.string().min(1).max(100).describe('Brand name'),
+      industry: z.string().min(1).max(100).describe('Industry or sector'),
+      style: brandStyleSchema.describe('Visual style direction'),
+      tagline: z.string().max(200).optional().describe('Brand tagline'),
+      baseColor: hexColorSchema.optional().describe('Base color preference'),
+      harmony: colorHarmonySchema.optional().describe('Color harmony type'),
+      theme: colorThemeSchema.optional().describe('Light/dark/both'),
+      headingCategory: fontCategorySchema.optional().describe('Heading font category'),
+      bodyCategory: fontCategorySchema.optional().describe('Body font category'),
+      scaleRatio: typeScaleRatioSchema.optional().describe('Typography scale ratio'),
+      exportFormats: z
+        .array(exportFormatSchema)
+        .min(1)
+        .max(6)
+        .describe('Token export formats to include'),
+    },
+    async (params) => {
+      try {
+        logger.info(
+          { brandName: params.brandName, formats: params.exportFormats },
+          'Generating design system'
+        );
+
+        const identity = buildIdentity(params);
+        const exports: Record<string, string> = {};
+
+        for (const format of params.exportFormats) {
+          const exporter = EXPORTERS[format];
+          const result = exporter(identity);
+          exports[format] = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+        }
+
+        const output = {
+          identity,
+          exports,
+        };
+
+        return {
+          content: [{ type: 'text' as const, text: JSON.stringify(output, null, 2) }],
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+          content: [{ type: 'text' as const, text: `Error generating design system: ${message}` }],
+          isError: true,
+        };
+      }
+    }
+  );
+}