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 and its description, newest first. 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, newest first. The brand context itself is not returned — pick a brand here, then load its context with brand_get. 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`.

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`.
`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
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": [
    {
      "description": "Running shoes sold direct to the runner, made to last a thousand kilometres.",
      "name": "Acme",
      "slug": "acme"
    },
    {
      "description": "Trail shoes for runners who leave the road.",
      "name": "Acme Trail",
      "slug": "acme-trail"
    }
  ]
}