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

# list_brands

> Returns every brand the authenticated user is a member of.

Returns every brand the authenticated user is a member of.

## When to use

* An agent has called `get_brand_context` and the resolved brand doesn't match what the user expected (different plan tier, wrong workspace).
* The user references a brand by name and you need its id to retarget a write.
* The user has multiple brands with the same name (e.g. two "Acme Inc" entries, one trial and one paid) and disambiguation is required.

## Read-only behavior

Read-only. Does not change the active brand — the auth context is fixed for the session at connection time. To actually retarget writes to a different brand, update your MCP config (`CITABLE_BRAND_ID` env var for stdio, or regenerate the API key under the target brand for HTTP) and reconnect.

## Response

```
{ brands: [{ id, name, slug, planTier, role, websiteUrl }], activeBrandId }
```

`activeBrandId` echoes the brand currently resolved by the auth context, so the caller can spot the active row.

Takes no arguments — user resolved from the auth context.

## See also

* [Overview](/mcp/overview)