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

InputTypeRequiredNotes
namestringyesHow the user will find it. up to 80 characters
brandIdstringnoDefault: your active brand. up to 200 characters
structure"hook-proof-cta" | "listicle" | "before-after" | "educational" | "story" | "quote" | "ranking"yesThe 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.
slideCountintegernoHow 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"noSlide 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"noText 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).
hookExamplesstring[]noHook lines to rotate over the posts made with it. up to 30 items
contentDirectionstringnoWhat the middle slides should do, such as give one tip each or tell the story step by step. up to 800 characters
ctastringnoYour own closing line. Use ctaCardId for a saved CTA card instead. up to 160 characters
ctaCardIdstringnoA CTA card from get_brand to close with. up to 200 characters
emoji"none" | "auto" | "expressive"noHow much the slide text uses emoji: none, auto or expressive. default "none"
bodyLength"short" | "default" | "long"noHow 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

FieldTypeNotes
formatIdstringThe saved format's id, for generate_slideshow.
namestringIts name.
brandIdstringThe brand it writes for.
notestringWhat 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.

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