BrandSnap MCP Server

An MCP (Model Context Protocol) server that wraps BrandSnap's brand identity generation API. Generate complete brand identity kits including colors, fonts, brand voice, logo direction, and social media guidelines.

Installation

npm install
npm run build

Configuration

Set your Anthropic API key:

export ANTHROPIC_API_KEY=your-api-key-here

Usage

As an MCP Server

Add to your MCP client configuration:

{
  "mcpServers": {
    "brandsnap": {
      "command": "node",
      "args": ["/path/to/brandsnap-mcp/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key"
      }
    }
  }
}

Development

# Run in development mode
npm run dev

# Run tests
npm test

Tool: generate_brand_identity

Generate a complete brand identity kit for a business.

Parameters

Parameter	Type	Required	Description
`business_name`	string	✅	The name of the business
`industry`	string	❌	Industry/sector (e.g., "Technology", "Healthcare")
`values`	string	✅	Business description, values, mission
`tone`	string	❌	Desired brand style (e.g., "Modern", "Playful")

Example

{
  "business_name": "TechFlow",
  "industry": "Software Development",
  "values": "We build elegant developer tools that make coding enjoyable. We value simplicity and beautiful design.",
  "tone": "Modern and Professional"
}

Response

Returns a comprehensive brand kit with:

colors - 5 harmonious colors with hex codes and usage guidelines
fonts - Heading and body font recommendations from Google Fonts
brandVoice - Tone, taglines, and voice description
logoDirection - Concept, style, and key visual elements
socialMedia - Platform-specific guidelines and sizing

Output Example

{
  "colors": [
    {
      "name": "Deep Ocean",
      "hex": "#0A2463",
      "usage": "Primary brand color for headers and CTAs"
    }
  ],
  "fonts": {
    "heading": {
      "name": "Inter",
      "weight": "Bold (700)",
      "style": "Sans-serif, modern and clean"
    },
    "body": {
      "name": "Inter",
      "weight": "Regular (400)",
      "style": "Sans-serif, highly readable"
    },
    "reasoning": "Inter provides a modern, technical feel..."
  },
  "brandVoice": {
    "tone": "Professional, Innovative, Approachable",
    "taglines": ["Code with clarity", "Developer joy, delivered"],
    "description": "Speak with confidence and technical expertise..."
  },
  "logoDirection": {
    "concept": "Abstract flow symbol representing code...",
    "style": "Geometric, minimal, modern",
    "elements": ["Flow lines", "Brackets", "Gradient accents"]
  },
  "socialMedia": {
    "profileGuidelines": "Use primary color as background...",
    "coverGuidelines": "Feature gradient with tagline...",
    "colorApplications": ["Use Deep Ocean for headers..."],
    "platforms": [
      { "name": "Instagram", "profileSize": "320x320px", "coverSize": "1080x1080px" }
    ]
  }
}

License

MIT

BrandSnap MCP