copy_post

Copy a post with Wavegrain's MCP server: the copy_post tool needs the generate permission. Inputs, outputs and an example call.

Copy a post. Permission: generate. Changes saved work.

Quick mode, only when the user wants Wavegrain to write it for them in one step. To copy a post, the default is fetch_reference, list_styles, search_images, then create_tailored_slideshow with your own words. Give an Instagram post or reel, a TikTok photo post or an X post. Wavegrain copies the look into a saved style, retells the post's subject (or your topic) in new words in the brand's voice, finds real photos, and makes the slides; it never reuses the post's words, photos or branding. It answers a jobId at once: poll get_generation_status about every 20 seconds until it is ready (one to two minutes). Costs 2 credits, charged only when the slideshow is made; copying the look is free, and a post copied before reuses its look. State the cost first. For another post in the same look, call it again with the styleId get_generation_status answers and a topic. Change the result with edit_tailored_slideshow.

Inputs

InputTypeRequiredNotes
urlstringnoThe post to copy: an Instagram post or reel, a TikTok photo post, or an X post. up to 500 characters
styleIdstringnoA saved tailored style to reuse instead of copying a new look, such as the styleId an earlier copy_post answered. With it, url is optional. up to 200 characters
topicstringnoWhat the new post is about. Leave out to retell the copied post's own subject in new words. Required when there is no url. up to 300 characters
slideCountintegernoHow many slides the copy has. Default: as many as the copied post (7 for a reel). 3 to 12
brandIdstringnoWhose voice, colours and CTA. Default: your active brand. up to 200 characters
aiImagesintegernoHow many AI images it may make when no real photo fits; each costs extra credits. 0 uses real photos only. 0 to 2, default 0
maxCreditsintegeryesThe most credits this call may spend. It is refused, spending nothing, if it could cost more. 0 to 1000
idempotencyKeystringnoOptional: your own unique id, such as a UUID. The same key within 24 hours returns the first job and charges nothing again. up to 200 characters

The fields inside an object or a list are in the JSON Schema at /developers/mcp-tools.json.

Returns

FieldTypeNotes
jobIdstringPass to get_generation_status to follow it.
state"being_made"The copy started.
creditsReservednumberThe most this copy can cost; only what it really costs is charged, and nothing if no slideshow is made.
notestringWhat to do next.
summarystringOne line for the user.

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": "copy_post",
    "arguments": {
      "maxCredits": 1
    }
  }
}

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

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