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, Pixa uses that identity to produce on-brand results.

Setting up a brand library

Brand libraries are created and edited in the Pixa web app. See the Brand Libraries guide 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.

Generate multiple variations with num_variations to pick the best result while maintaining brand consistency across all options.

For more on brand libraries and how to configure brand identities in the web app, see the Brand Libraries guide.