Skip to main content
Glama

Update template

update_template
Destructive

Change a template the user already saved. The change is saved to the template's draft: the share link, the presentation and export_pptx(template_id) keep showing the published version until you call publish_template. Requires a Pro account; without one the call fails and nothing is changed. Pass the template id and any of: name, theme_id, palette (replaces the deck palette), slides (replaces all slides), or append_slides (adds slides to the end). Read the latest content with get_template(draft: true) first: slides replaces the whole draft. Fields you do not know in what get_template returned (on objects, styles, overrides) must be sent back as they were. Runs (formatting of part of a text): offsets must fit the text sent with them, else invalid_input. When you change a slot's or an object's text and send its runs back exactly as get_template gave them, they are moved with the text (listed in runs_moved); send new runs to set them yourself, or an empty list to remove them. A template holds at most 40 slides on Pro and 100 on Team. If the result would be more than the plan allows, nothing is changed and the response is a slide_limit error that includes how many slides still fit. Call list_templates first to read slide_count when you plan to append. The response has the same fields as save_template, with saved_to "draft", published_version and draft_version. Deleting is not available here, only on the web. To avoid overwriting someone else's edit, pass expected_draft_version (the draft_version from get_template or your last save). If the template already has a draft that was last written by someone other than this API key (the user on the web, or another key), replacing all slides (slides) without expected_draft_version is refused with draft_exists, so a draft you did not read is not overwritten; your own earlier writes do not count, and expected_version does not lift the refusal. append_slides, name and theme changes are not affected. expected_version (the published version) still works for older callers: it fails with conflict if someone has published since. Errors: pro_required, not_found, slide_limit, draft_exists (slides sent without expected_draft_version while a draft that someone else wrote last exists), conflict (the draft changed since expected_draft_version, the published version changed since expected_version, or the draft kept changing during an append; nothing was saved), unknown_theme, invalid_input.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "id": "<id>"
    },
    "name": "update_template"
  }
}

Input Schema

