list_media

mcp:readread-only

List the workspace's media library, newest first, to reuse an image, carousel or video in a new post. collection 'uploads' is files uploaded or imported; 'on_brand' is branded images, carousels and app screenshots rendered for the workspace; 'all' (default) is both. kind narrows to image, video or carousel.

Each item's asset can be passed as media to create_draft_post or update_post as it is. Returns { items, page, limit, total, hasMore, counts }: limit is per page (default 60, max 100), page is 1-based; call again with page + 1 while hasMore is true.

Input

• collectionstring

  one of all, uploads, on_brand · default "all"

• kindstring

  one of all, image, video, carousel · default "all"

• pageinteger

  1-based page number. Use with limit; hasMore says whether another page exists.

  min 1 · default 1

• limitinteger

  min 1 · max 100 · default 60

Permission

Needs the mcp:read scope: view your workspace. It only reads, so assistants can call it without asking.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_media",
    "arguments": {}
  }
}

Same action over the REST API

The tool runs GET /v1/orgs/{orgId}/marketing/media as the signed-in user, with the same validation, approval rules and limits. See it in the Media API reference.