# list_slideshows

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

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

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

Slideshows newest first, up to 50 a page, with status, review state, schedule and link; pass nextOffset as offset for the next page.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `limit` | integer | no | How many slideshows to return. 1 to 50, default 20 |
| `offset` | integer | no | How many to skip: the nextOffset of the previous page. 0 to 10000, default 0 |

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 |
| --- | --- | --- |
| `slideshows` | object[] | Slideshows, newest first. |
| `nextOffset` | number \| null | Pass as offset for the next page; null on the last page. |

## 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_slideshows",
    "arguments": {}
  }
}
```

## Related tools

- [`get_brand_brief`](/developers/mcp-tools/get_brand_brief): Get a brand brief
- [`list_formats`](/developers/mcp-tools/list_formats): List slideshow formats
- [`get_format`](/developers/mcp-tools/get_format): Get a slideshow format
- [`get_slideshow`](/developers/mcp-tools/get_slideshow): Get a slideshow
- [`list_calendar`](/developers/mcp-tools/list_calendar): List the calendar
- [`list_collections`](/developers/mcp-tools/list_collections): List image collections
- [All 79 tools](/developers/mcp-tools)
