---
title: brands_list
description: List workspace brands, optionally filtered to owned brands or
  direct competitors.
canonical_url: https://orchestor.io/docs/en/mcp/tools/brands/brands_list
markdown_url: https://orchestor.io/docs/en/mcp/tools/brands/brands_list.md
contentType: reference
---

# brands_list

List workspace brands, optionally filtered to owned brands or direct competitors.

**Operation:** Read-only. The authenticated hosted connection determines the workspace.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `relation` | string | No | Brand relation. `owned` / `direct_competitor` |
| `cursor` | string | No | Next-page cursor from the previous response. |
| `limit` | integer | No | Maximum number of results. Minimum: 1; Maximum: 500 |

If the response includes a next-page cursor, pass it in the next request to continue.

## Sample prompt

```text
List owned brands and direct competitors in this workspace with their IDs and names.
```

[Brands](https://orchestor.io/docs/en/mcp/tools/brands.md) · [Tools](https://orchestor.io/docs/en/mcp/tools.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)