Skip to main content
Glama

Get one slide

get_slide
Read-onlyIdempotent

One slide of a presentation you can see, with all of its blocks (ids and complete props).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
slugYesThe presentation's slug (its address: /movie/<slug>/).
slide_idYesThe id of a slide (stable, the "id" of the slide in the presentation). Its number (position) changes when slides are reordered.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
hNo
wNo
bgNo
idYesStable id of the slide.
fitNo
urlNoThe address people open in a browser.
nameNo
numberYes1-based position; changes when slides are reordered.
name_trNoThe same text in the other languages of the site: {"en": "..."}.
objectsYesBlocks, bottom to top ("props" only in the full form).
versionNoStamp of the content as it is now: give it back as "base_version" to change it only if nobody else did meanwhile.
backgroundNoThe "src" of the background picture, or null.
transitionNoEntrance effect of this incoming slide.
layout_warningsNoHow the changed slides will probably look: texts too long for their blocks, blocks outside the slide, texts over each other (estimated -- look at them).
transition_durationNoAnimation milliseconds, not auto advance.
missing_translationsNoWhat is not translated yet into the other languages of the site (add it): the first ones; "missing_translations_count" says how many there are.
missing_translations_countNoHow many texts are not translated yet.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • addedOutput schema / properties / layout_warnings
      Added value: +{
      +  "description": "How the changed slides will probably look: texts too long for their blocks, blocks outside the slide, texts over each other (estimated -- look at them).",
      +  "items": {
      +    "properties": {
      +      "block_id": {
      +        "type": "integer"
      +      },
      +      "detail": {
      +        "type": "string"
      +      },
      +      "problem": {
      +        "description": "overflow, cut, outside or overlap.",
      +        "type": "string"
      +      },
      +      "slide_id": {
      +        "type": "integer"
      +      },
      +      "slide_number": {
      +        "type": "integer"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / missing_translations / description
      Previous value: -"What is not translated yet into the other languages of the site (add it)."New value: +"What is not translated yet into the other languages of the site (add it): the first ones; \"missing_translations_count\" says how many there are."
    • addedOutput schema / properties / missing_translations_count
      Added value: +{
      +  "description": "How many texts are not translated yet.",
      +  "type": "integer"
      +}
    • addedOutput schema / properties / version
      Added value: +{
      +  "description": "Stamp of the content as it is now: give it back as \"base_version\" to change it only if nobody else did meanwhile.",
      +  "type": "string"
      +}
  2. Changed2 schema fields changed
    • addedOutput schema / properties / transition
      Added value: +{
      +  "description": "Entrance effect of this incoming slide.",
      +  "enum": [
      +    "none",
      +    "fade",
      +    "slide-left",
      +    "slide-right",
      +    "zoom"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / transition_duration
      Added value: +{
      +  "description": "Animation milliseconds, not auto advance.",
      +  "maximum": 3000,
      +  "minimum": 100,
      +  "type": "integer"
      +}
  3. Changed2 schema fields changed
    • addedOutput schema / properties / missing_translations
      Added value: +{
      +  "description": "What is not translated yet into the other languages of the site (add it).",
      +  "items": {
      +    "properties": {
      +      "block_id": {
      +        "type": "integer"
      +      },
      +      "lang": {
      +        "type": "string"
      +      },
      +      "slide_id": {
      +        "type": "integer"
      +      },
      +      "slide_number": {
      +        "type": "integer"
      +      },
      +      "what": {
      +        "description": "title, slide name or block.",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / name_tr
      Added value: +{
      +  "description": "The same text in the other languages of the site: {\"en\": \"...\"}.",
      +  "type": "object"
      +}
  4. Changed3 schema fields changed
    • addedOutput schema / description
      Added value: +"A slide; the brief form (the default of the tools that change slides) has only id, number, name, url and the id and type of every block."
    • changedOutput schema / properties / objects / description
      Previous value: -"Blocks, bottom to top."New value: +"Blocks, bottom to top (\"props\" only in the full form)."
    • changedOutput schema / properties / objects / items / required
      Previous value: -[
      -  "id",
      -  "type",
      -  "props"
      -]New value: +[
      +  "id",
      +  "type"
      +]
  5. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "background": {
      +      "description": "The \"src\" of the background picture, or null.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "bg": {
      +      "type": "string"
      +    },
      +    "fit": {
      +      "type": "string"
      +    },
      +    "h": {
      +      "type": "integer"
      +    },
      +    "id": {
      +      "description": "Stable id of the slide.",
      +      "type": "integer"
      +    },
      +    "name": {
      +      "type": "string"
      +    },
      +    "number": {
      +      "description": "1-based position; changes when slides are reordered.",
      +      "type": "integer"
      +    },
      +    "objects": {
      +      "description": "Blocks, bottom to top.",
      +      "items": {
      +        "properties": {
      +          "id": {
      +            "type": "integer"
      +          },
      +          "props": {
      +            "description": "Every prop of the block (see the block format reference).",
      +            "type": "object"
      +          },
      +          "type": {
      +            "description": "text, shape, button, line, image or code.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "type",
      +          "props"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "url": {
      +      "description": "The address people open in a browser.",
      +      "type": "string"
      +    },
      +    "w": {
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "id",
      +    "number",
      +    "objects"
      +  ],
      +  "type": "object"
      +}
  6. First observed

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, non-destructive, and non-openWorld, so the safety profile is fully covered. The description adds modest value by explaining that the returned slide includes all blocks with ids and complete props, but says nothing about visibility/permission constraints or pagination that a 'can see' qualifier hints at.

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

Conciseness4/5

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

A single front-loaded sentence that efficiently conveys scope and return content with no filler. It is arguably terse, but every clause earns its place.

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

Completeness3/5

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

With an output schema covering return values and annotations covering safety, the description needn't explain those. For a simple two-param read tool it is close to complete, but given the crowded sibling set it should have clarified when to prefer this over get_presentation/read_presentation.

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

Parameters3/5

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

Schema description coverage is 100%; both slug and slide_id are well documented (including the stable-id-vs-position caveat). The description adds nothing beyond the schema, so the baseline 3 is appropriate.

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

Purpose4/5

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

Names a specific verb and resource (get one slide) plus what it returns ('all of its blocks (ids and complete props)'), so the agent knows exactly what it fetches. However, it does not distinguish itself from close siblings like get_presentation, read_presentation, or preview_slides, leaving the 'one slide vs whole deck' boundary implicit.

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

Usage Guidelines2/5

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

No when-to-use guidance, no prerequisites, and no mention of alternatives. The presence of get_presentation, read_presentation, update_slide, and preview_slides among siblings makes routing ambiguous, and the description offers nothing to resolve it.

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