# save_format

> Save a slideshow format with Wavegrain's MCP server: the save_format tool needs the write permission. Inputs, outputs and an example call.

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

**Save a slideshow format.** Permission: `write`. Changes saved work.

Save a post set-up as a reusable format for a brand, for later posts and plan_week. Free.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `name` | string | yes | How the user will find it. up to 80 characters |
| `brandId` | string | no | Default: your active brand. up to 200 characters |
| `structure` | "hook-proof-cta" \| "listicle" \| "before-after" \| "educational" \| "story" \| "quote" \| "ranking" | yes | The kind of post: hook-proof-cta (Hook, proof, then a clear call to action); listicle (A numbered list); before-after (A transformation or comparison); educational (Teaches one idea step by step); story (A first-person narrative arc); quote (Quote or affirmation cards); ranking (Tier list or best-to-worst ranking); get_playbook gives each one's slides. |
| `slideCount` | integer | no | How many slides each post made with it has. 3 to 10, default 6 |
| `outputProfile` | "clean-square" \| "clean-portrait" \| "instagram-feed" \| "instagram-feed-3-4" \| "clean-vertical" \| "tiktok" \| "instagram-reels" | no | Slide size, width:height: clean-square 1:1, clean-portrait 4:5, instagram-feed 4:5 (default), instagram-feed-3-4 3:4, clean-vertical 9:16, tiktok 9:16, instagram-reels 9:16. |
| `styleId` | "clean-ugc" \| "clean-social" \| "quiet-editorial" \| "bold-statement" \| "mens-looksmaxxing" \| "comparison-grid" \| "study-notes" \| "aesthetic-soft" \| "accent-pop" | no | Text look: clean-ugc (Effortless lowercase native look); clean-social (Bold sans in normal case with a strong shadow); quiet-editorial (Serif); bold-statement (Big all-caps hook over a dramatic scene); mens-looksmaxxing (Dark portrait); comparison-grid (Before-after or best-worst decks); study-notes (Small clean caption low on a desk/flatlay); aesthetic-soft (Airy scene); accent-pop (Clean sans with a warm accent color). |
| `hookExamples` | string[] | no | Hook lines to rotate over the posts made with it. up to 30 items |
| `contentDirection` | string | no | What the middle slides should do, such as give one tip each or tell the story step by step. up to 800 characters |
| `cta` | string | no | Your own closing line. Use ctaCardId for a saved CTA card instead. up to 160 characters |
| `ctaCardId` | string | no | A CTA card from get_brand to close with. up to 200 characters |
| `emoji` | "none" \| "auto" \| "expressive" | no | How much the slide text uses emoji: none, auto or expressive. default "none" |
| `bodyLength` | "short" \| "default" \| "long" | no | How much body text each slide gets: short, the default length, or long. default "default" |

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 |
| --- | --- | --- |
| `formatId` | string | The saved format's id, for generate_slideshow. |
| `name` | string | Its name. |
| `brandId` | string | The brand it writes for. |
| `note` | string | What to tell the user. |

## Example call

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

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "save_format",
    "arguments": {
      "name": "<name>",
      "structure": "hook-proof-cta"
    }
  }
}
```

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

## Related tools

- [`update_brand_settings`](/developers/mcp-tools/update_brand_settings): Change brand settings
- [`propose_brand_change`](/developers/mcp-tools/propose_brand_change): Propose a brand change
- [`propose_group_change`](/developers/mcp-tools/propose_group_change): Propose a group change
- [`rename_slideshow`](/developers/mcp-tools/rename_slideshow): Rename a slideshow
- [`delete_slideshow`](/developers/mcp-tools/delete_slideshow): Delete a slideshow
- [`update_collection`](/developers/mcp-tools/update_collection): Rename a collection
- [All 79 tools](/developers/mcp-tools)
