ACE Carousel Creator
Documentation
Plugin version 0.2.0.
ACE Carousel Creator turns a topic, your draft copy, or your own photographs into an editable carousel project for ACE: Aesthetic Carousel Editor on iPhone and iPad. Your AI assistant writes the copy and lays out the slides. The service checks the layout against ACE's native format and packages it as a .carousel file. Text, shapes, photo slots, photo grids, frames and stickers stay editable after you import the file into ACE.
1. Connect
The service is a remote MCP server at https://mcp.quokka.software/mcp. It needs no account, sign-in or API key.
- Claude. Add ACE Carousel Creator from the Claude directory. Before it is listed there, you can add it under Customize → Connectors → Add custom connector with the server URL above and no authentication. In a chat, turn the connector on from + → Connectors.
- ChatGPT and Codex. Add the ACE Carousel Creator plugin in ChatGPT or Codex.
- Other MCP clients. Connect to the server URL over Streamable HTTP.
2. Create a carousel
Ask in your own words. For example:
- Create a 5-slide 4:5 carousel about choosing a first road bike, in a calm editorial style.
- Use this exact copy for 3 slides and leave a photo slot on each slide.
- Make a square photo-grid carousel with four photos per slide and short captions.
The assistant returns a download link for the .carousel file and, when previews are available, a contact sheet of the slides. Download links expire one hour after creation.
3. Open the project in ACE
- Download the
.carouselfile to your iPhone or iPad, or move it there through Files or AirDrop. - In ACE, choose Projects → Import or Templates → Import and select the file.
- Edit the text, photos, shapes, stickers and frames, then export the slides as images for sharing.
A download link does not open ACE by itself. Review the imported project in ACE before you publish it.
4. Tools
| Tool | What it does |
|---|---|
get_carousel_spec | Returns the format rules, writing and design guides, the catalog of fonts, frames, grids, shapes and stickers, complete examples, and the server's capabilities. Read only. |
validate_carousel | Checks a layout and returns errors and non-blocking warnings without creating a file. Read only. |
create_carousel | Validates the layout, packages the editable .carousel project with the supplied photographs, and returns a download link and, when available, slide previews. |
render_carousel | Draws PNG previews of every slide for checking the layout before the final file is created. |
prepare_photo_upload | Reserves one-time upload links for photographs that the client sends from your computer. |
5. Photographs
- ChatGPT attachments. ChatGPT passes file references for photos you attach, and the server downloads only those files.
- Photos on your computer. A client that can run commands, such as Claude Code or Codex, calls
prepare_photo_upload, sends each file to its upload link with an HTTP PUT, and passes the returned IDs tocreate_carousel. Each link accepts one still JPEG, PNG, WebP or AVIF photograph up to 20 MiB and expires one hour after it is reserved. Keep upload links and IDs private. - Claude chat attachments. Photos attached in a Claude chat cannot reach the server. The project gets intentional empty photo slots that you fill in ACE.
The server rotates photographs to their stored orientation and removes embedded metadata before packaging them. It never serves uploaded photographs back.
6. Previews
The public server draws previews with ACE Portable, a Skia renderer that uses the frames, stickers and catalog fonts exported from the app. System fonts are replaced with bundled fonts, and text metrics and effect edges can differ slightly from export in the app. The response lists these differences as warnings. A preview helps check the layout; it is not a guarantee of the final look.
7. Limits
- 1 to 20 slides in square 1:1, portrait 4:5 or 3:4, story 9:16, or landscape 1.91:1.
- Up to 20 photographs per request; still images only. Video is not packaged.
- Text does not wrap automatically, so the assistant places line breaks itself.
- Projects and uploaded photographs are kept in server memory for up to one hour, or less if the server restarts. There is no permanent storage: save the file you need.
8. Privacy, terms and support
The Plugin Privacy Policy describes what the server processes and how long it keeps it. Use of the service is governed by the Plugin Terms of Use.
For help, write to support@quokka.software or visit quokka.software/support.