Slidefast

Ask the AI to write or edit the deck. Read the mode rule before calling. **default mode is a dry run for EDITS, but a CREATE still creates.** - `mode="default"` (the default): edits to existing slides come back as `suggestions[]` and are NOT saved. Show them to the user, then re-send the same message with `mode="apply"` to commit. - `mode="apply"`: the edits are written to the deck immediately and come back as `changes[]` (`type` is add, modify, delete or reorder). - The one exception: when the turn writes a WHOLE deck ("make me a carousel about X"), that deck is saved even in default mode, because a creation is not a proposal. You will see `slides_generated: true`. Each turn costs one AI message against the account's monthly quota in both modes, so do not re-run a turn just to see the result twice. Returns (default mode): message_id, content, suggestions, citations, hooks, slides_generated, slides, model Returns (apply mode): message_id, content, presentation, changes, warnings, hooks, model

Check your current API rate limit status. Returns information about your daily and monthly API usage limits, current usage, and remaining quota. Returns: Dict with: - limits: Your rate limits (daily, monthly) - usage: Current usage counts - remaining: Remaining quota

Clear the conversation history for a presentation.

Create a new presentation. Creates an empty presentation that you can then populate with slides using the chat tool or by providing slides directly. Returns: Created presentation data including id, title, slides, theme, and timestamps

Create a project. Solo plans get 1 project, Agency up to 25.

Create a shareable client-approval link for a deck. Agency plan only. Give the returned `url` to the client: they open it logged out, read the deck, and either approve it or ask for changes. Calling this twice returns the same link rather than creating a second one. Then read `slidefast_get_review_thread` to see their answer. Do NOT poll it in a loop; check when the user asks, or once per session. On a Solo plan this fails with a 402 telling you to upgrade.

Create a theme in one project.

Delete an image from the library.

Delete a presentation. Permanently deletes the presentation and all associated data. This action cannot be undone. Returns: Confirmation message

Delete a theme.

Disable public sharing for a presentation.

Duplicate a presentation into a project.

Duplicate a theme into one project.

Enable public sharing and return the share token and URL path.

Export all slides as a single PDF document. Creates a professional PDF with all slides, suitable for printing or sharing as a document. Returns: Dict with: - url: Download URL for the PDF file - filename: Name of the file - size: Size in bytes - content_type: MIME type

Export all slides as a ZIP file containing PNG images. Each slide is exported as a separate PNG image in the ZIP file. Useful for sharing slides on social media or including in documents. Returns: Dict with: - url: Download URL for the ZIP file - filename: Name of the file - size: Size in bytes - content_type: MIME type

Export a single slide as a PNG image. Exports one specific slide as a high-quality PNG image. Useful for sharing individual slides or using as images. Returns: Dict with: - url: Download URL for the PNG image - filename: Name of the file - size: Size in bytes - content_type: MIME type

Generate AI background photos (no text, no faces) and add them to the library. Returns `{"images": [{"id", "url"}]}`; use a returned URL as a slide's `backgroundImage`. Each image costs one asset-quota unit.

Generate social metadata for sharing a presentation.

Show which project a call with these settings would act in. Use this to confirm scope before creating anything, especially when the key may be pinned to one client.

Get the project's brand kit: colours, fonts and logos. Read this before creating a theme or a deck for a client so the output matches their identity. Returns null when the project has no brand kit.

Get the conversation history for a presentation. Retrieves past chat messages between you and the AI for the specified presentation, useful for understanding context. Returns: Chat history with: - messages: List of message objects with id, role, content, suggestions, timestamps - total: Total number of messages

Get the authenticated account's name, email, and plan summary.

Get a presentation by its ID. Retrieves the full presentation including all slides, theme, and settings. Returns: Presentation data including id, title, description, slides, theme, display_settings, and timestamps

Get all distinct tags used by the project's presentations.

Get the deck's client review link, or null if it has none. Returns `url` (the page the client opens, no account needed), `token`, `status` (`pending`, `approved` or `changes_requested`), `reviewer_name` and `decided_at`.

Read the review status and everything the client wrote. `link` is null when no review link exists. `comments` is the thread, oldest first. When `link.status` is `changes_requested`, feed those comments to `slidefast_chat` as the edit brief.

