@polybrand/mcp-server

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

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)

npx @polybrand/mcp-server --token YOUR_API_KEY

Global Installation

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

Using Smithery

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):

{
  "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):

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

Windsurf

Add to your Windsurf config:

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

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

# 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
• 💬 Discord Community
• 🐛 Report Issues
• ✉️ Contact Support

License

MIT © PolyBrand