post_slideshow

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

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

InputTypeRequiredNotes
slideshowIdstringyesA slideshow id from list_slideshows or a make tool. up to 200 characters
accountIdsstring[]yesConnected accounts from list_accounts, one post each. up to 10 items
atstringnoWhen to post. Leave it out to post now.
captionstringnoThe post text. Default: the slideshow's saved caption. up to 5000 characters
signaturestringnoThe 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
aiGeneratedbooleannoLabel the post as having AI images. Default: true when any slide has one.
tiktokobjectnoNeeded for a TikTok account: ask the user each choice.
youtubeobjectnoNeeded for a YouTube account.
pinterestobjectnoNeeded 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.

Returns

FieldTypeNotes
slideshowIdstringThe slideshow.
postsobject[]What goes where and when, per account.
needsstring[]Choices the person makes in the card (TikTok), or tells you (YouTube), before it can be posted.
confirmUrlstringWhere the person confirms in Wavegrain when no card shows in the chat.
notestringWhat 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 shows how to make one.

{
  "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.

Something wrong or missing? Write to support@wavegrain.com.