Check which social platforms are connected and where you may publish. ALWAYS call this before publishing: it tells you whether a platform is connected and gives you the exact target identifiers the publish tools expect. Returns one block per platform (no access tokens are ever included): - linkedin: `targets` with `destination_type` ("profile" or "organization") and `organization_id` for Pages. - tiktok: `accounts`, plus `creator_info.privacy_level_options` — the only values a DIRECT_POST may use — and `direct_post_available`. - meta: `targets` with the `destination_id` to pass through, prefixed `facebook_page:` or `instagram:`. A user can connect SEVERAL accounts per platform. Every block carries an `accounts` array (each entry has an `account_id`, the targets it owns and, for TikTok, its own `creator_info`/`direct_post_available`), and every flat `target` repeats the `account_id` that owns it. When more than one account is listed, ask the user which one to publish from and pass that `account_id` to the publish tool — omitting it silently uses the most recently connected account. Social accounts belong to a project, so an agency reads a different set of connections per client. Pass the same `project_id` you publish with. A platform that is not connected returns `connected: false` and a `connect_url`. OAuth cannot be done through the API or this MCP server — the account owner has to open that URL in a browser and click Connect. Report the URL to the user instead of trying to authenticate.

Get one publish attempt — use this to poll a publish to completion. `status` moves `pending` -> `publishing` -> `published` or `failed`. When it is `published`, `external_post_url` links to the live post (empty for a TikTok draft, which is still sitting in the creator's inbox). When it is `failed`, `error_message` says why.

Get a theme by ID.

Ask TikTok directly what happened to a publish_id. `SEND_TO_USER_INBOX` means the draft is waiting in the creator's TikTok inbox (nothing public). `PUBLISH_COMPLETE` means it is live. `FAILED` comes with a `fail_reason`.

Get the authenticated user's monthly usage stats.

List images in the authenticated user's library.

List presentations in one project.

List the account's projects (one workspace per client). Presentations, themes, brand kits and social accounts all live inside a project. Pass a project id to any list or create tool to work in it; every other tool addresses rows by id and needs no project. Returns: Projects with id, name, slug, is_default, archived_at and counts

List publish attempts, newest first. Every attempt is recorded whether it succeeded or not, with its status, destination, `social_account_id`, external post URL and any error message.

List themes available in one project.

Publish a carousel to LinkedIn. THIS GOES PUBLIC — there is no draft mode. The post appears on the member's feed or the Page as soon as the render and upload finish, so confirm with the user before calling. LinkedIn has no inbox/draft equivalent of TikTok's MEDIA_UPLOAD. Call `slidefast_get_social_connections` first for the available targets. When it lists more than one LinkedIn account, ask which one and pass its `account_id`. Returns immediately with a social post record whose `status` is `pending` — poll `slidefast_get_social_post` until it becomes `published` or `failed`.

Publish a carousel to a Facebook Page or Instagram. THIS GOES PUBLIC. One tool for both networks, selected by the `destination_id` prefix. Neither has a draft mode here: the post is live once the background job finishes, so confirm with the user before calling. Instagram carousels are capped at 10 slides. When `slidefast_get_social_connections` lists more than one Meta account, ask which one and pass its `account_id` alongside a `destination_id` it owns. Returns a social post record; poll `slidefast_get_social_post`.

Publish a carousel to TikTok as a photo post — DRAFT by default. mode="MEDIA_UPLOAD" (the default) is SAFE: the slides are delivered to the creator's TikTok inbox as a draft. Nothing is published; the user finishes and posts it from the TikTok app. mode="DIRECT_POST" GOES PUBLIC IMMEDIATELY. Only pass it when the user asked for it explicitly, and pass a `privacy_level` taken from `creator_info.privacy_level_options` (also set `disable_comment=true` when `creator_info.comment_disabled` is true), otherwise the call is rejected. Returns a social post record; poll `slidefast_get_social_post`, or `slidefast_get_tiktok_publish_status` for TikTok's own view.

Revoke the review link. The URL stops working immediately.

Issue a new review token, killing the URL already sent to the client. Use it when a link leaked. The comment thread and decision history survive; only the URL changes, so the client needs the new one.

Search library images by semantic similarity.

Set a theme as the project's default.

Translate slides to a target language.

Update an existing presentation. You can update any combination of: title, description, slides, theme, or display settings. Only the fields you provide will be updated. Returns: Updated presentation data

Manually update social metadata for one platform.

Update a theme.

Upload a base64-encoded image to the user's library.

Upload a base64-encoded image for use in presentations.