# BrandReel for AI agents

BrandReel gives AI agents controlled access to owned brand workspaces, reusable visual assets, image and video models, generation history, and generation credits. This is the machine-readable copy of https://brandreel.com/agents.

## Connect over MCP

Create a `br_` API key at https://brandreel.com/dashboard/api-key, then connect the stateless streamable HTTP endpoint:

```bash
claude mcp add --transport http brandreel https://brandreel.com/api/mcp \
  --header "Authorization: Bearer br_your_key"
```

Full MCP setup: https://brandreel.com/agents/mcp

## Or use the skill and CLI

```bash
npx skills add thijssmudde/brandreel-cli
npm install -g brandreel-cli
export BRANDREEL_API_KEY=br_your_key
br usage
br brands:list
```

Full CLI setup: https://brandreel.com/agents/cli

## MCP tools

| Tool | What it does |
| --- | --- |
| `get_usage` | Available, reserved, purchased, and lifetime-used generation credits. Call before any generation. |
| `list_models` | Live image and video model capabilities, supported options, defaults, and credit costs. |
| `list_brands` | All brand workspaces owned by the API-key account. |
| `create_brand` | Create an owned brand workspace. Confirm the name and context with the user first. |
| `get_brand` | One owned workspace with its logo, palette, tagline, website, and asset references. |
| `list_brand_assets` | Resolve the owned workspace logo and reusable visual assets to fresh URLs. |
| `list_generations` | Recent image and video generations for a brand. Use this to avoid duplicates. |
| `get_generation` | Status, media URL, prompt, settings, and provider jobs for one owned generation. |
| `create_generation_record` | Create the owned record required before starting image or video generation. This does not spend credits by itself. |
| `start_image_generation` | Spend credits to start an approved image generation. Read usage/models/assets first and set maxCredits. |
| `start_video_generation` | Spend credits to start an approved video generation. Read usage/models/assets first and set maxCredits. |
| `start_video_upscale` | Spend credits to finish an owned completed video with BytePlus Video Enhancement Pro. The source remains available while the job runs. |
| `get_video_status` | Poll an existing video job instead of creating a duplicate. |

## CLI commands

| Command | What it does |
| --- | --- |
| `br usage` | Read available credits before generating. |
| `br models:list` | List live model capabilities and costs. |
| `br brands:list` | List owned brand workspaces. |
| `br brand:get [slug]` | Read one brand's context. |
| `br assets:list [slug]` | Resolve reusable assets. |
| `br image:create [slug] --prompt <text>` | Generate an approved image. |
| `br video:create [slug] --prompt <text>` | Generate an approved video. |
| `br generations:list [slug]` | Inspect recent generations. |

## Safety contract

Read the brand, assets, models, credit balance, and recent generations first. Show the user the prompt, source assets, model, and maximum credit cost before generating. Set a hard credit ceiling. Poll existing jobs instead of creating duplicates.

## Workflows

### Build a campaign kit

Turn one campaign idea into a visual thesis, hooks, a hero image, and a motion-ready frame.

1. **Read the brand:** Inspect the workspace colors, logo, tagline, and reusable product assets.
2. **Choose the system:** Define one visual thesis and three hook variations without drifting between styles.
3. **Approve the spend:** Show the exact generation command before creating the representative visual.
4. **Extend to motion:** Turn the approved still into a focused image-to-video motion prompt.

Workflow: https://brandreel.com/agents/campaign-kit

### Direct a product shoot

Create a coherent set of product stills from the references already stored in your workspace.

1. **Inventory:** List the workspace references and identify the strongest product source image.
2. **Art direct:** Lock lighting, palette, surface, lens feel, and composition across the set.
3. **Test one:** Generate the hero frame first and review it before producing variants.

Workflow: https://brandreel.com/agents/product-shoot

### Make a social video

Select a source frame, write motion that fits it, and generate a short vertical clip.

1. **Pick a frame:** Use an existing brand asset or approved generated image as the source.
2. **Write motion:** Describe camera movement, subject movement, timing, and the final hold.
3. **Generate once:** Start one job after approval and poll that job until completion.

Workflow: https://brandreel.com/agents/social-video

### Review recent creative

Audit recent outputs for consistency and turn the findings into one better next prompt.

1. **Load context:** Read the brand system and recent generations together.
2. **Find drift:** Compare palette, composition, subject treatment, and motion language.
3. **Correct:** Write one improved next prompt without spending credits.

Workflow: https://brandreel.com/agents/creative-review

## Links

- Agents: https://brandreel.com/agents
- MCP: https://brandreel.com/agents/mcp
- CLI: https://brandreel.com/agents/cli
- API: https://brandreel.com/api
- npm: https://www.npmjs.com/package/brandreel-cli
- CLI and skill source: https://github.com/thijssmudde/brandreel-cli