Skip to main content
Glama
Brand MCP

Brand MCP

Brand MCP

A standalone Model Context Protocol server for brand-guided design generation, using Sample Brand, a fictional demonstration identity.

The sample identity includes a violet-and-slate palette, original geometric diamond symbols, nine vector logo variants, three photorealistic AI-generated speaker cutouts plus five legacy geometric avatars, and seven social and one-page layout references. Names, roles, quotes, reference copy, statistics, and example.com addresses are demonstration content, not real people or factual claims.

Start locally

Requires Node.js 22 or 24 and pnpm 11.

pnpm install --frozen-lockfile
pnpm build
pnpm start

pnpm start runs the stdio MCP server. See examples/client-config.json and replace the example absolute path with your checkout path. Use the server key sample-brand.

For HTTP on port 8080:

pnpm start:http

The HTTP endpoint is /mcp; health is /healthz. The default host allowlist contains localhost, loopback addresses, and sample-brand-mcp. Set SAMPLE_MCP_ALLOWED_HOSTS for your deployment. HTTP mode does not expose filesystem materialization or file validation tools. It provides no authentication; configure authentication at your reverse proxy before exposing it beyond your intended audience.

Related MCP server: @forgespace/branding-mcp

Workflows

  1. Call get_brand_guidelines before generation.

  2. Use create_social_svg, create_quote_post, create_generation_prompt, or local create_one_pager.

  3. Review spelling corrections and validate the result. Resolve final-mode violations.

Social variants: navy_poster, petition_push, violet_alert, statistic_card, contrast_cards, and quote_post. Lower thirds are supported through create_social_svg.

For photographic quote posts, choose speaker1, speaker2, or speaker3. These are original AI-generated fictional people supplied as transparent PNG cutouts. speaker4 through speaker8 retain legacy geometric avatars. No real speaker attribution or portrait is bundled.

One-page templates: material_cost_chain and access_barriers. The tool materializes a clean working SVG into deliverables/. Replace its content and illustration, supply real sources, then validate its exact path using validate_one_pager_file. The populated references are layout demonstrations, not finished factual publications.

Resources use the brand://sample/ namespace. Run get_mcp_status and audit_brand_assets to inspect the running server and asset availability.

Customize

  • data/sample-brand.json: identity, typography, palette, speaker profiles, and generation rules.

  • assets/manifest.json: asset inventory.

  • assets/logos/: synthetic SVG logo variants.

  • assets/quote-people/: transparent photographic PNG cutouts and legacy SVG-wrapped geometric avatars.

  • assets/post-references/ and assets/one-pager-references/: editable layout references.

  • src/brand.ts: rendering and validation contracts. Palette and layout changes may also require updates here and in tests.

Local output paths can be configured with SAMPLE_BRAND_WORKSPACE_DIR, SAMPLE_BRAND_OUTPUT_DIR, and SAMPLE_BRAND_ASSET_DIR. This project uses its own package, configuration namespace, and Git history.

Install the supplied fonts before editing generated SVGs in a design application. Open font assets retain their required license and copyright notices under assets/fonts/licenses/.

Verify

pnpm check
pnpm test
pnpm smoke
pnpm render:samples

With the HTTP server running, pnpm smoke:http checks the local endpoint. Set SAMPLE_MCP_URL to test another endpoint. pnpm audit:prod checks production dependencies.

The code remains UNLICENSED; publication does not grant an open-source license. Font licenses are supplied separately.

Available Tools

13 tools
audit_brand_assetsA
Read-onlyIdempotent

Check whether required SAMPLE logo and font assets are available for final branded output.

Inputs: basePath.

create_generation_promptC
Read-onlyIdempotent

Correct and visibly report spelling issues, then create a strict brand-locked prompt for another LLM or image/design model using the corrected request.

Inputs: request (required), outputType, includeNegativePrompt.

create_one_pagerA

Correct and visibly report spelling issues in the request and supplied copy, then materialize a complete clean SAMPLE one-pager working SVG directly into the shared local workspace. Returns a compact file path and SHA-256 instead of transferring the SVG through chat, preventing resource truncation. Edit that file in place, never append content to the populated visual reference, and validate by path with validate_one_pager_file.

Inputs: request (required), mode, sources, headline, +4 more.

create_quote_postA
Read-onlyIdempotent

Correct and visibly report spelling issues in the supplied quote, then create a download-ready, Illustrator-safe SVG 1.1 SAMPLE quote post for an approved team member using corrected text. Keeps text and portrait in protected non-overlapping zones, scales portrait prominence proportionally to quote length, contains the full uncropped portrait, embeds it through xlink:href, keeps text editable with packaged installed fonts, verifies the name/title, and always applies Signal Violet emphasis.

