# 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

```bash
npm install
npm run build
```

## Configuration

Set your Anthropic API key:

```bash
export ANTHROPIC_API_KEY=your-api-key-here
```

## Usage

### As an MCP Server

Add to your MCP client configuration:

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

### Development

```bash
# 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

```json
{
  "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

```json
{
  "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