Create with
your AI assistant.

1. Install with your agent

2. Create, edit & export

1. Read flamigo://themes, choose one color ID and one font ID, then pass color_preset_id and font_preset_id to create_presentation with the title and source material. Omit them to use color-navy-white and font-modern.
2. Use the returned presentation revision in draft_outline. Review the resulting sentences and layouts.
3. Read the current presentation revision, then pass the reviewed outline to generate_slides_from_outline to replace all pages and their checkpoints.
4. Read the presentation's /slides resource. For each slide with has_html=false, call render_slide with its own current revision.
5. Before exporting the latest content, check layout_content_current in each existing preview's slide detail. Refresh stale previews with render_slide. Once every slide is ready, read flamigo://presentations/{presentation_id}/export/html and save the returned HTML document.

To edit an existing slide, read its metadata and /dsl resource first. Use update_slide for content replacement, generate_slide_dsl for new structured content. Call render_slide after editing. Save a checkpoint before a design change you may want to undo. Refresh the web workspace to see MCP changes.

Change colors, fonts, layout style or art direction

Call update_presentation with the current presentation revision and the desired preset IDs, presentation_style or illustration_instruction. presentation_style selects the native component library and layout strategy: editorial (default), swiss or minimal. Generated illustrations are image components in the slide DSL. Existing illustrations are reused. The optional background_image_url sets a separate slide background; illustration_instruction guides newly generated illustrations (up to 4,000 Unicode characters). An empty string clears this instruction; omitted or null values leave it unchanged on update. Ask whether to refresh existing slides after a style change. Colors supply canvas, text and accent; the renderer derives the remaining roles. Fonts supply display and body as ordered fallback stacks, not lists of options to select separately.

If theme_changed is true, render each entry in slides_to_refresh with a new operation ID, the presentation ID, its slide ID, expected_revision and apply_project_theme. Existing illustration components are reused. Pending slides without HTML follow the normal generation workflow. Review the refreshed slides before exporting; saved HTML and exports keep their previous appearance until rendering completes.

The refresh list is a snapshot, including when an operation is replayed. Re-read slide revisions if other edits occurred. With apply_project_theme: true, rendering uses the current project presets and style. Otherwise it prefers the saved slide theme.

Refresh or redesign a slide

Read the single-slide resource. has_html indicates a saved preview exists; layout_content_current indicates it matches the saved content and layout. If false, call render_slide before comparing designs. To replace the entire layout, including manual placements, call redraw_slide with the current slide revision.

Compare alternative designs

Call generate_slide_alternatives with the current revision of a rendered slide to explore up to five component variant combinations while preserving its content, layout and background. Read the returned batch resource for status and each ready candidate’s preview_resource_uri to inspect its HTML. Generation and previews do not change the saved slide. Apply a choice with apply_slide_alternative, its batch and candidate IDs, and the batch’s base_revision as expected_revision.

Choices use compatible component variants from the saved slide theme, falling back to project settings for missing or invalid fields and retain the saved background. Generating and previewing these choices makes no LLM calls and spends no Credits. They expire (normally after 30 minutes) and become stale after slide, theme or renderer changes. Generate a new set when that happens; fresh: true requests another batch once the current batch finishes. Pending batches are reused. Save a checkpoint before applying if you need an undo point.

Export to PowerPoint

Pro accounts can read flamigo://presentations/{presentation_id}/export/pptx. Save the decoded MCP binary blob as a .pptx file. Text is editable; complex visuals are separate images. Fonts are not embedded, so PowerPoint may substitute missing fonts. Export does not spend Credits. HTML export remains available for browser presentation.

Example tool call

This is a JSON-RPC request after client initialization and authorization. Subsequent writes need new operation IDs and the revisions returned by current resources.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_presentation",
    "arguments": {
      "operation_id": "review-create-001",
      "title": "Quarterly review",
      "color_preset_id": "color-navy-white",
      "font_preset_id": "font-modern",
      "source_content": "Revenue grew 20%. Next quarter: expand onboarding."
    }
  }
}

Read resource contents using resources/read with { "uri": "flamigo://presentations" }. Resource URIs are MCP identifiers, not browser download links.

3. Tool reference

All 16 tools are listed below. Parameters without a default are required. Presentation and slide IDs use UUID strings; preset IDs are slugs such as font-modern; None means optional/null. Discover tools/list on the connected server for its current schemas.

expected_revision is the presentation revision for presentation operations and create_slide; it is the slide revision for all other slide writes. operation_id is required for every write.

NarrativeOutlineInput: page_no ≥ 1, sentence 1–500 characters, and a supported layout. SlideDslInput: optional page_no matching the 1-based array position and complete dsl as an object or JSON string. Layouts: hero, section, groups, split, process, comparison, chart, table, quote, image-focus, diagram. Complexity: concise, medium or detailed. presentation_style: editorial (default), swiss or minimal. illustration_instruction: optional art direction, up to 4,000 Unicode characters. draft_outline.direction: up to 900 Unicode characters. max_pages is a maximum of 1–30 slides; sparse material may produce fewer. Source material and single-slide AI writing input each allow up to 30,000 Unicode characters, including spaces and line breaks.

4. Resource reference

Read resources with resources/read; discover fixed URIs with resources/list and parameterized URIs with resources/templates/list. Use returned UUIDs for presentation and slide IDs. Use the returned preset slug for {preset_id}.

Metadata and slide lists are lightweight: they omit full source, DSL and HTML. Read the dedicated resources only when needed. The HTML export includes presentation navigation; linked assets may still require network access.

5. Revisions & idempotency

• Read the target revision before writing. Never assume a revision increments by a fixed amount or reuse a presentation revision for a slide.
• Use a unique operation_id of 1–128 characters for each new write. The ID is scoped to your account across tools.
• After a transport failure, retry with the same operation ID and identical arguments. A completed operation replays its saved result.
• The same ID with different arguments is rejected. A running operation reports that it is already running; inspect status before retrying.
• A failed operation remains failed under that ID. Re-read state, fix the cause, and use a new ID for a corrected request.
• On revision conflict, read the resource again, reconcile changes, and submit a new operation. Avoid simultaneous edits to the same slide.

6. Troubleshooting

401 / authorization expired

Let the client refresh its token, or reconnect through browser authorization.

Endpoint unavailable / 404

Check the backend host, configured MCP path and whether MCP is enabled. A missing resource can also mean it does not belong to the signed-in account.

Revision conflict

Re-read the target and reconcile the current version before a new write.

Invalid input

Check tool discovery schemas, UUIDs, layout, DSL content. Correct the arguments before trying again.

Generation failed

Read get_generation_status for per-slide errors. Resolve the reported cause, then render missing or stale previews using current slide revisions and new operation IDs.

Choices expired or stale

Generate a new batch after a 410 expiry or 409 slide/theme conflict; use its base revision when applying.

Choices temporarily unavailable

Try again later if the shared design cache is unavailable. Successful candidates can still be used when other candidates fail.

PPTX access denied

PowerPoint downloads require a Pro account. You can still export HTML.

Export not ready

Generate every slide's HTML first. DSL generation alone does not produce an exportable presentation.

Tool failures are reported as MCP tool errors; application HTTP codes may appear inside the error message. Resource failures are MCP resource errors. Treat an error response as a failed operation, not as a completed presentation.