> ## Documentation Index
> Fetch the complete documentation index at: https://pixelcut.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Brand Libraries

> Manage brand identities and generate brand-consistent content from MCP.

Brand libraries store your brand identity — name, website, tagline, and description. When you generate content with a brand library attached, Pixelcut uses that identity to produce on-brand results.

## Setting up a brand library

Brand libraries are created and edited in the Pixelcut web app. See the [Brand Libraries guide](/user-guide/key-features/brand) for setup instructions.

Once created, your agent can list and reference brand libraries through MCP.

## Listing brand libraries

Ask the agent to find your brand libraries:

```
What brand libraries do I have in my workspace?
```

The agent calls `assets` or the brand-aware generation flow to surface available brand library IDs and identity details.

## Using a brand library with generation

Pass the brand library ID to `generate_media` to apply your brand identity to any generation task:

```
Generate a social media banner for our summer sale using our Acme brand.
```

The agent locates the brand library by name, then calls `generate_media` with the matching `brand_library_id`. Generated images follow the brand's visual guidelines — consistent colors, typography, and style.

### Generation parameters with brand

| Parameter          | Description                                                      |
| ------------------ | ---------------------------------------------------------------- |
| `brand_library_id` | Brand library to apply (recommended for any branded asset)       |
| `aspect_ratio`     | Match the platform — `1:1` for Instagram, `16:9` for web banners |
| `num_variations`   | Generate multiple options to pick the best on-brand result       |

## End-to-end workflow

```
Using our Acme brand, generate 3 Instagram-ready announcement graphics for our new product line, plus a 3:1 email header.
```

The agent:

1. Finds the Acme brand library and pulls the matching `brand_library_id`.
2. Calls `generate_media` with `brand_library_id`, `aspect_ratio: "1:1"`, and `num_variations: 3` for the Instagram posts.
3. Calls `generate_media` again with the same `brand_library_id` and `aspect_ratio: "3:1"` for the email header.

<Tip>
  Generate multiple variations with `num_variations` to pick the best result while maintaining brand consistency across all options.
</Tip>

<Info>
  For more on brand libraries and how to configure brand identities in the web app, see the [Brand Libraries guide](/user-guide/key-features/brand).
</Info>