# list_collections

> List image collections with Wavegrain's MCP server: the list_collections tool needs the read permission. Inputs, outputs and an example call.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**List image collections.** Permission: `read`. Read-only: changes nothing.

Image collections (up to 100), optionally for one brand: id, name, description, which slides they feed, brand and image count. Read one with list_collection_images.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `brandId` | string | no | A brand id from list_brands: only that brand's collections. Default: all. up to 200 characters |

The fields inside an object or a list are in the JSON Schema at [/developers/mcp-tools.json](/developers/mcp-tools.json).

## Returns

| Field | Type | Notes |
| --- | --- | --- |
| `collections` | object[] | Image collections, at most 100. |
| `truncated` | boolean | True when there were more than 100 and the rest were left out. |

## Example call

Send it to `POST https://wavegrain.com/api/mcp` with an access key that has the `read` permission; [Authentication](/developers/authentication) shows how to make one.

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

## Related tools

- [`list_slideshows`](/developers/mcp-tools/list_slideshows): List slideshows
- [`get_slideshow`](/developers/mcp-tools/get_slideshow): Get a slideshow
- [`list_calendar`](/developers/mcp-tools/list_calendar): List the calendar
- [`list_collection_images`](/developers/mcp-tools/list_collection_images): List a collection's images
- [`get_credits`](/developers/mcp-tools/get_credits): Get credits
- [`list_creators`](/developers/mcp-tools/list_creators): List AI creators
- [All 79 tools](/developers/mcp-tools)
