create_tailored_slideshow

Make a tailored slideshow with Wavegrain's MCP server: the create_tailored_slideshow tool needs the generate permission. Inputs, outputs and an example call.

Make a tailored slideshow. Permission: generate. Changes saved work.

The main way to make a post: a slideshow from a tailored style and your slides' words and images, written from get_brand_brief, with hooks for slide 1. Costs 1 credit, refunded if it cannot be made.

Inputs

InputTypeRequiredNotes
styleIdstringnoThe style that sets the layout and look, from list_styles. Default: the brand's pinned style for purpose. up to 200 characters
purpose"educational" | "list" | "story" | "news" | "product" | "quote"noOnly without styleId: what kind of post this is.
brandIdstringnoDefault: your active brand. up to 200 characters
titlestringyesThe slideshow's title in Wavegrain, naming its subject. up to 120 characters
captionstringnoThe caption posted with the slideshow. up to 2200 characters
slidesobject[]yesEach slide in order: a layout of the style and its slot values. up to 20 items
referenceIdstringnoThe fetch_reference this copies; its words are checked against it. up to 200 characters
hooksobjectnoTwo other wordings of slide 1's hook, each from another angle (get_playbook), so the user can switch with edit_tailored_slideshow set_hook.
maxCreditsintegeryesMost credits this call may spend; refused, spending nothing, if it could cost more. 0 to 1000
idempotencyKeystringnoOptional: your own unique id, such as a UUID. The same key within 24 hours returns the first slideshow and charges nothing again; send it again when a call timed out. up to 200 characters

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

Returns

FieldTypeNotes
slideshowIdstringThe tailored slideshow id.
titlestringIts title.
versionnumberThe version this answer is about; each change makes a new one.
status"being_made" | "ready" | "failed"being_made (call get_tailored_slideshow later), ready or failed.
linkstringOpens the slideshow in Wavegrain. Give the user this link.
sheetUrlstring | nullOne image with every slide, numbered; null until ready.
slidesobject[]Each finished slide image; empty until ready.
problemsobject[]Layout problems found when it was made; fix them with edit_tailored_slideshow.
errorstring | nullWhy it failed; null unless status is failed.
styleIdstringThe style it uses.
styleVersionnumberThe style version it was made with.
creditsChargednumberCredits this call spent.
notestringWhat to do next.
summarystringOne line for the user: the title, the slide count and the state.
hooksobject | nullOther hooks for slide 1, written with the words. Switch with edit_tailored_slideshow {op: "set_hook", hookId}; free.

Example call

Send it to POST https://wavegrain.com/api/mcp with an access key that has the generate permission; Authentication shows how to make one.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_tailored_slideshow",
    "arguments": {
      "title": "<title>",
      "slides": [
        {
          "layout": "<layout>"
        }
      ],
      "maxCredits": 1
    }
  }
}

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

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