Skip to main content
Glama

List brand assets

list_brand_assets
Read-onlyIdempotent

Lists one brand's stored images, up to 24 per page with next_cursor: each asset id, type (product, lifestyle, model, logo or reference), URL, description, tags and whether it is the primary image of its type. The source of asset_id for the brand image tools and of product_image_id for campaigns. Read-only; uploads and analyzes nothing.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "brand_id": "<brand_id>"
    },
    "name": "list_brand_assets"
  }
}

Input Schema

NameRequiredDescriptionDefault
cursorNonext_cursor from the previous page for the same brand and type; absent or null for the first page.
brand_idYesBrand id from list_brands.
page_sizeNoImages per page, 1 to 24.
asset_typeNoOptional filter: only images of this type. Absent lists every type.
response_formatNoOutput format: text (default) or json. table is not available for this tool.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -{
      -  "$schema": "https://json-schema.org/draft/2020-12/schema",
      -  "additionalProperties": false,
      -  "properties": {
      -    "allowance": {
      -      "anyOf": [
      -        {
      -          "additionalProperties": false,
      -          "description": "Free daily ad-return allowance for this workspace, resetting at midnight UTC.",
      -          "properties": {
      -            "daily_limit": {
      -              "description": "Maximum free ad examples returned per UTC day.",
      -              "type": "number"
      -            },
      -            "remaining": {
      -              "description": "Free ad examples still available today.",
      -              "type": "number"
      -            },
      -            "resets_at": {
      -              "description": "ISO timestamp when the allowance or credits reset.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "daily_limit",
      -            "remaining",
      -            "resets_at"
      -          ],
      -          "type": "object"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "description": "Free daily ad-return allowance for this workspace, resetting at midnight UTC."
      -    },
      -    "assets": {
      -      "anyOf": [
      -        {
      -          "description": "Brand images accessible to this connection.",
      -          "items": {
      -            "additionalProperties": false,
      -            "description": "Brand images accessible to this connection.",
      -            "properties": {
      -              "asset_type": {
      -                "anyOf": [
      -                  {
      -                    "description": "asset type value in this response.",
      -                    "enum": [
      -                      "product",
      -                      "lifestyle",
      -                      "model",
      -                      "logo",
      -                      "reference"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "asset type value in this response."
      -              },
      -              "brand_id": {
      -                "anyOf": [
      -                  {
      -                    "description": "Reference for the selected brand.",
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Reference for the selected brand."
      -              },
      -              "created_at": {
      -                "anyOf": [
      -                  {
      -                    "description": "created at value in this response.",
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "created at value in this response."
      -              },
      -              "description": {
      -                "anyOf": [
      -                  {
      -                    "description": "description value in this response.",
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "description value in this response."
      -              },
      -              "id": {
      -                "anyOf": [
      -                  {
      -                    "description": "id value in this response.",
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "id value in this response."
      -              },
      -              "is_primary": {
      -                "anyOf": [
      -                  {
      -                    "description": "is primary value in this response.",
      -                    "type": "boolean"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "is primary value in this response."
      -              },
      -              "metadata": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "description": "metadata value in this response.",
      -                    "properties": {
      -                      "content_type": {
      -                        "anyOf": [
      -                          {
      -                            "description": "content type value in this response.",
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "content type value in this response."
      -                      },
      -                      "file_size": {
      -                        "anyOf": [
      -                          {
      -                            "description": "file size value in this response.",
      -                            "type": "number"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "file size value in this response."
      -                      },
      -                      "original_name": {
      -                        "anyOf": [
      -                          {
      -                            "description": "original name value in this response.",
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "original name value in this response."
      -                      }
      -                    },
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "metadata value in this response."
      -              },
      -              "tags": {
      -                "anyOf": [
      -                  {
      -                    "description": "tags value in this response.",
      -                    "items": {
      -                      "description": "tags value in this response.",
      -                      "type": "string"
      -                    },
      -                    "type": "array"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "tags value in this response."
      -              },
      -              "updated_at": {
      -                "anyOf": [
      -                  {
      -                    "description": "updated at value in this response.",
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "updated at value in this response."
      -              },
      -              "url": {
      -                "anyOf": [
      -                  {
      -                    "description": "url value in this response.",
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "url value in this response."
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "description": "Brand images accessible to this connection."
      -    },
      -    "done": {
      -      "anyOf": [
      -        {
      -          "description": "Deprecated for one release: inverse of has_more.",
      -          "type": "boolean"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "description": "Deprecated for one release: inverse of has_more."
      -    },
      -    "has_more": {
      -      "anyOf": [
      -        {
      -          "description": "Whether another bounded page is available with next_cursor.",
      -          "type": "boolean"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "description": "Whether another bounded page is available with next_cursor."
      -    },
      -    "nextCursor": {
      -      "anyOf": [
      -        {
      -          "description": "Deprecated for one release: alias of next_cursor.",
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "description": "Deprecated for one release: alias of next_cursor."
      -    },
      -    "next_cursor": {
      -      "anyOf": [
      -        {
      -          "description": "Continuation handle for the same filters; null when no further page is offered.",
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "description": "Continuation handle for the same filters; null when no further page is offered."
      -    },
      -    "pageSize": {
      -      "anyOf": [
      -        {
      -          "description": "Deprecated for one release: alias of page_size.",
      -          "type": "number"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "description": "Deprecated for one release: alias of page_size."
      -    },
      -    "page_size": {
      -      "anyOf": [
      -        {
      -          "description": "Effective number of rows requested per page.",
      -          "type": "number"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "description": "Effective number of rows requested per page."
      -    }
      -  },
      -  "type": "object"
      -}New value: +null
  2. Changed6 schema fields changed
    • changedInput schema / properties / asset_type / description
      Previous value: -"Purpose of this brand image: product, lifestyle, model, logo or reference."New value: +"Optional filter: only images of this type. Absent lists every type."
    • changedInput schema / properties / brand_id / description
      Previous value: -"Brand reference from list_brands (e.g. the returned brand id)."New value: +"Brand id from list_brands."
    • changedInput schema / properties / cursor / anyOf
      Previous value: -[
      -  {
      -    "description": "Continuation handle from the same tool and filters; absent for the first page.",
      -    "maxLength": 24000,
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "next_cursor from the previous page of the same tool and filters; absent for the first page.",
      +    "maxLength": 24000,
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / cursor / description
      Previous value: -"Continuation handle from the same tool and filters; absent for the first page."New value: +"next_cursor from the previous page for the same brand and type; absent or null for the first page."
    • changedInput schema / properties / page_size / description
      Previous value: -"Number of rows in this page, constrained by the field maximum."New value: +"Images per page, 1 to 24."
    • changedInput schema / properties / response_format / description
      Previous value: -"Output format: text or json for capped research examples; table is available only for tracked rival rows."New value: +"Output format: text (default) or json. table is not available for this tool."
  3. Changed2 schema fields changed
    • changedOutput schema / properties / allowance / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "description": "Daily scanned-row allowance for this workspace, resetting at midnight UTC.",
      -    "properties": {
      -      "daily_limit": {
      -        "description": "Maximum scanned rows allowed per UTC day.",
      -        "type": "number"
      -      },
      -      "remaining": {
      -        "description": "Scanned rows still available today.",
      -        "type": "number"
      -      },
      -      "resets_at": {
      -        "description": "ISO timestamp when the allowance or credits reset.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "daily_limit",
      -      "remaining",
      -      "resets_at"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "description": "Free daily ad-return allowance for this workspace, resetting at midnight UTC.",
      +    "properties": {
      +      "daily_limit": {
      +        "description": "Maximum free ad examples returned per UTC day.",
      +        "type": "number"
      +      },
      +      "remaining": {
      +        "description": "Free ad examples still available today.",
      +        "type": "number"
      +      },
      +      "resets_at": {
      +        "description": "ISO timestamp when the allowance or credits reset.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "daily_limit",
      +      "remaining",
      +      "resets_at"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / allowance / description
      Previous value: -"Daily scanned-row allowance for this workspace, resetting at midnight UTC."New value: +"Free daily ad-return allowance for this workspace, resetting at midnight UTC."
  4. First observed

TDQS

A3.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true and destructiveHint=false, so the safety profile is covered. The description adds useful behaviour beyond that: pagination cadence ('up to 24 per page with next_cursor'), the field set of each returned asset, and the negative clarification that it neither uploads nor analyzes. It does not cover ordering, whether archived/missing assets appear, or error behaviour.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the verb and scope, with no filler. The second sentence is compressed into a chain of appositives ('The source of asset_id ... and of product_image_id ...'), which is efficient but slightly dense; the colon-heavy field enumeration packs a lot into one clause.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema, so the description correctly carries the return-value burden by enumerating every field and the pagination contract, which is the essential information for this tool. Minor gaps remain around ordering and edge cases (e.g. brands with no assets, expired cursors), but nothing that would cause a wrong call.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so brand_id, cursor, page_size, asset_type and response_format are all documented in the schema itself. The description echoes the 24-per-page cap and the type vocabulary but adds no filtering, default, or format detail beyond what the schema states. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Lists one brand's stored images') and immediately enumerates the returned fields (id, type, URL, description, tags, primary flag), so an agent knows exactly what this produces. The scope qualifier 'one brand's' plus the note that it is the source of asset_id for brand image tools separates it from list_brands and the mutating asset tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The definition gives clear positive context ('source of asset_id for the brand image tools and of product_image_id for campaigns') and signals the boundary with uploads ('uploads and analyzes nothing'), which points an agent to upload_brand_asset for writes. It stops short of an explicit when-not-to-use/alternative clause naming the sibling to call for other image operations.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.