MCP server

list_designs

Lists the slideshow designs (templates) with id, name, ratio and slide roles. Use it first to find the design_id that create_slideshow needs.

No inputs.

Returns: The count and the designs: id, name, ratio and slide roles.

Note: Read-only.

list_collections

Lists the image collections of the library with id, name and image count. Use it to find a collection_id for create_slideshow, import_images or search_library.

No inputs.

Returns: The count and the collections: id, name and image count.

Note: Read-only.

list_slideshows

Lists slideshows, newest edit first, with id, title, slide count and dates. Use it to find a slideshow_id; filter by account, platform, published state, creation day (from/to, YYYY-MM-DD) or words.

Returns: The total number of matches, how many are shown, and the slideshow items (id, title, slides, account, dates).

Note: Read-only.

get_slideshow

One slideshow slide by slide: every text box (id, role, text, box), every picture slot (id, image ids per cell) and shape, the background image and the last export. Use it before editing to get slide numbers and element ids.

Returns: The slideshow slide by slide: text boxes (id, role, text, box), picture slots (id, image ids per cell), shapes, background, and the last export.

Note: Read-only. Fails with a hint to use list_slideshows if the id does not exist.

search_library

Searches Fyslide's image library by words (tags, subject, file and collection names), best match first. Use it to find an image_id for replace_slide_image.

Returns: The total and the best matches: image id, size, subject and tags.

Note: Read-only.

get_job

Status of a job another tool started (create_slideshow, generate, export_slideshow, the screenshot tools): status, step, progress, the result once done and the next action. Answers at once; use wait_for_job to block until it finishes.

Returns: The job's status (queued, running, needs_input, done, failed, cancelled), its step, the result once done and the next action.

Note: Read-only. Answers at once.

wait_for_job

Blocks until a job finishes or needs the owner (or timeout_seconds pass, default 60, max 300), then answers status and result like get_job. Use it after create_slideshow, generate or export_slideshow instead of polling; if it answers running, call it again.

Returns: Like get_job, after waiting until the job is no longer running or timeout_seconds have passed.

Note: Read-only. If the answer is still running, call it again.

list_planned_posts

Lists the slideshows on the owner's Planner calendar, soonest first: id, slideshow, date and time, account and status (planned, posting, posted, failed, missed, attention). Filter by day (from/to, YYYY-MM-DD, both included).

Returns: The count and the planned posts: id, slideshow, date and time, account, status and whether a TikTok post is scheduled.

Note: Read-only.

create_slideshow

Starts a job that fills a design with a topic's slides and pictures (the writing uses the app's text provider; Manual mode uses templates). Answers a job_id at once: follow it with wait_for_job. A paid run answers its cost and a confirm token first; items that do not fit the design answer a question.

Returns: A job_id and the job's first state; a plan with a confirm token for paid runs; a question when the items do not fit the design.

Note: Start of the job pattern: follow the job_id with wait_for_job. With the Manual text provider nothing is paid and no AI is used.

rebuild_from_screenshots

Use when the owner has screenshots of a post to copy: rebuilds that design 1:1 with the owner's own words. Step 1 { paths, prompt, collection_id? } → fonts; step 2 { job_id, fonts? } → the plan to review; step 3 { job_id, build: true } after the owner's yes → a job to follow with wait_for_job.

Returns: Step 1: font candidates. Step 2: the plan to review. Step 3: a job that builds the slideshow.

Note: Show the plan to the owner before building.

design_from_screenshots

Use when the owner wants a reusable design that looks like some post screenshots. Step 1 { paths }: the font candidates per text look (about a minute). Step 2 { job_id, fonts? }: picks them (default: the top ones) → the design_id for create_slideshow.

Returns: Step 1: font candidates per text look. Step 2: the new design_id.

Note: Two steps; the second may be skipped to take the top fonts.

import_images