Inputs: quote (required), person (required), mode, emphasis, +2 more.

create_social_svgA
Read-onlyIdempotent

Correct and visibly report spelling issues in all supplied copy, then generate an Illustrator-safe SVG 1.1 SAMPLE artwork from the reference-locked social templates using only corrected text. This is the only supported social-post renderer: never recreate its SVG through a legacy or freeform generator. Outputs use editable packaged SAMPLE fonts, native unscaled headline glyphs, inline vector logos, and xlink:href for embedded rasters. Any PNG preview must be rendered with the packaged files in assets/fonts; never accept a system-font fallback preview. For template=quote, provide person and put the quote in headline; the generator uses reference 5 with a non-overlapping, uncropped, fully embedded approved portrait, verified attribution, and mandatory violet emphasis.

Inputs: headline (required), cta, body, mode, +12 more.

get_brand_guidelinesA
Read-onlyIdempotent

Return SAMPLE brand guidelines from the 2026 guide. Use this before generating any SAMPLE-branded output.

Inputs: section.

get_mcp_statusA
Read-onlyIdempotent

Report the live SAMPLE Brand MCP version, runtime paths, core capabilities, and packaged asset health. Use this to confirm a client loaded the latest rebuilt server after an update.

Inputs: no named parameters.

qa_social_layoutC
Read-onlyIdempotent

Correct and visibly report spelling issues, then check whether the corrected social or lower-third copy fits SAMPLE layout limits before generating SVG.

Inputs: headline (required), cta, body, mode, +1 more.

validate_design_specA
Read-onlyIdempotent

Validate a proposed design against the strict SAMPLE 2026 brand palette, typography, logo, and format rules.

Inputs: mode, fonts, colors, widthPx, +7 more.

validate_illustrator_svgA
Read-onlyIdempotent

Reject browser-only SVG features that commonly trigger missing-link or plug-in warnings in Adobe Illustrator. Requires SVG 1.1, xlink:href base64 raster embedding, editable installed fonts, inline vector logos, and no live SVG filters.

Inputs: svg (required), mode.

validate_one_pager_fileA

Validate a completed SAMPLE one-pager directly from its local workspace file path. The MCP reads the SVG server-side and returns only a compact validation report, avoiding truncation of large SVG or embedded-image payloads. This includes both strict one-pager and Adobe Illustrator validation.

Inputs: filePath (required), mode, template.

validate_one_pager_svgA
Read-onlyIdempotent

Compatibility validator for callers that already hold complete SVG markup. For normal one-pager workflows use validate_one_pager_file so large SVG and embedded-image payloads never pass through chat.

Inputs: svg (required), mode, template.

validate_svg_artifactA
Read-onlyIdempotent

Validate a generated SVG artifact against SAMPLE brand rules and the Illustrator-safe SVG 1.1 export contract, including approved fonts, palette discipline, social dimensions, embedded raster compatibility, and official logo usage.

Inputs: svg (required), mode, assetType, requiresLogo, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 13 tools

    Disambiguation2/5

    Several validators have heavily overlapping purposes: validate_svg_artifact, validate_illustrator_svg, validate_one_pager_file, and validate_one_pager_svg all target Adobe-Illustrator-safe SVG compliance with slightly different entry points. create_quote_post also duplicates functionality already covered by create_social_svg when template=quote, making tool selection genuinely ambiguous.

    Naming Consistency4/5

    Tool names mostly follow a clear verb_noun pattern: get_*, create_*, validate_*, audit_*. The main deviation is qa_social_layout, where 'qa' is an acronym used as a verb, but it is still readable and consistent with the overall imperative style.

    Tool Count4/5

    13 tools is at the upper end of a reasonable scope for a brand-compliance SVG generation server. The count is defensible, though the multiple near-duplicate validators make the set feel slightly heavier than necessary.

    Completeness4/5

    The server covers the core workflow well: retrieving guidelines, auditing assets, validating design specs, generating branded SVG outputs, and validating final artifacts. Minor gaps exist, such as no explicit template-listing tool, but agents can complete the main creation and validation flow without dead ends.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Provides standardized brand guidelines and structured content templates for marketing assets like blogs, emails, and social media. It serves as a central source of truth for brand voice and strategy through an extensible file-based system.
      1
      -
    • A
      license
      Not graded
      quality
      F
      maintenance
      Generates complete brand identity systems including colors, typography, logos, and design tokens with 58 MCP tools. Supports multi-format export and AI-assisted refinement.
      77 npm
      2
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Deterministically generates brand and design artefacts (logo SVG, colour palette, type system, design tokens) with signed, 0G-anchored provenance receipts, plus paid tools for social kits, revisions, and verification.
      1
      -