SlideForge is an MCP server published by dev.slideforge, hosted at api.slideforge.dev. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 9 tools, including browse_catalog, plan_slide, create_slide, create_deck, edit_slide.
Deterministic, fully editable PowerPoint from typed slide intents. 200+ layouts, brand templates.
Nothing else in the archive shares these values.
Inferred from the host name and headers: what a server runs on, not who runs it.
Browse the PowerPoint slide catalog progressively. No args -> form overview (when-to-use, bound fields, variant counts). family=<form> -> variant one-liners. q=<text> -> ranked search. variant=/prior_id= -> example payload. type=schema + family -> a compact family-level variant chooser (not a sendable contract); type=schema + family + variant -> that variant's exact payload contract (JSON Schema, capacity, field mapping, examples). Free. Code path: type=widgets = the add_widget() catalog (name=<widget> for its contract + thumbnail); type=helpers = python-pptx helper signatures. type=themes + an uploaded theme_id -> that template's branded FURNITURE layouts (its own cover/agenda/divider/closing slides + fill schemas + previews) — render via create_slide(form=template_layout, theme_id, data={layout, fills}).
| Parameter | Type | Description |
|---|---|---|
| q | string | Semantic search across all variants; returns ranked form/variant matches with scores. |
| top | integer |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| Max results (with type=themes). |
| name | string | Widget name (with type=widgets): returns the full contract + worked example + a rendered thumbnail. |
| type | string | Omit for the form overview (or family=/q= to drill in). schema (+family, optionally +variant=) = schema-first discovery: family only returns a compact variant chooser; family+variant returns that variant's exact machine-readable payload contract (JSON Schema for data, capacity limits, intent-field m… |
| limit | integer | Max results (with q= or family=). |
| family | string |
| offset | integer | Pagination offset (with q= or family=). |
| source | string | Theme source filter (with type=themes). Default all (built-in + your saved). |
| variant | string |
| prior_id | string |
| theme_id | string | With type=themes: an uploaded theme's id -> its branded furniture layouts + fill schemas (render via create_slide(form=template_layout)). |
{
"name": "browse_catalog",
"title": "Browse SlideForge's Catalog (Unified Discovery)",
"description": "Browse the PowerPoint slide catalog progressively. No args -> form overview (when-to-use, bound fields, variant counts). family=<form> -> variant one-liners. q=<text> -> ranked search. variant=/prior_id= -> example payload. type=schema + family -> a compact family-level variant chooser (not a sendable contract); type=schema + family + variant -> that variant's exact payload contract (JSON Schema, capacity, field mapping, examples). Free. Code path: type=widgets = the add_widget() catalog (name=<widget> for its contract + thumbnail); type=helpers = python-pptx helper signatures. type=themes + an uploaded theme_id -> that template's branded FURNITURE layouts (its own cover/agenda/divider/closing slides + fill schemas + previews) — render via create_slide(form=template_layout, theme_id, data={layout, fills}).",
"inputSchema": {
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Semantic search across all variants; returns ranked form/variant matches with scores."
},
"top": {
"type": "integer",
"description": "Max results (with type=themes)."
},
"name": {
"type": "string",
"description": "Widget name (with type=widgets): returns the full contract + worked example + a rendered thumbnail."
},
"type": {
"type": "string",
"description": "Omit for the form overview (or family=/q= to drill in). schema (+family, optionally +variant=) = schema-first discovery: family only returns a compact variant chooser; family+variant returns that variant's exact machine-readable payload contract (JSON Schema for data, capacity limits, intent-field mapping, examples). widgets = the add_widget() catalog for mode=code (name=<widget> for its contract). helpers = python-pptx helper signatures. themes = list themes (built-in + your saved); Default appears first and can be omitted, or use any returned id as theme_id. brands = your brand kits with versions (theme_id=<slug> renders the default version, <slug>@<n> pins n)."
},
"limit": {
"type": "integer",
"description": "Max results (with q= or family=)."
},
"family": {
"type": "string"
},
"offset": {
"type": "integer",
"description": "Pagination offset (with q= or family=)."
},
"source": {
"enum": [
"all",
"default",
"custom",
"saved",
"uploaded"
],
"type": "string",
"description": "Theme source filter (with type=themes). Default all (built-in + your saved)."
},
"variant": {
"type": "string"
},
"prior_id": {
"type": "string"
},
"theme_id": {
"type": "string",
"description": "With type=themes: an uploaded theme's id -> its branded furniture layouts + fill schemas (render via create_slide(form=template_layout))."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Plan a PowerPoint slide before rendering (free): send a short brief, get ranked candidates + a separated verdict — route (which slide: selected|needs_confirmation|ambiguous), input (can it render: ready|extractable_from_brief|needs_structured_data) and next_action. Free (one embedding). Then call create_slide with the chosen form(+variant). route.confidence: calibrated = measured P(route correct) with label high/medium/low cut on it; retrieval_score/retrieval_margin = the raw family-aggregated classifier values (not probabilities; margin can be negative when families contest); source = jev (calibrated router, took the route at >=0.9) | classifier | structural_router (LLM-rescued). candidate_margin on the top candidate = literal gap between the two shown scores.
| Parameter | Type | Description |
|---|---|---|
| top | integer | |
| brief * | string | |
| escalate | boolean | Default true: on a low-confidence route the plan runs the SAME LLM rescue create_slide would (small COGS on that tail only), so plan and create always agree. Set false for a classifier-only, fully free plan (response then flags will_escalate + create_slide_behavior). |
| variant_policy | string | production_safe: if the top routed variant is draft/beta, the family's demo-safe sibling leads and route reports both best_semantic and best_production_safe. |
{
"name": "plan_slide",
"title": "Plan a Slide - Form + Variant Candidates",
"description": "Plan a PowerPoint slide before rendering (free): send a short brief, get ranked candidates + a separated verdict — route (which slide: selected|needs_confirmation|ambiguous), input (can it render: ready|extractable_from_brief|needs_structured_data) and next_action. Free (one embedding). Then call create_slide with the chosen form(+variant). route.confidence: calibrated = measured P(route correct) with label high/medium/low cut on it; retrieval_score/retrieval_margin = the raw family-aggregated classifier values (not probabilities; margin can be negative when families contest); source = jev (calibrated router, took the route at >=0.9) | classifier | structural_router (LLM-rescued). candidate_margin on the top candidate = literal gap between the two shown scores.",
"inputSchema": {
"type": "object",
"required": [
"brief"
],
"properties": {
"top": {
"type": "integer"
},
"brief": {
"type": "string"
},
"escalate": {
"type": "boolean",
"description": "Default true: on a low-confidence route the plan runs the SAME LLM rescue create_slide would (small COGS on that tail only), so plan and create always agree. Set false for a classifier-only, fully free plan (response then flags will_escalate + create_slide_behavior)."
},
"variant_policy": {
"enum": [
"best_semantic_match",
"production_safe"
],
"type": "string",
"description": "production_safe: if the top routed variant is draft/beta, the family's demo-safe sibling leads and route reports both best_semantic and best_production_safe."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create one PowerPoint slide (.pptx, native, editable) from a structured intent in ONE call: pick a `form` from the menu and put your content in the typed fields (placed on the slide as given), or pass a `brief` and let the server route it. Fields tagged (per-form) bind only where the form has that slot — ignored-with-warning elsewhere; see each form's `binds` in browse_catalog. BLOCKED (not billed)? If an error has `can_autofix:true`, merge its `patch` into the args at `patch_target`. Unchanged retries repeat the block. New form: browse_catalog(type=schema) first. FORM MENU: agenda_list: an ordered list of sections/topics or learning objectives to walk through bar_rank_chart: bars comparing magnitudes across categories calendar_grid: events on a real calendar - week planner (day x hour) or month grid with event chips (data.events) card_grid: several equal, unordered peer blocks (features, options, pillars, a concept's defined parts, rules/guidelines/common mistakes) case_story: one named story told as evidence, proven by measured results (data.results = figures) comparison_matrix: options x criteria grid: data.columns x data.rows cycle_flow: a closed loop of ordered stages where the last feeds the first (recurring process) data_table: a plain factual table of records by fields editorial_split: two side-by-side halves: contrast (before/after, problem/solution) or copy/numbered steps beside a picture (image_src) exercise_prompt: an exercise/practice/discussion prompt: instruction + hints; optional problem items with blank answer boxes funnel: a quantity narrowing through ordered stages gantt_plan: tasks as bars across named periods on a schedule grid gauge_score: one score on a dial against a scale hero_statement: a statement slide: covers (title/image-led/exec), from->to/thesis-quote transitions, statement/contact/next-steps closings; supporting points -> takeaway_stack, contacts -> data.contacts, next steps -> data.next_steps hub_spoke: one central element with several elements connected around it image_story: a picture shown WHOLE (uncropped) + prose and up to 4 labelled blocks beside it, or a 1-6 picture/placeholder gallery (data.images) kpi_metrics: a metrics dashboard: headline metric cards; data.sections (Highlights/Risks/Asks) makes it an exec summary / QBR snapshot layer_stack: stacked layers where higher sits on, and depends on, lower linear_flow: ordered process stages read left to right (or inputs to process to outputs) maturity_staircase: ascending levels climbing to a higher state nested_magnitude: nested containment - each level contains the next org_structure: a reporting hierarchy / org tree position_map: items placed by two axes - named 2x2 cells or scatter positions pyramid_hierarchy: a triangle of stacked tiers, foundation to apex ramp_curve: a continuous rising wedge split into phases - effort or value accumulating over time section_divider: a section-break: big section number + title; blocks = agenda progress chips (emphasis=primary = current) segment_wheel: a wheel of equal segments around a center - peer categories in the round (composition, not flow) status_dashboard: initiatives/workstreams tracked by status, owner, progress strategic_fork: one origin splitting into two mutually exclusive paths, one recommended swimlane_flow: actor/function lanes by phases, task cells, handoffs across lanes swot: the four-quadrant strengths / weaknesses / opportunities / threats grid system_flow_map: architecture/system components: panels with internals (edges optional) or nodes wired by directed arrows takeaway_stack: a title plus a few supporting points, each with one line of detail (executive summary, key findings); optional closing ask timeline_roadmap: milestones/phases laid out along a time axis trend_chart: one or more series plotted over time value_chain: support bands over primary activity columns flowing into a goal arrowhead (data.supp
| Parameter | Type | Description |
|---|---|---|
| code | string | Python code defining build(prs). Canvas 13.33×7.5", coords in inches. Pre-imported: Presentation, Inches, Pt, Emu, RGBColor, MSO_ANCHOR, PP_ALIGN. Helpers: add_text_box(slide, left, top, w, h, text, font_size=12, bold=False, color=None), add_box(slide, left, top, w, h, fill_color=None, line_color=No… |
| data | object | family-specific payload — see the documented shapes |
| date | string | date callout (per-form). |
| form | string | the form menu pick (see description) — the routing field |
| mode | string | Default: structured intent / brief. safe = validate-then-render in ONE call (renders + bills only if faithful; else an unbilled invalid report with the fix — recommended, no dry_run round-trip). code = python-pptx escape. status = poll. |
| name | string | |
| wait | string | AI-image slides block ~10-15s; `false` returns a job_id to poll, not block (mode=brief). |
| brief | string | prose fallback / extra context for fills |
| notes | string | Speaker notes for the presenter; never drawn on the slide. |
| blocks | array | list: [{"label","sub","detail":[str],"emphasis","icon":lucide-name,"metric":{value,label}}] |
| detail | string | Response verbosity. Default `compact`: status, form/variant, fidelity (verbatim|mixed|ai_completed), warnings[]/errors[] (only when present), urls, cost. `full` adds a debug object (engine internals, verify events, latency buckets). |
{
"name": "create_slide",
"title": "Create or Inspect a Slide",
"description": "Create one PowerPoint slide (.pptx, native, editable) from a structured intent in ONE call: pick a `form` from the menu and put your content in the typed fields (placed on the slide as given), or pass a `brief` and let the server route it. Fields tagged (per-form) bind only where the form has that slot — ignored-with-warning elsewhere; see each form's `binds` in browse_catalog.\n\nBLOCKED (not billed)? If an error has `can_autofix:true`, merge its `patch` into the args at `patch_target`. Unchanged retries repeat the block. New form: browse_catalog(type=schema) first.\n\n\nFORM MENU:\n agenda_list: an ordered list of sections/topics or learning objectives to walk through\n bar_rank_chart: bars comparing magnitudes across categories\n calendar_grid: events on a real calendar - week planner (day x hour) or month grid with event chips (data.events)\n card_grid: several equal, unordered peer blocks (features, options, pillars, a concept's defined parts, rules/guidelines/common mistakes)\n case_story: one named story told as evidence, proven by measured results (data.results = figures)\n comparison_matrix: options x criteria grid: data.columns x data.rows\n cycle_flow: a closed loop of ordered stages where the last feeds the first (recurring process)\n data_table: a plain factual table of records by fields\n editorial_split: two side-by-side halves: contrast (before/after, problem/solution) or copy/numbered steps beside a picture (image_src)\n exercise_prompt: an exercise/practice/discussion prompt: instruction + hints; optional problem items with blank answer boxes\n funnel: a quantity narrowing through ordered stages\n gantt_plan: tasks as bars across named periods on a schedule grid\n gauge_score: one score on a dial against a scale\n hero_statement: a statement slide: covers (title/image-led/exec), from->to/thesis-quote transitions, statement/contact/next-steps closings; supporting points -> takeaway_stack, contacts -> data.contacts, next steps -> data.next_steps\n hub_spoke: one central element with several elements connected around it\n image_story: a picture shown WHOLE (uncropped) + prose and up to 4 labelled blocks beside it, or a 1-6 picture/placeholder gallery (data.images)\n kpi_metrics: a metrics dashboard: headline metric cards; data.sections (Highlights/Risks/Asks) makes it an exec summary / QBR snapshot\n layer_stack: stacked layers where higher sits on, and depends on, lower\n linear_flow: ordered process stages read left to right (or inputs to process to outputs)\n maturity_staircase: ascending levels climbing to a higher state\n nested_magnitude: nested containment - each level contains the next\n org_structure: a reporting hierarchy / org tree\n position_map: items placed by two axes - named 2x2 cells or scatter positions\n pyramid_hierarchy: a triangle of stacked tiers, foundation to apex\n ramp_curve: a continuous rising wedge split into phases - effort or value accumulating over time\n section_divider: a section-break: big section number + title; blocks = agenda progress chips (emphasis=primary = current)\n segment_wheel: a wheel of equal segments around a center - peer categories in the round (composition, not flow)\n status_dashboard: initiatives/workstreams tracked by status, owner, progress\n strategic_fork: one origin splitting into two mutually exclusive paths, one recommended\n swimlane_flow: actor/function lanes by phases, task cells, handoffs across lanes\n swot: the four-quadrant strengths / weaknesses / opportunities / threats grid\n system_flow_map: architecture/system components: panels with internals (edges optional) or nodes wired by directed arrows\n takeaway_stack: a title plus a few supporting points, each with one line of detail (executive summary, key findings); optional closing ask\n timeline_roadmap: milestones/phases laid out along a time axis\n trend_chart: one or more series plotted over time\n value_chain: support bands over primary activity columns flowing into a goal arrowhead (data.supp",
"inputSchema": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Python code defining build(prs). Canvas 13.33×7.5\", coords in inches. Pre-imported: Presentation, Inches, Pt, Emu, RGBColor, MSO_ANCHOR, PP_ALIGN. Helpers: add_text_box(slide, left, top, w, h, text, font_size=12, bold=False, color=None), add_box(slide, left, top, w, h, fill_color=None, line_color=None, corner_radius=0.05), add_icon, add_image (src = path or https://); theme_color(name) → RGBColor. add_widget(slide, name, x, y, w, h, params=|content=, theme=THEME) draws board-grade SSG widgets/charts (cards, waterfall, gantt, funnel…) — names via `browse_catalog(type=widgets)`. Use font_size=, not size=; use fill_color=, not fill=. When chrome is supplied, use `build(prs, slide)` — chrome is pre-rendered. Helper signatures: `browse_catalog(type=helpers)`."
},
"data": {
"type": "object",
"description": "family-specific payload — see the documented shapes"
},
"date": {
"type": "string",
"description": "date callout (per-form)."
},
"form": {
"type": "string",
"description": "the form menu pick (see description) — the routing field"
},
"mode": {
"enum": [
"safe",
"brief",
"code",
"status"
],
"type": "string",
"description": "Default: structured intent / brief. safe = validate-then-render in ONE call (renders + bills only if faithful; else an unbilled invalid report with the fix — recommended, no dry_run round-trip). code = python-pptx escape. status = poll."
},
"name": {
"type": "string"
},
"wait": {
"enum": [
"auto",
"true",
"false"
],
"type": "string",
"description": "AI-image slides block ~10-15s; `false` returns a job_id to poll, not block (mode=brief)."
},
"brief": {
"type": "string",
"description": "prose fallback / extra context for fills"
},
"notes": {
"type": "string",
"description": "Speaker notes for the presenter; never drawn on the slide."
},
"blocks": {
"type": "array",
"items": {
"type": "object"
},
"description": "list: [{\"label\",\"sub\",\"detail\":[str],\"emphasis\",\"icon\":lucide-name,\"metric\":{value,label}}]"
},
"detail": {
"enum": [
"compact",
"full"
],
"type": "string",
"description": "Response verbosity. Default `compact`: status, form/variant, fidelity (verbatim|mixed|ai_completed), warnings[]/errors[] (only when present), urls, cost. `full` adds a debug object (engine internals, verify events, latency buckets)."
},
"job_id": {
"type": "string",
"description": "Previous job ID (for mode=status, or mode=code patching)"
},
"metric": {
"type": "object"
},
"verify": {
"enum": [
"off",
"lint",
"lint+vlm",
"full"
],
"type": "string",
"description": "mode=code. Default `lint`: static geometry + content checks, no LLM. `lint+vlm` adds a VLM second look (~+3s); a blank render is then an unbilled error, not a billed warning. `off` skips checks."
},
"caution": {
"type": "string",
"description": "one-line risk / caveat callout (per-form)."
},
"context": {
"type": "string",
"description": "one-line subtitle/standfirst"
},
"dry_run": {
"type": "boolean",
"description": "Free pre-commit check (intent or mode=code), cost:0, no PPTX: status + warnings/errors, plus fidelity_forecast (verbatim|mixed|ai_completed|would_reject) and which fields bind vs get authored. Fix errors, re-call with dry_run=false to render."
},
"imagery": {
"enum": [
"photo",
"wash",
"off"
],
"type": "string",
"description": "Cover/section-divider imagery: photo (default — curated stock photo, half-bleed), wash (abstract color wash), off (plain panel, no photo — only when asked). Content slides are never photo-decorated."
},
"logo_id": {
"type": "string",
"description": "Optional brand logo (from upload_asset purpose=logo) drawn as chrome on content slides; covers/section breaks stay clean."
},
"styling": {
"enum": [
"topical",
"clean"
],
"type": "string",
"description": "Topical design on default themes (default on; the note names it): designed cover + a subject palette (from imagery_tag, or the brief). clean = neutral. Pins never take it."
},
"subject": {
"type": "string",
"description": "central entity for forms that have one — hub label, org root, section #, fork origin, media label (per-form)."
},
"variant": {
"type": "string",
"description": "pin a specific variant within the form (list them via browse_catalog). Unknown variant -> rejected (not billed) with the valid list; set allow_variant_fallback to render the family default instead."
},
"headline": {
"type": "string",
"description": "the assertion-style slide title"
},
"language": {
"enum": [
"bg",
"ca",
"cs",
"da",
"de",
"el",
"en",
"es",
"et",
"fi",
"fr",
"gl",
"hr",
"hu",
"id",
"is",
"it",
"ja",
"ko",
"lt",
"lv",
"nl",
"no",
"pl",
"pt",
"ro",
"ru",
"sk",
"sl",
"sr",
"sv",
"tr",
"uk",
"vi",
"zh"
],
"type": "string",
"description": "ISO 639-1 (default en): furniture labels and authored fills follow it."
},
"takeaway": {
"type": "string",
"description": "optional verdict band (per-form). Put the so-what in the headline; add only for a verdict the title can't carry — not every slide."
},
"theme_id": {
"type": "string",
"description": "Optional theme id from browse_catalog(type=themes). Omit for Default (slideforge_standard)."
},
"direction": {
"enum": [
"ltr",
"rtl"
],
"type": "string",
"description": "rtl typesets AND mirrors the slide right-to-left (Arabic/Hebrew). Never inferred — pass it."
},
"highlight": {
"type": "string",
"description": "one-line emphasis callout (per-form)."
},
"image_src": {
"type": "string",
"description": "https URL | asset:<id> for image-bearing forms"
},
"imagery_tag": {
"enum": [
"general",
"agriculture",
"construction",
"education",
"energy",
"finance",
"government",
"healthcare",
"logistics",
"manufacturing",
"retail",
"technology",
"travel"
],
"type": "string",
"description": "Subject/industry: steers library photos (covers, sections, picture slides) AND the topical palette. Omit = general; `education` = teaching."
},
"min_font_pt": {
"type": "number",
"maximum": 40,
"minimum": 6,
"description": "Binding type floor for prose (exhibit furniture has its own). Type grows to meet it; content that can't fit is an unbilled min_font_not_met naming the size needed. Typical: 12."
},
"source_note": {
"type": "string",
"description": "source / footnote line (per-form)."
},
"force_render": {
"type": "boolean",
"description": "On completed_with_errors, pptx_url is null (broken slide). Set true to get it anyway. No cost/status effect."
},
"image_prompt": {
"type": "string",
"description": "generate an image when no image_src"
},
"replacements": {
"type": "array",
"items": {
"type": "object",
"required": [
"old",
"new"
],
"properties": {
"new": {
"type": "string",
"description": "Replacement string"
},
"old": {
"type": "string",
"description": "Exact string to find"
}
}
},
"description": "String replacements on loaded code [{old, new}] (for mode=code with job_id)"
},
"variant_policy": {
"enum": [
"best_semantic_match",
"production_safe"
],
"type": "string",
"description": "Routed-variant maturity policy: production_safe = if the ROUTED variant is draft/beta, render the family's demo-safe sibling instead (warning names both). Never overrides an explicit variant=. Default best_semantic_match."
},
"include_preview": {
"enum": [
"none",
"small",
"default",
"full"
],
"type": "string",
"description": "Inline-preview PAYLOAD only (not execution). Default: default (768px). none omits the inline image and returns just the URLs — it does NOT change sync/async. Use `wait` to control execution."
},
"quality_profile": {
"enum": [
"executive",
"technical",
"appendix"
],
"type": "string",
"description": "Thresholds layout.presentation_ready is judged against (executive strictest). Measurement only — never blocks a render or changes cost."
},
"allow_truncation": {
"type": "boolean",
"description": "More items than the form holds blocks (it would drop your data); the response names the dropped count + a suggested_split. true renders the capacity subset (fidelity=verbatim_truncated). Default false."
},
"form_description": {
"type": "string"
},
"allow_fabrication": {
"type": "boolean",
"description": "Brief mode only: a bare brief on a DATA form (kpi/funnel/comparison/…) returns would_fabricate, not billed, rather than INVENT numbers. Send typed fields for verbatim, or true to let the brief author them (fidelity=ai_completed). Default false."
},
"allow_low_confidence": {
"type": "boolean",
"description": "Brief routing only: by default a brief that doesn't match a form clearly returns status=needs_confirmation + candidates at cost:0 (no guessed render). Set true to render the top guess and bill it. Default false."
},
"allow_variant_fallback": {
"type": "boolean",
"description": "If the pinned variant is unknown, render the form's default variant (with a warning) instead of rejecting. Default false."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Create a complete PowerPoint presentation (.pptx): a whole multi-slide deck, native and editable, in one call. `slides` is a list of create_slide intents (same form menu + data shapes — see create_slide). Slides fill in parallel and merge into one themed PPTX with page numbers. Include furniture: a hero_statement cover, section_divider breaks, and a closing (hero_statement variant=contact_closing via blocks-free slots). BLOCKED (not billed)? If an error has `can_autofix:true`, merge its `patch` into the args at `patch_target`. Unchanged retries repeat the block. New form: browse_catalog(type=schema) first. Also: mode=assemble merges existing slide job_ids as-rendered (free; theme_id does NOT re-theme them — render with create_deck(slides=[…], theme_id=…) for a unified theme); mode=fork clones a deck (free). Polling: deck_id == job_id — manage_account(action=job, job_id=<deck_id>).
| Parameter | Type | Description |
|---|---|---|
| mode | string | Default render. assemble/fork are free deck plumbing. |
| name | string | |
| title | string | Deck title (PowerPoint metadata) |
| slides | array | each item is a create_slide intent (same form menu, typed fields, and data shapes as create_slide). |
| deck_id | string | Existing deck ID (for mode=fork, or mode=render to update) |
| dry_run | boolean | Deck-level free pre-flight (cost:0, NO render/PPTX): returns a per-slide validation manifest [{i, form, fidelity_forecast, status, errors}] so you can fix bad slides before spending. A deck is one artifact, so validation is all-or-nothing — put dry_run here, not on individual slides. Resend without … |
| imagery | string | Deck-level imagery mode, inherited by every slide (a slide-level imagery wins). See create_slide.imagery. |
| job_ids | array | Slide job IDs to merge (for mode=assemble) |
| logo_id | string | Optional brand logo (from upload_asset purpose=logo) applied as chrome to every content slide in the deck. |
| styling | string | Deck-level topical-design switch, inherited by every slide (a slide-level styling wins). See create_slide.styling. |
| language | string | ISO 639-1 (default en) for every slide: furniture labels and authored fills follow it. |
| theme_id | string | |
| direction | string | Deck-level writing direction, inherited by every slide (a slide-level direction wins) — set it once for an Arabic/Hebrew deck. Covers/dividers rendered on an UPLOADED brand template keep that template's own layout direction. See create_slide.direction. |
| imagery_tag | string | Deck-level subject declaration, inherited by every slide (a slide-level imagery_tag wins). Declare it once for a whole deck. See create_slide.imagery_tag. |
| force_render | boolean | IGNORED (deck-level). pptx_url is always returned when at least one slide rendered, so there is nothing to force. Still meaningful on create_slide. |
| allow_partial | boolean | IGNORED. A deck bills per rendered slide and always returns its pptx; slides that failed or rendered badly are free and named in repair_actions. |
| strict_policy | object | Optional CI-style gate for automated report pipelines. dry_run returns policy_result; render returns rejected/cost:0 if the policy fails. |
{
"name": "create_deck",
"title": "Create Multi-Slide Deck",
"description": "Create a complete PowerPoint presentation (.pptx): a whole multi-slide deck, native and editable, in one call. `slides` is a list of create_slide intents (same form menu + data shapes — see create_slide). Slides fill in parallel and merge into one themed PPTX with page numbers. Include furniture: a hero_statement cover, section_divider breaks, and a closing (hero_statement variant=contact_closing via blocks-free slots).\n\nBLOCKED (not billed)? If an error has `can_autofix:true`, merge its `patch` into the args at `patch_target`. Unchanged retries repeat the block. New form: browse_catalog(type=schema) first.\n\n\n\nAlso: mode=assemble merges existing slide job_ids as-rendered (free; theme_id does NOT re-theme them — render with create_deck(slides=[…], theme_id=…) for a unified theme); mode=fork clones a deck (free).\nPolling: deck_id == job_id — manage_account(action=job, job_id=<deck_id>).",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"mode": {
"enum": [
"render",
"assemble",
"fork"
],
"type": "string",
"description": "Default render. assemble/fork are free deck plumbing."
},
"name": {
"type": "string"
},
"title": {
"type": "string",
"description": "Deck title (PowerPoint metadata)"
},
"slides": {
"type": "array",
"items": {
"type": "object"
},
"description": "each item is a create_slide intent (same form menu, typed fields, and data shapes as create_slide)."
},
"deck_id": {
"type": "string",
"description": "Existing deck ID (for mode=fork, or mode=render to update)"
},
"dry_run": {
"type": "boolean",
"description": "Deck-level free pre-flight (cost:0, NO render/PPTX): returns a per-slide validation manifest [{i, form, fidelity_forecast, status, errors}] so you can fix bad slides before spending. A deck is one artifact, so validation is all-or-nothing — put dry_run here, not on individual slides. Resend without dry_run to render."
},
"imagery": {
"enum": [
"photo",
"wash",
"off"
],
"type": "string",
"description": "Deck-level imagery mode, inherited by every slide (a slide-level imagery wins). See create_slide.imagery."
},
"job_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Slide job IDs to merge (for mode=assemble)"
},
"logo_id": {
"type": "string",
"description": "Optional brand logo (from upload_asset purpose=logo) applied as chrome to every content slide in the deck."
},
"styling": {
"enum": [
"topical",
"clean"
],
"type": "string",
"description": "Deck-level topical-design switch, inherited by every slide (a slide-level styling wins). See create_slide.styling."
},
"language": {
"enum": [
"bg",
"ca",
"cs",
"da",
"de",
"el",
"en",
"es",
"et",
"fi",
"fr",
"gl",
"hr",
"hu",
"id",
"is",
"it",
"ja",
"ko",
"lt",
"lv",
"nl",
"no",
"pl",
"pt",
"ro",
"ru",
"sk",
"sl",
"sr",
"sv",
"tr",
"uk",
"vi",
"zh"
],
"type": "string",
"description": "ISO 639-1 (default en) for every slide: furniture labels and authored fills follow it."
},
"theme_id": {
"type": "string"
},
"direction": {
"enum": [
"ltr",
"rtl"
],
"type": "string",
"description": "Deck-level writing direction, inherited by every slide (a slide-level direction wins) — set it once for an Arabic/Hebrew deck. Covers/dividers rendered on an UPLOADED brand template keep that template's own layout direction. See create_slide.direction."
},
"imagery_tag": {
"enum": [
"general",
"agriculture",
"construction",
"education",
"energy",
"finance",
"government",
"healthcare",
"logistics",
"manufacturing",
"retail",
"technology",
"travel"
],
"type": "string",
"description": "Deck-level subject declaration, inherited by every slide (a slide-level imagery_tag wins). Declare it once for a whole deck. See create_slide.imagery_tag."
},
"force_render": {
"type": "boolean",
"description": "IGNORED (deck-level). pptx_url is always returned when at least one slide rendered, so there is nothing to force. Still meaningful on create_slide."
},
"allow_partial": {
"type": "boolean",
"description": "IGNORED. A deck bills per rendered slide and always returns its pptx; slides that failed or rendered badly are free and named in repair_actions."
},
"strict_policy": {
"type": "object",
"properties": {
"max_density": {
"enum": [
"good",
"medium",
"high"
],
"type": "string",
"description": "Reject slides whose quality.density is above this level."
},
"min_font_pt": {
"type": "number",
"description": "Reject slides whose reported minimum font size is below this point size."
},
"reject_mixed": {
"type": "boolean",
"description": "Reject slides with mixed verbatim and AI-completed content."
},
"reject_truncated": {
"type": "boolean",
"description": "Reject slides with truncated supplied content."
},
"reject_ai_completed": {
"type": "boolean",
"description": "Reject slides whose content was fully AI-completed."
},
"reject_draft_variants": {
"type": "boolean",
"description": "Reject slides rendered by a draft-maturity variant (see each slide's variant_maturity warning)."
},
"reject_field_warnings": {
"type": "boolean",
"description": "Reject slides carrying any field-binding warning (field_ignored, input_shape_hint, normalized, variant_fallback, form_rerouted)."
},
"reject_ignored_fields": {
"type": "boolean",
"description": "Reject slides whose supplied fields were not rendered (fidelity=partial / field_ignored)."
}
},
"description": "Optional CI-style gate for automated report pipelines. dry_run returns policy_result; render returns rejected/cost:0 if the policy fails."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Change a slide you already rendered, in place and free: the job keeps its id and links. Send the job_id and a patch of the fields to change. Never runs a model: a brief or a picture request is refused (make a new slide for those). The response carries the slide's full current spec as `intent`. Up to 20 edits per slide.
| Parameter | Type | Description |
|---|---|---|
| patch * | object | the slide fields to change (same fields as create_slide). A field left out keeps its value, a field sent as null is removed, a list replaces the whole list, `data` merges key by key. Send only `notes` to add or replace speaker notes without a re-render. |
| job_id * | string | the rendered slide's job_id |
{
"name": "edit_slide",
"title": "Edit a rendered slide",
"description": "Change a slide you already rendered, in place and free: the job keeps its id and links. Send the job_id and a patch of the fields to change. Never runs a model: a brief or a picture request is refused (make a new slide for those). The response carries the slide's full current spec as `intent`. Up to 20 edits per slide.",
"inputSchema": {
"type": "object",
"required": [
"job_id",
"patch"
],
"properties": {
"patch": {
"type": "object",
"properties": {
"data": {
"type": "object",
"description": "family-specific payload — see the documented shapes"
},
"date": {
"type": "string",
"description": "date callout (per-form)."
},
"form": {
"type": "string",
"description": "the form menu pick (see description) — the routing field"
},
"notes": {
"type": "string",
"description": "Speaker notes for the presenter; never drawn on the slide."
},
"blocks": {
"type": "array",
"items": {
"type": "object"
},
"description": "list: [{\"label\",\"sub\",\"detail\":[str],\"emphasis\",\"icon\":lucide-name,\"metric\":{value,label}}]"
},
"metric": {
"type": "object"
},
"caution": {
"type": "string",
"description": "one-line risk / caveat callout (per-form)."
},
"context": {
"type": "string",
"description": "one-line subtitle/standfirst"
},
"imagery": {
"enum": [
"photo",
"wash",
"off"
],
"type": "string",
"description": "Cover/section-divider imagery: photo (default — curated stock photo, half-bleed), wash (abstract color wash), off (plain panel, no photo — only when asked). Content slides are never photo-decorated."
},
"styling": {
"enum": [
"topical",
"clean"
],
"type": "string",
"description": "Topical design on default themes (default on; the note names it): designed cover + a subject palette (from imagery_tag, or the brief). clean = neutral. Pins never take it."
},
"subject": {
"type": "string",
"description": "central entity for forms that have one — hub label, org root, section #, fork origin, media label (per-form)."
},
"variant": {
"type": "string",
"description": "pin a specific variant within the form (list them via browse_catalog). Unknown variant -> rejected with the valid list; null unpins."
},
"headline": {
"type": "string",
"description": "the assertion-style slide title"
},
"takeaway": {
"type": "string",
"description": "optional verdict band (per-form). Put the so-what in the headline; add only for a verdict the title can't carry — not every slide."
},
"theme_id": {
"type": "string"
},
"direction": {
"enum": [
"ltr",
"rtl"
],
"type": "string",
"description": "rtl typesets AND mirrors the slide right-to-left (Arabic/Hebrew). Never inferred — pass it."
},
"highlight": {
"type": "string",
"description": "one-line emphasis callout (per-form)."
},
"image_src": {
"type": "string",
"description": "https URL | asset:<id> for image-bearing forms"
},
"imagery_tag": {
"enum": [
"general",
"agriculture",
"construction",
"education",
"energy",
"finance",
"government",
"healthcare",
"logistics",
"manufacturing",
"retail",
"technology",
"travel"
],
"type": "string",
"description": "Subject/industry: steers library photos (covers, sections, picture slides) AND the topical palette. Omit = general; `education` = teaching."
},
"min_font_pt": {
"type": "number",
"maximum": 40,
"minimum": 6,
"description": "Binding type floor for prose. Content that can't fit is refused as min_font_not_met naming the size needed. Typical: 12."
},
"source_note": {
"type": "string",
"description": "source / footnote line (per-form)."
},
"variant_policy": {
"enum": [
"best_semantic_match",
"production_safe"
],
"type": "string",
"description": "Routed-variant maturity policy: production_safe = if the ROUTED variant is draft/beta, render the family's demo-safe sibling instead (warning names both). Never overrides an explicit variant=. Default best_semantic_match."
},
"quality_profile": {
"enum": [
"executive",
"technical",
"appendix"
],
"type": "string",
"description": "Thresholds layout.presentation_ready is judged against (executive strictest). Measurement only — never blocks a render or changes cost."
},
"allow_truncation": {
"type": "boolean",
"description": "More items than the form holds blocks (it would drop your data); the response names the dropped count + a suggested_split. true renders the capacity subset (fidelity=verbatim_truncated). Default false."
},
"allow_variant_fallback": {
"type": "boolean",
"description": "If the pinned variant is unknown, render the form's default variant (with a warning) instead of rejecting. Default false."
}
},
"description": "the slide fields to change (same fields as create_slide). A field left out keeps its value, a field sent as null is removed, a list replaces the whole list, `data` merges key by key. Send only `notes` to add or replace speaker notes without a re-render.",
"additionalProperties": true
},
"job_id": {
"type": "string",
"description": "the rendered slide's job_id"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Change one or more slides of a deck you already rendered, in place and free: only the patched slides re-render, the deck is re-merged and keeps its id and links. Never runs a model: a brief or a picture request is refused. Each edited slide's entry carries its full current spec as `intent`. Up to 20 edits per deck.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | the deck's job_id |
| slides * | array |
{
"name": "edit_deck",
"title": "Edit slides of a rendered deck",
"description": "Change one or more slides of a deck you already rendered, in place and free: only the patched slides re-render, the deck is re-merged and keeps its id and links. Never runs a model: a brief or a picture request is refused. Each edited slide's entry carries its full current spec as `intent`. Up to 20 edits per deck.",
"inputSchema": {
"type": "object",
"required": [
"job_id",
"slides"
],
"properties": {
"job_id": {
"type": "string",
"description": "the deck's job_id"
},
"slides": {
"type": "array",
"items": {
"type": "object",
"required": [
"slide",
"patch"
],
"properties": {
"patch": {
"type": "object",
"properties": {
"data": {
"type": "object",
"description": "family-specific payload — see the documented shapes"
},
"date": {
"type": "string",
"description": "date callout (per-form)."
},
"form": {
"type": "string",
"description": "the form menu pick (see description) — the routing field"
},
"notes": {
"type": "string",
"description": "Speaker notes for the presenter; never drawn on the slide."
},
"blocks": {
"type": "array",
"items": {
"type": "object"
},
"description": "list: [{\"label\",\"sub\",\"detail\":[str],\"emphasis\",\"icon\":lucide-name,\"metric\":{value,label}}]"
},
"metric": {
"type": "object"
},
"caution": {
"type": "string",
"description": "one-line risk / caveat callout (per-form)."
},
"context": {
"type": "string",
"description": "one-line subtitle/standfirst"
},
"imagery": {
"enum": [
"photo",
"wash",
"off"
],
"type": "string",
"description": "Cover/section-divider imagery: photo (default — curated stock photo, half-bleed), wash (abstract color wash), off (plain panel, no photo — only when asked). Content slides are never photo-decorated."
},
"styling": {
"enum": [
"topical",
"clean"
],
"type": "string",
"description": "Topical design on default themes (default on; the note names it): designed cover + a subject palette (from imagery_tag, or the brief). clean = neutral. Pins never take it."
},
"subject": {
"type": "string",
"description": "central entity for forms that have one — hub label, org root, section #, fork origin, media label (per-form)."
},
"variant": {
"type": "string",
"description": "pin a specific variant within the form (list them via browse_catalog). Unknown variant -> rejected with the valid list; null unpins."
},
"headline": {
"type": "string",
"description": "the assertion-style slide title"
},
"takeaway": {
"type": "string",
"description": "optional verdict band (per-form). Put the so-what in the headline; add only for a verdict the title can't carry — not every slide."
},
"theme_id": {
"type": "string"
},
"direction": {
"enum": [
"ltr",
"rtl"
],
"type": "string",
"description": "rtl typesets AND mirrors the slide right-to-left (Arabic/Hebrew). Never inferred — pass it."
},
"highlight": {
"type": "string",
"description": "one-line emphasis callout (per-form)."
},
"image_src": {
"type": "string",
"description": "https URL | asset:<id> for image-bearing forms"
},
"imagery_tag": {
"enum": [
"general",
"agriculture",
"construction",
"education",
"energy",
"finance",
"government",
"healthcare",
"logistics",
"manufacturing",
"retail",
"technology",
"travel"
],
"type": "string",
"description": "Subject/industry: steers library photos (covers, sections, picture slides) AND the topical palette. Omit = general; `education` = teaching."
},
"min_font_pt": {
"type": "number",
"maximum": 40,
"minimum": 6,
"description": "Binding type floor for prose. Content that can't fit is refused as min_font_not_met naming the size needed. Typical: 12."
},
"source_note": {
"type": "string",
"description": "source / footnote line (per-form)."
},
"variant_policy": {
"enum": [
"best_semantic_match",
"production_safe"
],
"type": "string",
"description": "Routed-variant maturity policy: production_safe = if the ROUTED variant is draft/beta, render the family's demo-safe sibling instead (warning names both). Never overrides an explicit variant=. Default best_semantic_match."
},
"quality_profile": {
"enum": [
"executive",
"technical",
"appendix"
],
"type": "string",
"description": "Thresholds layout.presentation_ready is judged against (executive strictest). Measurement only — never blocks a render or changes cost."
},
"allow_truncation": {
"type": "boolean",
"description": "More items than the form holds blocks (it would drop your data); the response names the dropped count + a suggested_split. true renders the capacity subset (fidelity=verbatim_truncated). Default false."
},
"allow_variant_fallback": {
"type": "boolean",
"description": "If the pinned variant is unknown, render the form's default variant (with a warning) instead of rejecting. Default false."
}
},
"description": "the slide fields to change (same fields as create_slide). A field left out keeps its value, a field sent as null is removed, a list replaces the whole list, `data` merges key by key. Send only `notes` to add or replace speaker notes without a re-render.",
"additionalProperties": true
},
"slide": {
"type": "integer",
"description": "0-based index, as slides[].i in the create_deck response"
}
}
},
"minItems": 1
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Translate a PowerPoint (.pptx) deck preserving all formatting. Supports 35 languages (Latin, Cyrillic, Greek, Chinese, Japanese, Korean). Provide job_id (from a previous create_slide/create_deck), pptx_url, or pptx_base64.
| Parameter | Type | Description |
|---|---|---|
| name | string | Job name |
| job_id | string | Source: previous slide/deck job ID (preferred — no file transfer needed) |
| pptx_url | string | Source: HTTPS URL to .pptx |
| pptx_base64 | string | Source: Base64-encoded .pptx (max ~10 MB) |
| concise_mode | boolean | Prefer shorter translations for tight text boxes |
| include_notes | boolean | Translate speaker notes (default false) |
| include_tables | boolean | Translate table cells (default true) |
| include_preview | string | Wait+embed preview (default=wait) |
| source_language | string | Source language or 'auto' (default auto) |
| target_language * | string | Target language (required) |
{
"name": "translate_deck",
"title": "Translate PPTX",
"description": "Translate a PowerPoint (.pptx) deck preserving all formatting. Supports 35 languages (Latin, Cyrillic, Greek, Chinese, Japanese, Korean). Provide job_id (from a previous create_slide/create_deck), pptx_url, or pptx_base64.",
"inputSchema": {
"type": "object",
"required": [
"target_language"
],
"properties": {
"name": {
"type": "string",
"description": "Job name"
},
"job_id": {
"type": "string",
"description": "Source: previous slide/deck job ID (preferred — no file transfer needed)"
},
"pptx_url": {
"type": "string",
"description": "Source: HTTPS URL to .pptx"
},
"pptx_base64": {
"type": "string",
"description": "Source: Base64-encoded .pptx (max ~10 MB)"
},
"concise_mode": {
"type": "boolean",
"description": "Prefer shorter translations for tight text boxes"
},
"include_notes": {
"type": "boolean",
"description": "Translate speaker notes (default false)"
},
"include_tables": {
"type": "boolean",
"description": "Translate table cells (default true)"
},
"include_preview": {
"enum": [
"none",
"small",
"default"
],
"type": "string",
"description": "Wait+embed preview (default=wait)"
},
"source_language": {
"type": "string",
"description": "Source language or 'auto' (default auto)"
},
"target_language": {
"enum": [
"en",
"de",
"fr",
"es",
"it",
"pt",
"nl",
"sv",
"da",
"no",
"fi",
"is",
"pl",
"cs",
"sk",
"hu",
"ro",
"hr",
"sl",
"et",
"lt",
"lv",
"ru",
"uk",
"bg",
"sr",
"tr",
"ca",
"gl",
"id",
"vi",
"el",
"zh",
"ja",
"ko"
],
"type": "string",
"description": "Target language (required)"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Upload assets for PowerPoint (.pptx) generation: company template, logo, image, or document — or AI-generate an image. Purposes: • logo — company logo for chrome (PNG/JPG/SVG, max 5MB) → logo_id • image — image for the Image component (max 10MB) → asset_id • theme — company template PPTX → theme_id; slides with it render NATIVELY on the template (masters/layouts/chrome) • generate_image — AI-generate via `prompt` → asset_id • translate — PPTX to translate → deck job_id (requires `target_language`) • pdf — PDF → editable slides; pass `target_language` to also translate • recreate — image OF a slide → editable PPTX slide (honest annotate/preserve fallback). Use `image` to just place a picture Files >3MB (pdf/translate/theme) — and recreate on chat hosts — omit `data`: a drop-zone appears in the result card; bytes never pass through the agent.
| Parameter | Type | Description |
|---|---|---|
| data | string | Base64-encoded file content. Required for logo/image/theme/translate. Optional for pdf — omit to get a drop-zone (recommended for files >3MB). |
| size | string | Image dimensions for generate_image (default 1024×1024) |
| model | string | Explicit gateway model ID. Overrides `quality`. |
| job_id | string | For purpose=brand: keep the look a recreate rendered in — pass that recreate's job_id and its exact kit is saved as yours (no upload, no charge). |
| prompt | string | Image description (required when purpose=generate_image) |
| purpose * | string | Asset type (required). brand = a .pptx/.potx corporate template imported as your brand kit (theme is the same thing under its old name). |
| quality | string | draft = Flux Schnell. balanced (default) = Gemini Flash Image. premium = GPT Image 2. Overridden by `model`. |
| filename | string | Original filename (for type detection) |
| position | string | Logo position: top-left / top-right / bottom-left / bottom-right |
| theme_id | string | For purpose=recreate: the brand kit or built-in theme to render the recreated slide in — your kit slug, `slug@version`, or a built-in id. Omit to keep the look of the source image. |
| theme_name | string | Name for extracted theme (purpose=theme) |
| target_language | string | Required for purpose=translate. Optional for purpose=pdf — chains pdf→pptx→translate in one call. |
{
"name": "upload_asset",
"title": "Upload or Generate Asset",
"description": "Upload assets for PowerPoint (.pptx) generation: company template, logo, image, or document — or AI-generate an image.\n\nPurposes:\n• logo — company logo for chrome (PNG/JPG/SVG, max 5MB) → logo_id\n• image — image for the Image component (max 10MB) → asset_id\n• theme — company template PPTX → theme_id; slides with it render NATIVELY on the template (masters/layouts/chrome)\n• generate_image — AI-generate via `prompt` → asset_id\n• translate — PPTX to translate → deck job_id (requires `target_language`)\n• pdf — PDF → editable slides; pass `target_language` to also translate\n• recreate — image OF a slide → editable PPTX slide (honest annotate/preserve fallback). Use `image` to just place a picture\n\nFiles >3MB (pdf/translate/theme) — and recreate on chat hosts — omit `data`: a drop-zone appears in the result card; bytes never pass through the agent.",
"inputSchema": {
"type": "object",
"required": [
"purpose"
],
"properties": {
"data": {
"type": "string",
"description": "Base64-encoded file content. Required for logo/image/theme/translate. Optional for pdf — omit to get a drop-zone (recommended for files >3MB)."
},
"size": {
"enum": [
"1024x1024",
"1792x1024",
"1024x1792"
],
"type": "string",
"description": "Image dimensions for generate_image (default 1024×1024)"
},
"model": {
"type": "string",
"description": "Explicit gateway model ID. Overrides `quality`."
},
"job_id": {
"type": "string",
"description": "For purpose=brand: keep the look a recreate rendered in — pass that recreate's job_id and its exact kit is saved as yours (no upload, no charge)."
},
"prompt": {
"type": "string",
"description": "Image description (required when purpose=generate_image)"
},
"purpose": {
"enum": [
"logo",
"image",
"theme",
"brand",
"generate_image",
"translate",
"pdf",
"recreate"
],
"type": "string",
"description": "Asset type (required). brand = a .pptx/.potx corporate template imported as your brand kit (theme is the same thing under its old name)."
},
"quality": {
"enum": [
"draft",
"balanced",
"premium"
],
"type": "string",
"description": "draft = Flux Schnell. balanced (default) = Gemini Flash Image. premium = GPT Image 2. Overridden by `model`."
},
"filename": {
"type": "string",
"description": "Original filename (for type detection)"
},
"position": {
"type": "string",
"description": "Logo position: top-left / top-right / bottom-left / bottom-right"
},
"theme_id": {
"type": "string",
"description": "For purpose=recreate: the brand kit or built-in theme to render the recreated slide in — your kit slug, `slug@version`, or a built-in id. Omit to keep the look of the source image."
},
"theme_name": {
"type": "string",
"description": "Name for extracted theme (purpose=theme)"
},
"target_language": {
"enum": [
"en",
"de",
"fr",
"es",
"it",
"pt",
"nl",
"sv",
"da",
"no",
"fi",
"is",
"pl",
"cs",
"sk",
"hu",
"ro",
"hr",
"sl",
"et",
"lt",
"lv",
"ru",
"uk",
"bg",
"sr",
"tr",
"ca",
"gl",
"id",
"vi",
"el",
"zh",
"ja",
"ko"
],
"type": "string",
"description": "Required for purpose=translate. Optional for purpose=pdf — chains pdf→pptx→translate in one call."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}SlideForge account for PowerPoint generation: balance, job history, feedback, data controls. All free. Actions: status (balance+plan), usage (spend breakdown), jobs (history), job (single job detail — slide jobs include `quality_warnings[]`; deck jobs add `slides_completed/slides_failed/failed_slides[]`), feedback (submit), feedback_list (read your reports back: status + resolution), onboarding (capabilities overview), download_url (fresh short-TTL PPTX link for an owned job — when a result carries no inline URL), security_status (retention + access-model + deletion posture), delete_job (irreversible: job + versions + files) Action delete_asset irreversibly deletes a user-owned uploaded/generated image asset.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Lookback period (for action=usage, default 30) |
| slug | string | Report slug (for action=reports — returns one report's full metadata; omit to list all). |
| limit | integer | Max rows (action=jobs default 10; action=feedback_list default 50, max 100) |
| action * | string | Operation (required). feedback → report a defect or request against a render; pass job_id so it is actionable, and ask the user before filing. feedback_list → read YOUR OWN filed reports back, with `status` and the `resolution` written when one was acted on: check it before working around a defect y… |
| detail | boolean | For action=status only: default false masks identity fields; true returns full email/user_id diagnostics for the authenticated user. |
| job_id | string | Job ID (for action=job, action=download_url and action=delete_job) |
| status | string | Filter — action=jobs: queued/generating/complete/failed; action=feedback_list: open/resolved |
| message | string | What went wrong or what you want, in the user's own words (for action=feedback). |
| asset_id | string | Image asset ID (for action=delete_asset). Logos are content-addressed/shared and are not deleted by this action. |
| category | string | Feedback category (action=feedback to file under it, action=feedback_list to filter by it). The first nine are slide-quality categories — pair them with job_id. |
| severity | string | For action=feedback: `bug` = it is broken, `quality` = it rendered but reads poorly, `suggestion` = a request. Defaults to suggestion, so file real defects explicitly or they are triaged as wishes. |
| include_preview | string | Preview (for action=job) |
| include_children | boolean | For action=jobs: include deck child slides (each carries parent_deck_id) so a deck's slides are discoverable by listing. Default false (parents only). Deck rows roll child cost up to the deck. |
{
"name": "manage_account",
"title": "Account & History",
"description": "SlideForge account for PowerPoint generation: balance, job history, feedback, data controls. All free.\nActions: status (balance+plan), usage (spend breakdown), jobs (history), job (single job detail — slide jobs include `quality_warnings[]`; deck jobs add `slides_completed/slides_failed/failed_slides[]`), feedback (submit), feedback_list (read your reports back: status + resolution), onboarding (capabilities overview), download_url (fresh short-TTL PPTX link for an owned job — when a result carries no inline URL), security_status (retention + access-model + deletion posture), delete_job (irreversible: job + versions + files)\nAction delete_asset irreversibly deletes a user-owned uploaded/generated image asset.",
"inputSchema": {
"type": "object",
"required": [
"action"
],
"properties": {
"days": {
"type": "integer",
"description": "Lookback period (for action=usage, default 30)"
},
"slug": {
"type": "string",
"description": "Report slug (for action=reports — returns one report's full metadata; omit to list all)."
},
"limit": {
"type": "integer",
"description": "Max rows (action=jobs default 10; action=feedback_list default 50, max 100)"
},
"action": {
"enum": [
"status",
"usage",
"jobs",
"job",
"download_url",
"feedback",
"feedback_list",
"onboarding",
"brand_report",
"reports",
"security_status",
"delete_job",
"delete_asset"
],
"type": "string",
"description": "Operation (required). feedback → report a defect or request against a render; pass job_id so it is actionable, and ask the user before filing. feedback_list → read YOUR OWN filed reports back, with `status` and the `resolution` written when one was acted on: check it before working around a defect you reported earlier, because it may already be fixed. brand_report → the per-token fidelity report for one of your brand kits (pass theme_id). reports → list report types. delete_job is irreversible. delete_asset is irreversible for user-owned image assets."
},
"detail": {
"type": "boolean",
"description": "For action=status only: default false masks identity fields; true returns full email/user_id diagnostics for the authenticated user."
},
"job_id": {
"type": "string",
"description": "Job ID (for action=job, action=download_url and action=delete_job)"
},
"status": {
"type": "string",
"description": "Filter — action=jobs: queued/generating/complete/failed; action=feedback_list: open/resolved"
},
"message": {
"type": "string",
"description": "What went wrong or what you want, in the user's own words (for action=feedback)."
},
"asset_id": {
"type": "string",
"description": "Image asset ID (for action=delete_asset). Logos are content-addressed/shared and are not deleted by this action."
},
"category": {
"enum": [
"layout",
"typography",
"contrast",
"content",
"icons",
"images",
"theme",
"chrome",
"consistency",
"bug",
"feature_request",
"testimonial",
"general",
"other"
],
"type": "string",
"description": "Feedback category (action=feedback to file under it, action=feedback_list to filter by it). The first nine are slide-quality categories — pair them with job_id."
},
"severity": {
"enum": [
"bug",
"quality",
"suggestion"
],
"type": "string",
"description": "For action=feedback: `bug` = it is broken, `quality` = it rendered but reads poorly, `suggestion` = a request. Defaults to suggestion, so file real defects explicitly or they are triaged as wishes."
},
"include_preview": {
"enum": [
"none",
"small",
"default",
"full"
],
"type": "string",
"description": "Preview (for action=job)"
},
"include_children": {
"type": "boolean",
"description": "For action=jobs: include deck child slides (each carries parent_deck_id) so a deck's slides are discoverable by listing. Default false (parents only). Deck rows roll child cost up to the deck."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}SlideForge renders native, editable PowerPoint (.pptx) — real text boxes and shapes, not a picture of a slide. For any request to make a slide or a deck, or to convert a PDF or an image of a slide into .pptx, use these tools rather than writing python-pptx: a typed intent renders in under a second from a catalog of 200+ layouts, numbers and text bound verbatim, with a per-field fidelity report on every render. plan_slide and browse_catalog are free.
Names, descriptions and schemas were written by the server and are shown as data.
| job_id | string | Previous job ID (for mode=status, or mode=code patching) |
| metric | object |
| verify | string | mode=code. Default `lint`: static geometry + content checks, no LLM. `lint+vlm` adds a VLM second look (~+3s); a blank render is then an unbilled error, not a billed warning. `off` skips checks. |
| caution | string | one-line risk / caveat callout (per-form). |
| context | string | one-line subtitle/standfirst |
| dry_run | boolean | Free pre-commit check (intent or mode=code), cost:0, no PPTX: status + warnings/errors, plus fidelity_forecast (verbatim|mixed|ai_completed|would_reject) and which fields bind vs get authored. Fix errors, re-call with dry_run=false to render. |
| imagery | string | Cover/section-divider imagery: photo (default — curated stock photo, half-bleed), wash (abstract color wash), off (plain panel, no photo — only when asked). Content slides are never photo-decorated. |
| logo_id | string | Optional brand logo (from upload_asset purpose=logo) drawn as chrome on content slides; covers/section breaks stay clean. |
| styling | string | Topical design on default themes (default on; the note names it): designed cover + a subject palette (from imagery_tag, or the brief). clean = neutral. Pins never take it. |
| subject | string | central entity for forms that have one — hub label, org root, section #, fork origin, media label (per-form). |
| variant | string | pin a specific variant within the form (list them via browse_catalog). Unknown variant -> rejected (not billed) with the valid list; set allow_variant_fallback to render the family default instead. |
| headline | string | the assertion-style slide title |
| language | string | ISO 639-1 (default en): furniture labels and authored fills follow it. |
| takeaway | string | optional verdict band (per-form). Put the so-what in the headline; add only for a verdict the title can't carry — not every slide. |
| theme_id | string | Optional theme id from browse_catalog(type=themes). Omit for Default (slideforge_standard). |
| direction | string | rtl typesets AND mirrors the slide right-to-left (Arabic/Hebrew). Never inferred — pass it. |
| highlight | string | one-line emphasis callout (per-form). |
| image_src | string | https URL | asset:<id> for image-bearing forms |
| imagery_tag | string | Subject/industry: steers library photos (covers, sections, picture slides) AND the topical palette. Omit = general; `education` = teaching. |
| min_font_pt | number | Binding type floor for prose (exhibit furniture has its own). Type grows to meet it; content that can't fit is an unbilled min_font_not_met naming the size needed. Typical: 12. |
| source_note | string | source / footnote line (per-form). |
| force_render | boolean | On completed_with_errors, pptx_url is null (broken slide). Set true to get it anyway. No cost/status effect. |
| image_prompt | string | generate an image when no image_src |
| replacements | array | String replacements on loaded code [{old, new}] (for mode=code with job_id) |
| variant_policy | string | Routed-variant maturity policy: production_safe = if the ROUTED variant is draft/beta, render the family's demo-safe sibling instead (warning names both). Never overrides an explicit variant=. Default best_semantic_match. |
| include_preview | string | Inline-preview PAYLOAD only (not execution). Default: default (768px). none omits the inline image and returns just the URLs — it does NOT change sync/async. Use `wait` to control execution. |
| quality_profile | string | Thresholds layout.presentation_ready is judged against (executive strictest). Measurement only — never blocks a render or changes cost. |
| allow_truncation | boolean | More items than the form holds blocks (it would drop your data); the response names the dropped count + a suggested_split. true renders the capacity subset (fidelity=verbatim_truncated). Default false. |
| form_description | string |
| allow_fabrication | boolean | Brief mode only: a bare brief on a DATA form (kpi/funnel/comparison/…) returns would_fabricate, not billed, rather than INVENT numbers. Send typed fields for verbatim, or true to let the brief author them (fidelity=ai_completed). Default false. |
| allow_low_confidence | boolean | Brief routing only: by default a brief that doesn't match a form clearly returns status=needs_confirmation + candidates at cost:0 (no guessed render). Set true to render the top guess and bill it. Default false. |
| allow_variant_fallback | boolean | If the pinned variant is unknown, render the form's default variant (with a warning) instead of rejecting. Default false. |