Use to add pictures to Fyslide's library: absolute file paths, folders (read recursively, image files only) and/or http(s) links. Optionally into a collection. Answers how many were imported plus the image_ids to use with replace_slide_image.

Returns: How many pictures were imported, how many were duplicates, which failed, and the image_ids.

Note: Folders are read recursively; only image files are taken.

export_slideshow

Use to get the finished pictures: renders a slideshow into a NEW folder inside the owner's chosen export folder (Settings → Export; until one is chosen, an Exports folder in the app's own data folder) and answers the folder, the image file paths, the zip and small previews. The app's remembered export options stay as they are.

Returns: The export folder, the image file paths, the zip, the format and small previews. A long export answers a job_id instead.

Note: Exports go to the folder chosen in Settings → Export; a new folder is made each time.

generate

Use to redo the AI work on an EXISTING slideshow: what=text rewrites slide texts with the app's text provider; what=images puts new pictures in the picture slots (source=collection takes the next unused pictures of the slideshow's collection, free; source=ai makes new ones with OpenAI, paid). Whole slideshow or only the given slides. Answers a job_id (follow with wait_for_job); a paid run answers its cost and a confirm token first. Result is saved with a version.

Returns: A job_id (a paid run answers a plan with a confirm token first). When the job is done its result lists what changed.

Note: Works on a slideshow that already exists. The result is saved with a version before and after, so the owner can undo it in the editor.

update_slide_text

Use to set new words in one text box of a slide, found by element_id or by role (title, subtitle, body, label, number). Ids and roles come from get_slideshow. Saved at once, with a version before the change.

Returns: The old and new text of the box.

Note: Saved at once, with a version before the change.

update_slide_element

Use to adjust one element of a slide (text, picture frame, cut-out, shape, overlay): position and size in % of the canvas, rotation, and the common look (text size, font, colour, alignment; picture fit, corner radius, mirroring; shape colour and opacity). Give only what changes. Elements locked with the position lock keep their place; an element locked in the design is the post's own and can be changed. Saved at once, with a version.

Returns: The element's new box in % of the canvas.

Note: Saved at once, with a version. Locked elements keep their position and size.

replace_slide_image

Use to put a different picture into one picture slot of a slide. Give ONE source: image_id (library, see search_library), file_path (absolute path on this Mac) or url (http/https) – files and links are imported first. With none, the first unused picture of the slideshow's collection is used. A phone mockup takes the picture into its screen. Saved at once, with a version.

Returns: The new image id in the slot (and what was imported), with a small preview.

Note: Saved at once, with a version. A phone mockup takes the picture into its screen.

confirm

Use ONLY after the owner said yes to a plan that create_slideshow, generate or rebuild_from_screenshots answered with a token: carries out exactly that plan and spends the money it named. A token works once and expires after 15 minutes.

Returns: The result of the confirmed action, as the original tool describes it.

Note: Can spend money. Marked as a destructive tool. Only call it after the owner explicitly agreed.

plan_post

Use to put a finished slideshow on the Planner calendar at a date and time, optionally for one of the owner's accounts (account_id from list_slideshows or the app). It only plans: nothing is posted. The same slideshow cannot be planned twice for the same account and time.

Returns: The new plan: id, slideshow, date and time, account, status.

Note: Only plans; nothing is posted. The same slideshow twice for the same account and time is refused.

move_planned_post

Use to change the date and time of a post on the Planner calendar (plan_id from list_planned_posts). A missed or failed plan becomes a normal plan again; a new time removes a TikTok schedule (schedule it again in the app). It only changes the plan; nothing is posted.

Returns: The plan with its new date and time.

Note: Only changes the plan; nothing is posted.

remove_planned_post

Use to take a post off the Planner calendar (plan_id from list_planned_posts). The slideshow itself is not touched. A scheduled TikTok post that is removed will not be sent.

Returns: A confirmation with the plan id.

Note: Removes the plan only; the slideshow stays. Marked as a destructive tool.