# schedule_slideshows

> Schedule slideshows with Wavegrain's MCP server: the schedule_slideshows tool needs the write permission. Inputs, outputs and an example call.

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

**Schedule slideshows.** Permission: `write`. Changes or removes saved work.

Put one or up to 14 slideshows on the Calendar, or move them, with their account groups; to shift several by the same days, use move_scheduled. It does not post: a post goes out when the owner sends it, when a slot the owner approves in Wavegrain reaches its time while automatic posting is on, or through post_slideshow after the person confirms. A post the user confirmed keeps its time unless this key has the post permission. Moving an approved slideshow or changing its groups withdraws its approval. One bad item schedules nothing. Answers targets and warnings to tell the user. dryRun saves nothing. unschedule_slideshow undoes it; a withdrawn approval stays withdrawn.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `items` | object[] | yes | Each slideshow once, with its time and optional groups, for example plan_week's slots. up to 14 items |
| `dryRun` | boolean | no | True: answer what would happen and save nothing. Show the user, then call again without it. |

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 |
| --- | --- | --- |
| `scheduled` | object[] | Each slideshow scheduled, with where it posts. |
| `failed` | object[] | Items that changed between the check and the write; the others were scheduled. |
| `dryRun` | true | Present on a dry run: nothing was saved. |

## Example call

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

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "schedule_slideshows",
    "arguments": {
      "items": [
        {
          "slideshowId": "<slideshowId>",
          "at": "<at>"
        }
      ]
    }
  }
}
```

The call shows only the required inputs, with placeholder values: put your own in.

## Related tools

- [`move_scheduled`](/developers/mcp-tools/move_scheduled): Move planned posts
- [`unschedule_slideshow`](/developers/mcp-tools/unschedule_slideshow): Unschedule a slideshow
- [`edit_slides`](/developers/mcp-tools/edit_slides): Edit slides
- [`save_images`](/developers/mcp-tools/save_images): Save images to the library
- [`open_upload`](/developers/mcp-tools/open_upload): Open a drop zone for photos
- [`import_image`](/developers/mcp-tools/import_image): Import an image from a URL
- [All 79 tools](/developers/mcp-tools)
