brand_list

List the brands of your organization, so that an agent can pick one before it reads the brand in full.

Ask which brands your organization has. The agent lists them with a one-line description for each.

“Which brands do we have?”

The agent calls brand_list. You see each brand with its name, its description and its Assignees, newest first. An Assignee is a member who is accountable for the brand. An Assignee has no extra access. To list only the brands that you are an Assignee of, ask for “my brands”. The agent then calls the tool with assignee: "me". To read one brand in full, the agent then calls brand_get.

The job guide Describe a brand shows each step of the job.

Reference

List the active organization’s brands as slug + name + description + hasBody + assignees, newest first. hasBody is true when the brand has a body to read. The body itself is not returned — pick a brand here, then load its context with brand_get. An Assignee is a current member of the organization who is accountable for the record. An Assignee has no extra access: every role with the write scope can still edit the record. Pass assignee “me” to list only the brands that the person of the token is an Assignee of. The answer holds at most limit rows (default 100, maximum 500). When it carries nextCursor, more rows exist: call this tool again with the same arguments and cursor set to that value. When it carries no nextCursor, you have every row.

Input

Argument	Type	Required	Description
`cursor`	string, at least 1 character	no	The `nextCursor` of the previous page. Omit it to get the first page. Send it with no change, and with the same filters as the request that answered it: a cursor from a different query gets a 400 `invalid_cursor`. Do not build or change a cursor.
`limit`	integer, 1 to 500	no	The greatest number of rows on the page, from 1 to 500. The default is 100. A greater value gets a 400, with `error` of `invalid_request`. Default: `100`.
`assignee`	`me`	no	Pass “me” to list only the records that the person of the token is an Assignee of.

Output

A successful call returns this object in structuredContent.

Field	Type	Always present	Description
`brands`	array of object	yes	The brands of the organization, newest first.
`brands[].description`	string	yes	One line about the brand. An agent picks a brand on it.
`brands[].name`	string	yes	The display name.
`brands[].slug`	string	yes	The handle of the brand in the organization. The tools take it as `brand_name`.
`brands[].assignees`	array of object	yes	The current members who are accountable for the record, oldest first, at most 10. An Assignee grants no access.
`brands[].assignees[].id`	string	yes	The `usr_…` id of the member.
`brands[].assignees[].name`	string	yes	The name of the member.
`brands[].hasBody`	boolean	yes	`true` when the body holds text. Read the text with the get tool.
`nextCursor`	string	no	Send this value as `cursor` to get the next page. It is absent on the last page.

Failure codes

A failed call has isError set, and structuredContent.error holds one of these codes. Errors describes the shape of a failed call.

invalid_cursor
organization_unentitled
forbidden
invalid_request
internal_error

Scope

The token must hold brand:read. Auth & scopes lists each scope.

Annotations

A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.

Read-only. The tool changes nothing.
Closed world. The tool reads and writes the data of AdCrunch only.

Example

The arguments:

{
  "limit": 20
}

The result, in structuredContent:

{
  "brands": [
    {
      "assignees": [
        {
          "id": "usr_4d8b12",
          "name": "Maya Lindqvist"
        }
      ],
      "description": "Running shoes sold direct to the runner, made to last a thousand kilometres.",
      "hasBody": true,
      "name": "Acme",
      "slug": "acme"
    },
    {
      "assignees": [],
      "description": "Trail shoes for runners who leave the road.",
      "hasBody": false,
      "name": "Acme Trail",
      "slug": "acme-trail"
    }
  ]
}