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
| Input | Type | Required | Notes |
|---|---|---|---|
url | string | no | The post to copy: an Instagram post or reel, a TikTok photo post, or an X post. up to 500 characters |
styleId | string | no | A 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 |
topic | string | no | What 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 |
slideCount | integer | no | How many slides the copy has. Default: as many as the copied post (7 for a reel). 3 to 12 |
brandId | string | no | Whose voice, colours and CTA. Default: your active brand. up to 200 characters |
aiImages | integer | no | How 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 |
maxCredits | integer | yes | The most credits this call may spend. It is 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 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
| Field | Type | Notes |
|---|---|---|
jobId | string | Pass to get_generation_status to follow it. |
state | "being_made" | The copy started. |
creditsReserved | number | The most this copy can cost; only what it really costs is charged, and nothing if no slideshow is made. |
note | string | What to do next. |
summary | string | One 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.
Related tools
create_tailored_slideshow: Make a tailored slideshowremove_background: Cut out a photogenerate_image: Make an AI imagegenerate_slideshow: Make a slideshowcreate_brand_from_website: Make a brand from a websiteresume_automation: Resume an automation- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.