# post_slideshow

> Post a slideshow with Wavegrain's MCP server: the post_slideshow tool needs the post permission. Inputs, outputs and an example call.

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

**Post a slideshow.** Permission: `post`. Changes saved work.

Prepare a post of a slideshow, now or later, to connected accounts. It sends nothing and you cannot send it: the person confirms it with the Post button of the chat card, or at confirmUrl. Never make a choice a network asks the user to make (TikTok visibility, YouTube privacy and made-for-kids). At most 20 posts per key a day. No LinkedIn yet. With no connected account, give the user get_connect_link instead.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `slideshowId` | string | yes | A slideshow id from list_slideshows or a make tool. up to 200 characters |
| `accountIds` | string[] | yes | Connected accounts from list_accounts, one post each. up to 10 items |
| `at` | string | no | When to post. Leave it out to post now. |
| `caption` | string | no | The post text. Default: the slideshow's saved caption. up to 5000 characters |
| `signature` | string | no | The brand's caption signature is added at the end of each caption by default (get_brand, captionSignature). Pass the words the user wants instead for this post, or an empty string when they want it left off. up to 500 characters |
| `aiGenerated` | boolean | no | Label the post as having AI images. Default: true when any slide has one. |
| `tiktok` | object | no | Needed for a TikTok account: ask the user each choice. |
| `youtube` | object | no | Needed for a YouTube account. |
| `pinterest` | object | no | Needed for a Pinterest account: the board to pin to. |

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 |
| --- | --- | --- |
| `slideshowId` | string | The slideshow. |
| `posts` | object[] | What goes where and when, per account. |
| `needs` | string[] | Choices the person makes in the card (TikTok), or tells you (YouTube), before it can be posted. |
| `confirmUrl` | string | Where the person confirms in Wavegrain when no card shows in the chat. |
| `note` | string | What to do next: nothing is posted until the person confirms. |

## Example call

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

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "post_slideshow",
    "arguments": {
      "slideshowId": "<slideshowId>",
      "accountIds": [
        "<accountId>"
      ]
    }
  }
}
```

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

## Related tools

- [`confirm_post_slideshow`](/developers/mcp-tools/confirm_post_slideshow): Post the confirmed slideshow
- [All 79 tools](/developers/mcp-tools)
