MCP/Tools/Library/list_media
list_media

List media library

Free

List images saved to the media library, most recent first. Default filter is bookmarked only.

How it works

Pass savedOnly: false to see every image ever generated, including ones not explicitly saved. Optionally filter by brandId.

Inputs

Name
Type
Required
Description
limit
integer (1–100)
optional
Default 50.
savedOnly
boolean
optional
Default true — only bookmarked items.
brandId
string
optional
Filter by brand.

Returns

{ media: MediaItem[], count }

Examples

Find every Plug Motors image

Agent needs all Plug visuals to bundle into a quarterly recap.

{
  "brandId": "aBmbZETe9gUZhwXHCE02",
  "savedOnly": false,
  "limit": 100
}