# 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.

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

**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](/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](/developers/authentication) shows how to make one.

```json
{
  "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`](/developers/mcp-tools/copy_post): Copy a post
- [`remove_background`](/developers/mcp-tools/remove_background): Cut out a photo
- [`generate_image`](/developers/mcp-tools/generate_image): Make an AI image
- [`generate_slideshow`](/developers/mcp-tools/generate_slideshow): Make a slideshow
- [`create_brand_from_website`](/developers/mcp-tools/create_brand_from_website): Make a brand from a website
- [`resume_automation`](/developers/mcp-tools/resume_automation): Resume an automation
- [All 79 tools](/developers/mcp-tools)
