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.
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.
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 shows how to make one.
{
"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: Change brand settingspropose_brand_change: Propose a brand changepropose_group_change: Propose a group changerename_slideshow: Rename a slideshowdelete_slideshow: Delete a slideshowupdate_collection: Rename a collection- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.