NameRequiredDescriptionDefault
idYesTemplate id from list_templates.
nameNoNew template name.
slidesNoReplaces all slides of the draft.
paletteNoThe template's deck palette: up to 64 entries [{ "name": "Brand red", "color": "#c8102e" }]. Names are 1-40 letters, digits, spaces, "_" or "-", unique (ignoring case). Elements point at an entry with "palette:<name>". Sending palette replaces the whole list; null or [] removes it. Leave it out to keep it as it is.
theme_idNoNew theme: a catalog theme id or custom:<uuid>.
append_slidesNoSlides added to the end of the draft. Existing slides stay.
expected_versionNoOlder callers: the published version (version or published_version from get_template). Given, the call fails with conflict if the template was published since.
expected_draft_versionNoThe draft_version from get_template or a previous save (0: no draft yet). Given, the call fails with conflict if the draft changed since.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • changedInput schema / properties / append_slides / description
      Previous value: -"Slides added to the end. Existing slides stay."New value: +"Slides added to the end of the draft. Existing slides stay."
    • addedInput schema / properties / expected_draft_version
      Added value: +{
      +  "description": "The draft_version from get_template or a previous save (0: no draft yet). Given, the call fails with conflict if the draft changed since.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedInput schema / properties / expected_version / description
      Previous value: -"The version from get_template or a previous save. Given, the call fails with conflict if the template changed since."New value: +"Older callers: the published version (version or published_version from get_template). Given, the call fails with conflict if the template was published since."
    • changedInput schema / properties / slides / description
      Previous value: -"Replaces all slides of the template."New value: +"Replaces all slides of the draft."
  2. Changed31 schema fields changed
    • addedInput schema / properties / append_slides / items / properties / objects / items / properties / group
      Added value: +{
      +  "description": "Objects with the same group id move and copy together in the web editor; keep it when you resend.",
      +  "type": "string"
      +}
    • addedInput schema / properties / append_slides / items / properties / objects / items / properties / locked
      Added value: +{
      +  "description": "true: the user locked it on the web; keep it when you resend.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / append_slides / items / properties / objects / items / properties / runs
      Added value: +{
      +  "description": "For type \"text\". Formatting of part of the text: [{ start, end, bold?, italic?, underline?, color?, link? }]. start and end are UTF-16 offsets into the text (JavaScript string indices: a Korean syllable counts 1, an emoji outside the basic plane 2), end exclusive, start < end. bold, italic, underline are true or false (false undoes a look the whole text has); color takes the colour forms below; link is kept for a later version and not drawn yet. The text itself stays plain. Ranges must fit the text, else the call fails with invalid_input. Shown in the editor, the PPTX (one text run per piece) and the HTML export. Changing the text without sending runs moves the stored runs with it (text before a range shifts it; a range whose characters are all deleted is dropped); send runs with the text to set them yourself, null (update_objects) or [] to remove them. Fields you do not know on a run are kept.",
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "end": {
      +        "type": "number"
      +      },
      +      "start": {
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "start",
      +      "end"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / append_slides / items / properties / objects / items / properties / shape
      Added value: +{
      +  "description": "For type \"shape\": \"rect\", \"roundRect\", \"ellipse\", \"line\" or \"arrow\".",
      +  "type": "string"
      +}
    • addedInput schema / properties / append_slides / items / properties / objects / items / properties / style / description
      Added value: +"For type \"text\" and \"shape\". Look fields (all optional; send null to take one away and go back to the default): text: size (8-400 px; in an override entry it is called fontSize), weight (400 or 700), italic, underline, strike (true/false), align (\"left\", \"center\", \"right\"), lineHeight (multiple of the size, 0.5-4), vAlign (\"top\", \"middle\", \"bottom\"; text boxes only), color. box: fill (a colour or \"none\"), fillOpacity (0-1), borderColor, borderWidth (0-40 px), radius (0-540 px), shadow (\"none\", \"sm\", \"md\", \"lg\"). line (strokes of a drawn line or icon): lineColor, lineWidth (0.5-40 px), dash (\"solid\", \"dash\", \"dot\"; also the border's style). A colour is one of: a theme colour token (ink, ink-soft, ink-muted, ink-on-dark, accent, accent-soft, accent-bg, bg, bg-alt, bg-inverse, border, border-strong, success, warning, danger), which follows the theme; \"palette:<name>\" for an entry of the template's deck palette, which follows that entry; or a direct colour \"#rrggbb\" (no alpha; use fillOpacity for a see-through fill). Palette and direct colours stay when the theme changes, also with a custom theme. Some layout elements are drawn as a picture in the PPTX; colours stored for them are ignored on every output."
    • changedInput schema / properties / append_slides / items / properties / objects / items / properties / style / properties / color / description
      Previous value: -"A theme token name such as \"ink\" or \"accent\", not a color value."New value: +"A colour is one of: a theme colour token (ink, ink-soft, ink-muted, ink-on-dark, accent, accent-soft, accent-bg, bg, bg-alt, bg-inverse, border, border-strong, success, warning, danger), which follows the theme; \"palette:<name>\" for an entry of the template's deck palette, which follows that entry; or a direct colour \"#rrggbb\" (no alpha; use fillOpacity for a see-through fill). Palette and direct colours stay when the theme changes, also with a custom theme."
    • changedInput schema / properties / append_slides / items / properties / objects / items / properties / text / description
      Previous value: -"For type \"text\"."New value: +"For type \"text\", and a box shape's inner text."
    • changedInput schema / properties / append_slides / items / properties / objects / items / properties / type / description
      Previous value: -"\"image\" or \"text\"."New value: +"\"image\", \"text\" or \"shape\"."
    • addedInput schema / properties / append_slides / items / properties / overrides / additionalProperties / description
      Added value: +"Only what changed. Look fields (all optional; send null to take one away and go back to the default): text: size (8-400 px; in an override entry it is called fontSize), weight (400 or 700), italic, underline, strike (true/false), align (\"left\", \"center\", \"right\"), lineHeight (multiple of the size, 0.5-4), vAlign (\"top\", \"middle\", \"bottom\"; text boxes only), color. box: fill (a colour or \"none\"), fillOpacity (0-1), borderColor, borderWidth (0-40 px), radius (0-540 px), shadow (\"none\", \"sm\", \"md\", \"lg\"). line (strokes of a drawn line or icon): lineColor, lineWidth (0.5-40 px), dash (\"solid\", \"dash\", \"dot\"; also the border's style). A colour is one of: a theme colour token (ink, ink-soft, ink-muted, ink-on-dark, accent, accent-soft, accent-bg, bg, bg-alt, bg-inverse, border, border-strong, success, warning, danger), which follows the theme; \"palette:<name>\" for an entry of the template's deck palette, which follows that entry; or a direct colour \"#rrggbb\" (no alpha; use fillOpacity for a see-through fill). Palette and direct colours stay when the theme changes, also with a custom theme. Some layout elements are drawn as a picture in the PPTX; colours stored for them are ignored on every output."
    • addedInput schema / properties / append_slides / items / properties / overrides / additionalProperties / properties / color
      Added value: +{
      +  "description": "A colour is one of: a theme colour token (ink, ink-soft, ink-muted, ink-on-dark, accent, accent-soft, accent-bg, bg, bg-alt, bg-inverse, border, border-strong, success, warning, danger), which follows the theme; \"palette:<name>\" for an entry of the template's deck palette, which follows that entry; or a direct colour \"#rrggbb\" (no alpha; use fillOpacity for a see-through fill). Palette and direct colours stay when the theme changes, also with a custom theme.",
      +  "type": "string"
      +}
    • addedInput schema / properties / append_slides / items / properties / overrides / additionalProperties / properties / fill
      Added value: +{
      +  "description": "Box fill: a colour, or \"none\".",
      +  "type": "string"
      +}
    • addedInput schema / properties / append_slides / items / properties / overrides / additionalProperties / properties / fontSize
      Added value: +{
      +  "description": "Text size in px, 8 to 400.",
      +  "type": "number"
      +}
    • addedInput schema / properties / append_slides / items / properties / overrides / additionalProperties / properties / locked
      Added value: +{
      +  "description": "true: the user locked the element on the web (no effect on the look or the export); keep it when you resend.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / append_slides / items / properties / overrides / additionalProperties / properties / runs
      Added value: +{
      +  "description": "For a text slot element. Formatting of part of the text: [{ start, end, bold?, italic?, underline?, color?, link? }]. start and end are UTF-16 offsets into the text (JavaScript string indices: a Korean syllable counts 1, an emoji outside the basic plane 2), end exclusive, start < end. bold, italic, underline are true or false (false undoes a look the whole text has); color takes the colour forms below; link is kept for a later version and not drawn yet. The text itself stays plain. Ranges must fit the text, else the call fails with invalid_input. Shown in the editor, the PPTX (one text run per piece) and the HTML export. Changing the text without sending runs moves the stored runs with it (text before a range shifts it; a range whose characters are all deleted is dropped); send runs with the text to set them yourself, null (update_objects) or [] to remove them. Fields you do not know on a run are kept.",
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "end": {
      +        "type": "number"
      +      },
      +      "start": {
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "start",
      +      "end"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / append_slides / items / properties / overrides / description
      Previous value: -"Changes to the layout's own elements, by element key: { \"top-accent-bar\": { \"deleted\": true }, \"title\": { \"x\": 40, \"y\": 62 } }. Only the values that changed are given; x, y, w, h are pixels on the 1920x1080 slide and the rest stays as the layout draws it. Resend the overrides you got from get_template or they are removed. Requires Pro."New value: +"Changes to the layout's own elements, by element key: { \"top-accent-bar\": { \"deleted\": true }, \"title\": { \"x\": 40, \"y\": 62, \"color\": \"#c8102e\", \"italic\": true } }. Only the values that changed are given; x, y, w, h are pixels on the 1920x1080 slide and the rest stays as the layout draws it. Look fields (colour, fill, border, line spacing...) sit in the same entry; see the entry schema. Resend the overrides you got from get_template or they are removed. Requires Pro."
    • addedInput schema / properties / palette
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "color": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "color"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "The template's deck palette: up to 64 entries [{ \"name\": \"Brand red\", \"color\": \"#c8102e\" }]. Names are 1-40 letters, digits, spaces, \"_\" or \"-\", unique (ignoring case). Elements point at an entry with \"palette:<name>\". Sending palette replaces the whole list; null or [] removes it. Leave it out to keep it as it is."
      +}
    • addedInput schema / properties / slides / items / properties / objects / items / properties / group
      Added value: +{
      +  "description": "Objects with the same group id move and copy together in the web editor; keep it when you resend.",
      +  "type": "string"
      +}
    • addedInput schema / properties / slides / items / properties / objects / items / properties / locked
      Added value: +{
      +  "description": "true: the user locked it on the web; keep it when you resend.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / slides / items / properties / objects / items / properties / runs
      Added value: +{
      +  "description": "For type \"text\". Formatting of part of the text: [{ start, end, bold?, italic?, underline?, color?, link? }]. start and end are UTF-16 offsets into the text (JavaScript string indices: a Korean syllable counts 1, an emoji outside the basic plane 2), end exclusive, start < end. bold, italic, underline are true or false (false undoes a look the whole text has); color takes the colour forms below; link is kept for a later version and not drawn yet. The text itself stays plain. Ranges must fit the text, else the call fails with invalid_input. Shown in the editor, the PPTX (one text run per piece) and the HTML export. Changing the text without sending runs moves the stored runs with it (text before a range shifts it; a range whose characters are all deleted is dropped); send runs with the text to set them yourself, null (update_objects) or [] to remove them. Fields you do not know on a run are kept.",
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "end": {
      +        "type": "number"
      +      },
      +      "start": {
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "start",
      +      "end"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / slides / items / properties / objects / items / properties / shape
      Added value: +{
      +  "description": "For type \"shape\": \"rect\", \"roundRect\", \"ellipse\", \"line\" or \"arrow\".",
      +  "type": "string"
      +}
    • addedInput schema / properties / slides / items / properties / objects / items / properties / style / description
      Added value: +"For type \"text\" and \"shape\". Look fields (all optional; send null to take one away and go back to the default): text: size (8-400 px; in an override entry it is called fontSize), weight (400 or 700), italic, underline, strike (true/false), align (\"left\", \"center\", \"right\"), lineHeight (multiple of the size, 0.5-4), vAlign (\"top\", \"middle\", \"bottom\"; text boxes only), color. box: fill (a colour or \"none\"), fillOpacity (0-1), borderColor, borderWidth (0-40 px), radius (0-540 px), shadow (\"none\", \"sm\", \"md\", \"lg\"). line (strokes of a drawn line or icon): lineColor, lineWidth (0.5-40 px), dash (\"solid\", \"dash\", \"dot\"; also the border's style). A colour is one of: a theme colour token (ink, ink-soft, ink-muted, ink-on-dark, accent, accent-soft, accent-bg, bg, bg-alt, bg-inverse, border, border-strong, success, warning, danger), which follows the theme; \"palette:<name>\" for an entry of the template's deck palette, which follows that entry; or a direct colour \"#rrggbb\" (no alpha; use fillOpacity for a see-through fill). Palette and direct colours stay when the theme changes, also with a custom theme. Some layout elements are drawn as a picture in the PPTX; colours stored for them are ignored on every output."
    • changedInput schema / properties / slides / items / properties / objects / items / properties / style / properties / color / description
      Previous value: -"A theme token name such as \"ink\" or \"accent\", not a color value."New value: +"A colour is one of: a theme colour token (ink, ink-soft, ink-muted, ink-on-dark, accent, accent-soft, accent-bg, bg, bg-alt, bg-inverse, border, border-strong, success, warning, danger), which follows the theme; \"palette:<name>\" for an entry of the template's deck palette, which follows that entry; or a direct colour \"#rrggbb\" (no alpha; use fillOpacity for a see-through fill). Palette and direct colours stay when the theme changes, also with a custom theme."
    • changedInput schema / properties / slides / items / properties / objects / items / properties / text / description
      Previous value: -"For type \"text\"."New value: +"For type \"text\", and a box shape's inner text."
    • changedInput schema / properties / slides / items / properties / objects / items / properties / type / description
      Previous value: -"\"image\" or \"text\"."New value: +"\"image\", \"text\" or \"shape\"."
    • addedInput schema / properties / slides / items / properties / overrides / additionalProperties / description
      Added value: +"Only what changed. Look fields (all optional; send null to take one away and go back to the default): text: size (8-400 px; in an override entry it is called fontSize), weight (400 or 700), italic, underline, strike (true/false), align (\"left\", \"center\", \"right\"), lineHeight (multiple of the size, 0.5-4), vAlign (\"top\", \"middle\", \"bottom\"; text boxes only), color. box: fill (a colour or \"none\"), fillOpacity (0-1), borderColor, borderWidth (0-40 px), radius (0-540 px), shadow (\"none\", \"sm\", \"md\", \"lg\"). line (strokes of a drawn line or icon): lineColor, lineWidth (0.5-40 px), dash (\"solid\", \"dash\", \"dot\"; also the border's style). A colour is one of: a theme colour token (ink, ink-soft, ink-muted, ink-on-dark, accent, accent-soft, accent-bg, bg, bg-alt, bg-inverse, border, border-strong, success, warning, danger), which follows the theme; \"palette:<name>\" for an entry of the template's deck palette, which follows that entry; or a direct colour \"#rrggbb\" (no alpha; use fillOpacity for a see-through fill). Palette and direct colours stay when the theme changes, also with a custom theme. Some layout elements are drawn as a picture in the PPTX; colours stored for them are ignored on every output."
    • addedInput schema / properties / slides / items / properties / overrides / additionalProperties / properties / color
      Added value: +{
      +  "description": "A colour is one of: a theme colour token (ink, ink-soft, ink-muted, ink-on-dark, accent, accent-soft, accent-bg, bg, bg-alt, bg-inverse, border, border-strong, success, warning, danger), which follows the theme; \"palette:<name>\" for an entry of the template's deck palette, which follows that entry; or a direct colour \"#rrggbb\" (no alpha; use fillOpacity for a see-through fill). Palette and direct colours stay when the theme changes, also with a custom theme.",
      +  "type": "string"
      +}
    • addedInput schema / properties / slides / items / properties / overrides / additionalProperties / properties / fill
      Added value: +{
      +  "description": "Box fill: a colour, or \"none\".",
      +  "type": "string"
      +}
    • addedInput schema / properties / slides / items / properties / overrides / additionalProperties / properties / fontSize
      Added value: +{
      +  "description": "Text size in px, 8 to 400.",
      +  "type": "number"
      +}
    • addedInput schema / properties / slides / items / properties / overrides / additionalProperties / properties / locked
      Added value: +{
      +  "description": "true: the user locked the element on the web (no effect on the look or the export); keep it when you resend.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / slides / items / properties / overrides / additionalProperties / properties / runs
      Added value: +{
      +  "description": "For a text slot element. Formatting of part of the text: [{ start, end, bold?, italic?, underline?, color?, link? }]. start and end are UTF-16 offsets into the text (JavaScript string indices: a Korean syllable counts 1, an emoji outside the basic plane 2), end exclusive, start < end. bold, italic, underline are true or false (false undoes a look the whole text has); color takes the colour forms below; link is kept for a later version and not drawn yet. The text itself stays plain. Ranges must fit the text, else the call fails with invalid_input. Shown in the editor, the PPTX (one text run per piece) and the HTML export. Changing the text without sending runs moves the stored runs with it (text before a range shifts it; a range whose characters are all deleted is dropped); send runs with the text to set them yourself, null (update_objects) or [] to remove them. Fields you do not know on a run are kept.",
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "end": {
      +        "type": "number"
      +      },
      +      "start": {
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "start",
      +      "end"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / slides / items / properties / overrides / description
      Previous value: -"Changes to the layout's own elements, by element key: { \"top-accent-bar\": { \"deleted\": true }, \"title\": { \"x\": 40, \"y\": 62 } }. Only the values that changed are given; x, y, w, h are pixels on the 1920x1080 slide and the rest stays as the layout draws it. Resend the overrides you got from get_template or they are removed. Requires Pro."New value: +"Changes to the layout's own elements, by element key: { \"top-accent-bar\": { \"deleted\": true }, \"title\": { \"x\": 40, \"y\": 62, \"color\": \"#c8102e\", \"italic\": true } }. Only the values that changed are given; x, y, w, h are pixels on the 1920x1080 slide and the rest stays as the layout draws it. Look fields (colour, fill, border, line spacing...) sit in the same entry; see the entry schema. Resend the overrides you got from get_template or they are removed. Requires Pro."
  3. Changed7 schema fields changed
    • addedInput schema / properties / append_slides / description
      Added value: +"Slides added to the end. Existing slides stay."
    • addedInput schema / properties / append_slides / items / properties / layout / description
      Added value: +"Layout id from list_layouts or suggest_deck."
    • addedInput schema / properties / id / description
      Added value: +"Template id from list_templates."
    • addedInput schema / properties / name / description
      Added value: +"New template name."
    • addedInput schema / properties / slides / description
      Added value: +"Replaces all slides of the template."
    • addedInput schema / properties / slides / items / properties / layout / description
      Added value: +"Layout id from list_layouts or suggest_deck."
    • addedInput schema / properties / theme_id / description
      Added value: +"New theme: a catalog theme id or custom:<uuid>."
  4. Changed6 schema fields changed
    • addedInput schema / properties / append_slides / items / properties / id
      Added value: +{
      +  "description": "The slide's id from get_template. Keep it when you resend a slide; leave it out for a new slide and the server assigns one.",
      +  "type": "string"
      +}
    • addedInput schema / properties / append_slides / items / properties / objects
      Added value: +{
      +  "description": "Images and text boxes laid over the slide, in 1920x1080 pixels. Resend the objects you got from get_template or they are removed. At most 50 per slide.",
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "alt": {
      +        "description": "For type \"image\": a short description of the picture for screen readers (up to 300 characters).",
      +        "type": "string"
      +      },
      +      "asset": {
      +        "description": "For type \"image\": the id of an image in the user's media library.",
      +        "type": "string"
      +      },
      +      "behind": {
      +        "description": "true: drawn behind the layout's own elements, on top of the slide background. Absent or false: in front of the layout.",
      +        "type": "boolean"
      +      },
      +      "h": {
      +        "type": "number"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "rotate": {
      +        "type": "number"
      +      },
      +      "style": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "align": {
      +            "type": "string"
      +          },
      +          "color": {
      +            "description": "A theme token name such as \"ink\" or \"accent\", not a color value.",
      +            "type": "string"
      +          },
      +          "size": {
      +            "type": "number"
      +          },
      +          "weight": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "text": {
      +        "description": "For type \"text\".",
      +        "type": "string"
      +      },
      +      "type": {
      +        "description": "\"image\" or \"text\".",
      +        "type": "string"
      +      },
      +      "w": {
      +        "type": "number"
      +      },
      +      "x": {
      +        "type": "number"
      +      },
      +      "y": {
      +        "type": "number"
      +      },
      +      "z": {
      +        "description": "Stacking order; larger is in front. Each layer (see behind) is ordered on its own.",
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "x",
      +      "y",
      +      "w",
      +      "h",
      +      "z"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / append_slides / items / properties / overrides
      Added value: +{
      +  "additionalProperties": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "deleted": {
      +        "description": "true: the element is not drawn on this slide (not in the export either).",
      +        "type": "boolean"
      +      },
      +      "h": {
      +        "type": "number"
      +      },
      +      "w": {
      +        "type": "number"
      +      },
      +      "x": {
      +        "type": "number"
      +      },
      +      "y": {
      +        "type": "number"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "description": "Changes to the layout's own elements, by element key: { \"top-accent-bar\": { \"deleted\": true }, \"title\": { \"x\": 40, \"y\": 62 } }. Only the values that changed are given; x, y, w, h are pixels on the 1920x1080 slide and the rest stays as the layout draws it. Resend the overrides you got from get_template or they are removed. Requires Pro.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / slides / items / properties / id
      Added value: +{
      +  "description": "The slide's id from get_template. Keep it when you resend a slide; leave it out for a new slide and the server assigns one.",
      +  "type": "string"
      +}
    • addedInput schema / properties / slides / items / properties / objects
      Added value: +{
      +  "description": "Images and text boxes laid over the slide, in 1920x1080 pixels. Resend the objects you got from get_template or they are removed. At most 50 per slide.",
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "alt": {
      +        "description": "For type \"image\": a short description of the picture for screen readers (up to 300 characters).",
      +        "type": "string"
      +      },
      +      "asset": {
      +        "description": "For type \"image\": the id of an image in the user's media library.",
      +        "type": "string"
      +      },
      +      "behind": {
      +        "description": "true: drawn behind the layout's own elements, on top of the slide background. Absent or false: in front of the layout.",
      +        "type": "boolean"
      +      },
      +      "h": {
      +        "type": "number"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "rotate": {
      +        "type": "number"
      +      },
      +      "style": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "align": {
      +            "type": "string"
      +          },
      +          "color": {
      +            "description": "A theme token name such as \"ink\" or \"accent\", not a color value.",
      +            "type": "string"
      +          },
      +          "size": {
      +            "type": "number"
      +          },
      +          "weight": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "text": {
      +        "description": "For type \"text\".",
      +        "type": "string"
      +      },
      +      "type": {
      +        "description": "\"image\" or \"text\".",
      +        "type": "string"
      +      },
      +      "w": {
      +        "type": "number"
      +      },
      +      "x": {
      +        "type": "number"
      +      },
      +      "y": {
      +        "type": "number"
      +      },
      +      "z": {
      +        "description": "Stacking order; larger is in front. Each layer (see behind) is ordered on its own.",
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "x",
      +      "y",
      +      "w",
      +      "h",
      +      "z"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / slides / items / properties / overrides
      Added value: +{
      +  "additionalProperties": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "deleted": {
      +        "description": "true: the element is not drawn on this slide (not in the export either).",
      +        "type": "boolean"
      +      },
      +      "h": {
      +        "type": "number"
      +      },
      +      "w": {
      +        "type": "number"
      +      },
      +      "x": {
      +        "type": "number"
      +      },
      +      "y": {
      +        "type": "number"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "description": "Changes to the layout's own elements, by element key: { \"top-accent-bar\": { \"deleted\": true }, \"title\": { \"x\": 40, \"y\": 62 } }. Only the values that changed are given; x, y, w, h are pixels on the 1920x1080 slide and the rest stays as the layout draws it. Resend the overrides you got from get_template or they are removed. Requires Pro.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
  5. Added

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With destructiveHint=true already declared, the description nonetheless adds substantial non-redundant behavior: draft-vs-published visibility, the Pro account gate with atomic failure, per-plan slide caps (40/100) with a slide_limit error that reports remaining capacity, the draft_exists refusal protecting other writers' drafts, the runs_moved migration semantics, and a full error taxonomy with nothing-partially-saved guarantees. The only shortfall is density: the interleaved prose makes the exact precedence between expected_draft_version and expected_version slow to extract.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The critical constraints are front-loaded, but the body is a single dense block in which the error catalog largely restates conditions already explained in prose (draft_exists, conflict), and nested parentheticals ("Runs (formatting of part of a text)") make it hard to scan. Little is truly wasted, but the lack of structure costs it.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 8-parameter mutation with draft/published versioning, plan limits, and cross-writer conflict rules, the description covers everything needed to call it safely: prerequisites, atomicity, limits, versioning, and error recovery. No output schema exists, and the response shape is described by reference to save_template with the specific differing fields named.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description earns above that by supplying cross-parameter semantics the schema cannot express — slides replaces the entire draft (hence the mandatory read-first), palette replaces the deck palette, append_slides preserves existing slides, and expected_draft_version derives from get_template or a prior save. It also notes that expected_version does not lift the draft_exists refusal, a rule no single parameter description conveys.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence states a specific verb and resource ("Change a template the user already saved") and immediately disambiguates it from siblings by clarifying that edits land in the draft while the share link and export_pptx keep serving the published version until publish_template is called. An agent can distinguish this from save_template and publish_template without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It names the prerequisite read (get_template with draft: true) and the reason for it (slides replaces the whole draft), names list_templates for slide_count before appending, and states an explicit exclusion: "Deleting is not available here, only on the web." Conflict-avoidance guidance is also routed by name (expected_draft_version, expected_version for older callers).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources