> ## Documentation Index
> Fetch the complete documentation index at: https://docs.covver.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools reference

> Every tool in the Covver Builder connector, grouped by what it is for.

You do not call these tools yourself. Your assistant picks them based on what you ask. This reference helps you understand what the assistant can do, and recognize a tool's name when the assistant asks for your approval.

All tools act only on the Covver account you connected. Tools marked **Changes content** can replace something that already exists, so your assistant may ask you to confirm first.

## Create and compose

| Tool | What it does | |
| - | - | - |
| `covver_list_presets` | Lists the page styles, content block types and layout options the layout engine understands. The assistant reads this once before composing. | |
| `covver_create_magazine` | Creates a new, empty magazine draft in your account. The default page size is 1000 × 1320 px, portrait; the assistant can set another size. | |
| `covver_compose_page` | Composes one page from content blocks and saves it. It can add a new page at the end or replace an existing one. Reports anything that did not fit. | Changes content |
| `covver_compose_issue` | Composes a whole magazine in one go, one entry per page from cover to back cover. Replaces all existing pages of that magazine. | Changes content |
| `covver_compose_spread` | Composes a two-page spread across facing pages, for example a photo that runs across both. Replaces both pages. The cover cannot be part of a spread. | Changes content |
| `covver_preview_magazine` | Renders the current pages and returns the read-only preview link. | |

## Work on existing magazines

| Tool | What it does | |
| - | - | - |
| `covver_list_magazines` | Lists your magazines, drafts and published, newest first, with their links. | |
| `covver_get_magazine` | Reads what is on each page: every element with its type, position and a snippet of its text. | |
| `covver_update_elements` | Edits existing elements: text, font, size, color, position, opacity, image, shape fill. Only what the assistant sends changes. | Changes content |
| `covver_delete_page` | Deletes one page by number. The remaining pages are renumbered. | Changes content |

## Templates

| Tool | What it does | |
| - | - | - |
| `covver_list_templates` | Lists Covver's curated templates and reference designs, and which kinds of page each offers (cover, contents, article, back cover and so on). | |
| `covver_inspect_template` | Shows the text and photo slots of one template page, so the assistant can write content of a fitting length. | |
| `covver_apply_template` | Fills a template page with your text and images and saves it as a page of your magazine. | Changes content |

## Photos and images

| Tool | What it does | |
| - | - | - |
| `covver_list_photos` | Lists the photos in your Covver library so the assistant can place them. | |
| `covver_request_photo_upload` | Creates a one-hour upload link where you add photos from your device to your library. Also used to hand over a design you want copied. | |
| `covver_upload_image` | Uploads an image the assistant itself holds to your library (PNG, JPEG or WebP, up to 6 MB). Most chat apps do not pass your attachments to connectors, so the upload link is the usual route. | |
| `covver_remove_background` | Cuts out the subject of a photo and returns a transparent version, optionally replacing the image on the page. | Changes content |
| `covver_edit_image` | Edits a photo on a page with AI: change a detail while keeping the scene, generate a new photo, or merge other photos from the same page into it. | Changes content |

## Reference designs

| Tool | What it does | |
| - | - | - |
| `covver_extract_reference` | Reads a cover or page design from an image and saves it as a private layout that only you can compose with. | |
| `covver_replicate_reference` | Reproduces a reference design as a page in one step: same layout and texts (or the ones you give), with the subject in front of the title when the reference does that. | Changes content |

## Interactive content

| Tool | What it does | |
| - | - | - |
| `covver_add_embed` | Embeds a public link as a live player on a page: YouTube, Vimeo, Spotify, SoundCloud, Instagram, TikTok, Google Maps, forms and similar. See [embeds](https://docs.covver.com/builder/embeds.md). | |
| `covver_add_widget` | Places a built-in widget: a game (hangman, tic-tac-toe, complete the lyrics) or an autoplaying photo carousel with 2 to 10 images. See [widgets](https://docs.covver.com/builder/widgets.md). | |
| `covver_add_custom_widget` | Writes a custom interactive widget (a countdown, poll, quiz, calculator and so on), saves it to **My widgets** and places it on a page. Custom widgets run isolated from the rest of the page. | |
| `covver_list_media` | Lists the videos and audio in your library. | |
| `covver_add_media` | Places one of your videos or audio files on a page. See [media](https://docs.covver.com/builder/media.md). | |
| `covver_set_page_lock` | Locks a page in the published magazine behind a 4-digit code, an email or phone step, a quiz or a payment, or removes the lock. See [page lock](https://docs.covver.com/builder/page-lock.md). | Changes content |

## Where photos come from

When a page needs a photo, the assistant chooses between three sources, in this order of preference:

1. **Your own photos**, from your library or an upload link.
2. **Free stock photos**, found by a short search and matched to the shape of the slot. A stock photo is not repeated within an issue.
3. **AI-generated photos**, used when you ask for generated imagery or the subject cannot exist in stock, such as your own product or an imagined scene.

A single page takes up to 6 stock photos and up to 3 AI-generated photos. Slots beyond that stay as placeholders. If the assistant recomposes a page with the same image description, the photo already generated for that magazine is reused instead of being generated again.

## Limits

| Limit | Value |
| - | - |
| Upload link lifetime | 1 hour |
| Photos through the upload link | PNG, JPEG or WebP, up to 15 MB each |
| Image sent directly by the assistant | PNG, JPEG or WebP, up to 6 MB |
| Editor link | Works once, expires after 10 minutes |
| Preview link | Valid for 30 days, updates as the magazine changes |
| Custom widget code | Under 60 KB |
| Page size | 300 to 4000 px per side |

> [!NOTE]
>
> Magazines made with Covver's earlier editor cannot be edited through the connector. The assistant tells you when a magazine is one of these.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.