npm package: @polybrand/mcp-server
Description: Model Context Protocol (MCP) server for PolyBrand - Give AI agents access to your brand assets, colors, typography, and guidelines
Author: PolyBrand
Latest version: 1.0.0

# @polybrand/mcp-server

[![npm version](https://img.shields.io/npm/v/@polybrand/mcp-server.svg)](https://www.npmjs.com/package/@polybrand/mcp-server)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Model Context Protocol server for PolyBrand** - Give AI agents direct access to your brand assets, colors, typography, and guidelines.

<p align="center">
  <img src="https://polybrand.io/mcp-diagram.png" alt="PolyBrand MCP Architecture" width="600">
</p>

## Features

- 🎨 **Brand Colors** - AI-optimized color palettes with semantic names and usage hints
- 🔤 **Typography** - Font families, weights, and styling guidelines
- 📋 **Brand Guidelines** - Complete brand context perfect for LLM system prompts
- 🖼️ **Asset Search** - Find logos, images, and design assets
- ⚡ **Fast & Lightweight** - Minimal dependencies, quick startup
- 🔒 **Secure** - API key authentication with rate limiting

## Installation

### Using npx (Recommended)

```bash
npx @polybrand/mcp-server --token YOUR_API_KEY
```

### Global Installation

```bash
npm install -g @polybrand/mcp-server
polybrand-mcp --token YOUR_API_KEY
```

### Using Smithery

```bash
npx -y @smithery/cli install @polybrand/mcp-server --client claude
```

## Configuration

### Claude Desktop

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "polybrand": {
      "command": "npx",
      "args": ["-y", "@polybrand/mcp-server"],
      "env": {
        "POLYBRAND_API_KEY": "pb_your_api_key_here"
      }
    }
  }
}
```

### Cursor

Add to your Cursor MCP settings (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "polybrand": {
      "command": "npx",
      "args": ["-y", "@polybrand/mcp-server"],
      "env": {
        "POLYBRAND_API_KEY": "pb_your_api_key_here"
      }
    }
  }
}
```

### Windsurf

Add to your Windsurf config:

```json
{
  "mcpServers": {
    "polybrand": {
      "command": "npx",
      "args": ["-y", "@polybrand/mcp-server"],
      "env": {
        "POLYBRAND_API_KEY": "pb_your_api_key_here"
      }
    }
  }
}
```

## Getting Your API Key

1. Log in to [PolyBrand](https://app.polybrand.io)
2. Go to **Settings** → **API Keys**
3. Click **Generate New Key**
4. Copy the key (starts with `pb_`)

## Available Tools

| Tool | Description |
|------|-------------|
| `list_brands` | List all brand profiles in your workspace |
| `get_brand` | Get detailed info for a specific brand |
| `get_brand_colors` | Get AI-optimized color palette with semantic names |
| `get_brand_typography` | Get typography and font settings |
| `get_brand_guidelines` | Get comprehensive brand context for LLM prompts |
| `search_assets` | Search and filter brand assets |
| `get_user_profile` | Get authenticated user information |

## Available Resources

| Resource URI | Description |
|--------------|-------------|
| `polybrand://brands` | List of all brands |
| `polybrand://brands/{id}/style-guide` | Brand style guide in markdown format |

## Example Prompts

Once connected, try these prompts with your AI assistant:

> "Show me the color palette for my brand"

> "What fonts does ACME Corp use?"

> "Generate a social media post that matches my brand guidelines"

> "Find all logo assets for my brand"

> "Create CSS variables from my brand colors"

## Environment Variables

| Variable | Description | Required |
|----------|-------------|----------|
| `POLYBRAND_API_KEY` | Your PolyBrand API key | Yes |
| `POLYBRAND_API_URL` | Custom API URL (for self-hosted) | No |

## CLI Options

```bash
polybrand-mcp [options]

Options:
  --token <key>    API key (overrides POLYBRAND_API_KEY env var)
  --api-url <url>  Custom API URL
  --help           Show help
  --version        Show version
```

## Development

```bash
# Clone the repository
git clone https://github.com/polybrandio/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start -- --token YOUR_API_KEY
```

## Support

- 📚 [Documentation](https://dev.polybrand.io/mcp)
- 💬 [Discord Community](https://discord.gg/polybrand)
- 🐛 [Report Issues](https://github.com/polybrandio/mcp-server/issues)
- ✉️ [Contact Support](mailto:support@polybrand.io)

## License

MIT © [PolyBrand](https://polybrand.io)