# copy_post

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

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

**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](/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](/developers/authentication) shows how to make one.

```json
{
  "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`](/developers/mcp-tools/create_tailored_slideshow): Make a tailored slideshow
- [`remove_background`](/developers/mcp-tools/remove_background): Cut out a photo
- [`generate_image`](/developers/mcp-tools/generate_image): Make an AI image
- [`generate_slideshow`](/developers/mcp-tools/generate_slideshow): Make a slideshow
- [`create_brand_from_website`](/developers/mcp-tools/create_brand_from_website): Make a brand from a website
- [`resume_automation`](/developers/mcp-tools/resume_automation): Resume an automation
- [All 79 tools](/developers/mcp-tools)
