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
| Input | Type | Required | Notes |
|---|---|---|---|
styleId | string | no | The 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" | no | Only without styleId: what kind of post this is. |
brandId | string | no | Default: your active brand. up to 200 characters |
title | string | yes | The slideshow's title in Wavegrain, naming its subject. up to 120 characters |
caption | string | no | The caption posted with the slideshow. up to 2200 characters |
slides | object[] | yes | Each slide in order: a layout of the style and its slot values. up to 20 items |
referenceId | string | no | The fetch_reference this copies; its words are checked against it. up to 200 characters |
hooks | object | no | Two other wordings of slide 1's hook, each from another angle (get_playbook), so the user can switch with edit_tailored_slideshow set_hook. |
maxCredits | integer | yes | Most credits this call may spend; refused, spending nothing, if it could cost more. 0 to 1000 |
idempotencyKey | string | no | Optional: 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
| Field | Type | Notes |
|---|---|---|
slideshowId | string | The tailored slideshow id. |
title | string | Its title. |
version | number | The 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. |
link | string | Opens the slideshow in Wavegrain. Give the user this link. |
sheetUrl | string | null | One image with every slide, numbered; null until ready. |
slides | object[] | Each finished slide image; empty until ready. |
problems | object[] | Layout problems found when it was made; fix them with edit_tailored_slideshow. |
error | string | null | Why it failed; null unless status is failed. |
styleId | string | The style it uses. |
styleVersion | number | The style version it was made with. |
creditsCharged | number | Credits this call spent. |
note | string | What to do next. |
summary | string | One line for the user: the title, the slide count and the state. |
hooks | object | null | Other 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.
Related tools
copy_post: Copy a postremove_background: Cut out a photogenerate_image: Make an AI imagegenerate_slideshow: Make a slideshowcreate_brand_from_website: Make a brand from a websiteresume_automation: Resume an automation- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.