Skip to main content
Glama

get_generations

Read-onlyIdempotent

Get the full record of generations of yours by id: each one's download URL and expiry, promptJSON (the original call, so the generation can be extended or reproduced), its current delivery settings, where its reference images came from, and its parents (the set it extends, or the generations its references were copied from). The ids come from list_recent_generations or from a generation's download URL. Ids that are not found are reported without failing the call, which fails only when none was found. Up to 50 ids per call. Costs no credits.

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": {
      "generations": "<generations>"
    },
    "name": "get_generations"
  }
}

Input Schema

NameRequiredDescriptionDefault
generationsYesThe ids of the generations to get: the random segment of each one's download URL.

Output Schema

NameRequiredDescriptionDefault
notFoundNoIds that were not found for this API key or whose download window has closed.
generationsYesThe generations found, in the order asked for, each with its full record.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / generations / items / properties / crispBaseSize / description
      Previous value: -"The largest base size, in pixels, at which export_set keeps every density of this batch crisp (no image enlarged past its source pixels) at its current levers; absent when no base size does. An image or character set's is set by its subject or variation count at generation, and edits to size, canvas, margin or sizing can move it; an illustration set's is a quarter of the longest side its scenes were drawn at, the largest it exports at."New value: +"The largest base size, in pixels, at which export_set keeps every density of this batch crisp (no image enlarged past its source pixels) at its current levers; absent when no base size does. For every set but an illustration set it is set by how many images the batch holds at generation, and edits to size, canvas, margin or sizing can move it; an illustration set's is a quarter of the longest side its scenes were drawn at, the largest it exports at."
  2. Changed3 schema fields changed
    • changedOutput schema / properties / generations / items / properties / levers / description
      Previous value: -"The delivery levers now in force (width, height, canvas, minimumMargin, sizing, format, quality, background; an illustration set has width, height, format and quality): the first delivery's until edit_set changes them. Absent on sets from before editing existed."New value: +"The delivery levers now in force (width, height, canvas, minimumMargin, sizing, format, quality, background, and maxKB when a file size limit is set; an illustration set has width, height, format and quality): the first delivery's until edit_set changes them. Absent on sets from before editing existed."
    • addedOutput schema / properties / generations / items / properties / levers / properties / maxKB
      Added value: +{
      +  "type": "integer"
      +}
    • changedOutput schema / properties / generations / items / properties / promptJSON / description
      Previous value: -"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (the style or character, the list and the references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, sizing, format, quality) are the current delivery, which edit_set rewrites, so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its background is the color the set was generated on, or transparent (a set generated transparent stays transparent here after an edit changes its background to a color; levers holds the color). Its shape follows the tool named in its own tool field. Image sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background (a color, or transparent), and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places; illustration sets carry style, styleReferences, scenes, width, height, format and quality. Read each entry's description (subjects[], variations[] or scenes[]) to reproduce a set: an entry given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."New value: +"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (the style or character, the list and the references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, sizing, format, quality, maxKB) are the current delivery, which edit_set rewrites, so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its background is the color the set was generated on, or transparent (a set generated transparent stays transparent here after an edit changes its background to a color; levers holds the color). Its shape follows the tool named in its own tool field. Image sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background (a color, or transparent), and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places; illustration sets carry style, styleReferences, scenes, width, height, format and quality. Read each entry's description (subjects[], variations[] or scenes[]) to reproduce a set: an entry given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."
  3. Changed1 schema field changed
    • changedOutput schema / properties / generations / items / properties / promptJSON / description
      Previous value: -"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (the style or character, the list and the references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, sizing, format, quality) are the current delivery, which edit_set rewrites, so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its background is the color the set was generated on, or transparent (an edit that composes a transparent set over a color leaves it transparent here; levers holds the color). Its shape follows the tool named in its own tool field. Image sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background (a color, or transparent), and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places; illustration sets carry style, styleReferences, scenes, width, height, format and quality. Read each entry's description (subjects[], variations[] or scenes[]) to reproduce a set: an entry given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."New value: +"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (the style or character, the list and the references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, sizing, format, quality) are the current delivery, which edit_set rewrites, so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its background is the color the set was generated on, or transparent (a set generated transparent stays transparent here after an edit changes its background to a color; levers holds the color). Its shape follows the tool named in its own tool field. Image sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background (a color, or transparent), and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places; illustration sets carry style, styleReferences, scenes, width, height, format and quality. Read each entry's description (subjects[], variations[] or scenes[]) to reproduce a set: an entry given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."
  4. Changed1 schema field changed
    • changedOutput schema / properties / generations / items / properties / parents / description
      Previous value: -"Ids of the generations whose delivered images seeded this one's references - the set lineage. Absent when this generation extended nothing."New value: +"Ids of the generations this one came from: for a batch made with an extend tool, its set's first batch; otherwise the generations its sourced references were copied from (create_reference's sourceGeneration). Only a parent made by the same tool on the same kind of background, a color or transparent, is in this one's set; any other only supplied reference images. Absent when neither applies."
  5. Changed12 schema fields changed
    • addedOutput schema / properties / generations / items / properties / crispBaseSize
      Added value: +{
      +  "description": "The largest base size, in pixels, at which export_set keeps every density of this batch crisp (no image enlarged past its source pixels) at its current levers; absent when no base size does. An image or character set's is set by its subject or variation count at generation, and edits to size, canvas, margin or sizing can move it; an illustration set's is a quarter of the longest side its scenes were drawn at, the largest it exports at.",
      +  "type": "integer"
      +}
    • changedOutput schema / properties / generations / items / properties / editable / description
      Previous value: -"True when it can be re-delivered: a set with edit_image_set, an illustration with edit_illustration (each has a source to cut from)."New value: +"True when edit_set can re-deliver it (it has a source to cut from)."
    • changedOutput schema / properties / generations / items / properties / edited / description
      Previous value: -"True when an edit (edit_image_set for a set, edit_illustration for an illustration) has changed its delivery from what was generated; a reset makes it false again."New value: +"True when edit_set has changed its delivery from what was generated; a reset makes it false again."
    • removedOutput schema / properties / generations / items / properties / iconCeiling
      Removed value: -{
      -  "description": "The largest base size, in pixels, at which export_icons keeps every density of this set crisp (no subject enlarged past its source pixels) at its current levers; absent when no base size does. Set by the subject count at generation; edits to size, canvas, margin or sizing can move it.",
      -  "type": "integer"
      -}
    • changedOutput schema / properties / generations / items / properties / id / description
      Previous value: -"The generation's id: the random segment of its download URLs, accepted by get_generations, delete_generations, edit_image_set, edit_illustration, export_icons and create_reference's sourceGeneration."New value: +"The generation's id: the random segment of its download URLs, accepted by get_generations, delete_generations, edit_set, export_set, extend_image_set, extend_character_set, extend_illustration_set and create_reference's sourceGeneration."
    • removedOutput schema / properties / generations / items / properties / illustrationLevers
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "The delivery settings now in force for an illustration (width, height, format, quality): the first delivery's until edit_illustration changes them.",
      -  "properties": {
      -    "format": {
      -      "type": "string"
      -    },
      -    "height": {
      -      "type": "integer"
      -    },
      -    "quality": {
      -      "type": "integer"
      -    },
      -    "width": {
      -      "type": "integer"
      -    }
      -  },
      -  "required": [
      -    "width",
      -    "height",
      -    "format"
      -  ],
      -  "type": [
      -    "null",
      -    "object"
      -  ]
      -}
    • changedOutput schema / properties / generations / items / properties / levers / description
      Previous value: -"The delivery levers now in force for a set (width, height, canvas, minimumMargin, sizing, format, quality, background): the first delivery's until edit_image_set changes them. Absent on illustrations and on sets from before editing existed."New value: +"The delivery levers now in force (width, height, canvas, minimumMargin, sizing, format, quality, background; an illustration set has width, height, format and quality): the first delivery's until edit_set changes them. Absent on sets from before editing existed."
    • changedOutput schema / properties / generations / items / properties / levers / properties / minimumMargin / type
      Previous value: -"integer"New value: +[
      +  "null",
      +  "integer"
      +]
    • changedOutput schema / properties / generations / items / properties / levers / required
      Previous value: -[
      -  "minimumMargin",
      -  "format"
      -]New value: +[
      +  "format"
      +]
    • changedOutput schema / properties / generations / items / properties / nativeWidth / description
      Previous value: -"The canvas this set would be delivered on at native size (its trimmed frame plus margin): the size any re-delivery compares against. For an illustration, the size the model made it at, the largest it can be delivered at."New value: +"The canvas this set would be delivered on at native size, with no width or height fixed: the size any re-delivery compares against. For an illustration set, the size the model draws its scenes at, the largest they can be delivered at."
    • changedOutput schema / properties / generations / items / properties / promptJSON / description
      Previous value: -"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (a set's style, subjects and references; an illustration's prompt and references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, format, quality, background) are the current delivery, which an edit rewrites (edit_image_set for a set, edit_illustration for an illustration's width, height, format and quality), so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its shape follows the tool named in its own tool field. Sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background for solid-background sets, and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places. Illustrations carry prompt, references as zip-relative paths when the call used them, width, height, format, quality and filename. Read subjects[].description to reproduce a set: a subject given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."New value: +"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (the style or character, the list and the references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, sizing, format, quality) are the current delivery, which edit_set rewrites, so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its background is the color the set was generated on, or transparent (an edit that composes a transparent set over a color leaves it transparent here; levers holds the color). Its shape follows the tool named in its own tool field. Image sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background (a color, or transparent), and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places; illustration sets carry style, styleReferences, scenes, width, height, format and quality. Read each entry's description (subjects[], variations[] or scenes[]) to reproduce a set: an entry given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."
    • changedOutput schema / properties / generations / items / properties / references / description
      Previous value: -"Where each reference image this generation was made with came from, in call order: the generation and delivered image it was copied from (what create_reference takes as sourceGeneration and sourceImage), or uploaded for a hand-uploaded file. The same images are inside promptJSON as zip-relative paths, under styleReferences, characterReferences or references, by tool. Absent when none were used."New value: +"Where each reference image this generation was made with came from, in call order: the generation and delivered image it was copied from (what create_reference takes as sourceGeneration and sourceImage), or uploaded for a hand-uploaded file. The same images are inside promptJSON as zip-relative paths, under styleReferences or characterReferences, by tool. Absent when none were used."
  6. Changed3 schema fields changed
    • changedOutput schema / properties / generations / items / properties / parents / description
      Previous value: -"Ids of the generations whose delivered images seeded this one's style references - the set lineage. Absent when this generation extended nothing."New value: +"Ids of the generations whose delivered images seeded this one's references - the set lineage. Absent when this generation extended nothing."
    • addedOutput schema / properties / generations / items / properties / references
      Added value: +{
      +  "description": "Where each reference image this generation was made with came from, in call order: the generation and delivered image it was copied from (what create_reference takes as sourceGeneration and sourceImage), or uploaded for a hand-uploaded file. The same images are inside promptJSON as zip-relative paths, under styleReferences, characterReferences or references, by tool. Absent when none were used.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "from": {
      +        "description": "The generation id this reference image came from; accepted by create_reference's sourceGeneration.",
      +        "type": "string"
      +      },
      +      "image": {
      +        "description": "The delivered image filename inside that generation; accepted by create_reference's sourceImage.",
      +        "type": "string"
      +      },
      +      "uploaded": {
      +        "description": "True for a hand-uploaded reference that came from no generation.",
      +        "type": "boolean"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": [
      +    "null",
      +    "array"
      +  ]
      +}
    • removedOutput schema / properties / generations / items / properties / styleReferences
      Removed value: -{
      -  "description": "The style references this generation was made with, in call order, each identified by the delivered image it came from when known, and reusable via create_reference. Distinct from promptJSON.styleReferences, which records the same references as zip-relative paths inside the original call. Absent when no references were used.",
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "from": {
      -        "description": "The generation id this reference image came from; accepted by create_reference's sourceGeneration.",
      -        "type": "string"
      -      },
      -      "image": {
      -        "description": "The delivered image filename inside that generation; accepted by create_reference's sourceImage.",
      -        "type": "string"
      -      },
      -      "uploaded": {
      -        "description": "True for a hand-uploaded reference that came from no generation.",
      -        "type": "boolean"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "type": [
      -    "null",
      -    "array"
      -  ]
      -}
  7. Changed7 schema fields changed
    • changedOutput schema / properties / generations / items / properties / deliveredAt / description
      Previous value: -"When the current delivery was cut: the generation time, or the time of the last edit_image_set."New value: +"When the current delivery was cut: the generation time, or the time of the last edit."
    • changedOutput schema / properties / generations / items / properties / editable / description
      Previous value: -"True when this set can be re-delivered with edit_image_set (it has a source to cut from)."New value: +"True when it can be re-delivered: a set with edit_image_set, an illustration with edit_illustration (each has a source to cut from)."
    • changedOutput schema / properties / generations / items / properties / edited / description
      Previous value: -"True when edit_image_set has changed this set's delivery from what was generated; a reset makes it false again."New value: +"True when an edit (edit_image_set for a set, edit_illustration for an illustration) has changed its delivery from what was generated; a reset makes it false again."
    • changedOutput schema / properties / generations / items / properties / id / description
      Previous value: -"The generation's id: the random segment of its download URLs, accepted by get_generations, delete_generations, edit_image_set, export_icons and create_reference's sourceGeneration."New value: +"The generation's id: the random segment of its download URLs, accepted by get_generations, delete_generations, edit_image_set, edit_illustration, export_icons and create_reference's sourceGeneration."
    • addedOutput schema / properties / generations / items / properties / illustrationLevers
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "The delivery settings now in force for an illustration (width, height, format, quality): the first delivery's until edit_illustration changes them.",
      +  "properties": {
      +    "format": {
      +      "type": "string"
      +    },
      +    "height": {
      +      "type": "integer"
      +    },
      +    "quality": {
      +      "type": "integer"
      +    },
      +    "width": {
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "width",
      +    "height",
      +    "format"
      +  ],
      +  "type": [
      +    "null",
      +    "object"
      +  ]
      +}
    • changedOutput schema / properties / generations / items / properties / nativeWidth / description
      Previous value: -"The canvas this set would be delivered on at native size (its trimmed frame plus margin): the size any re-delivery compares against."New value: +"The canvas this set would be delivered on at native size (its trimmed frame plus margin): the size any re-delivery compares against. For an illustration, the size the model made it at, the largest it can be delivered at."
    • changedOutput schema / properties / generations / items / properties / promptJSON / description
      Previous value: -"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. Its style, subjects and styleReferences are the original call and no edit can change them; its delivery levers (width, height, canvas, minimumMargin, format, quality, background) are the batch's current delivery, which edit_image_set rewrites, so reusing this reproduces the set as it stands now rather than as first delivered. The edited flag says whether that has happened. Its shape follows the tool named in its own tool field. Sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background for solid-background sets, and styleReferences as zip-relative paths when the call used them. Illustrations carry prompt, width, height, format, quality and filename. Read subjects[].description to reproduce a set: a subject given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."New value: +"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (a set's style, subjects and references; an illustration's prompt and references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, format, quality, background) are the current delivery, which an edit rewrites (edit_image_set for a set, edit_illustration for an illustration's width, height, format and quality), so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its shape follows the tool named in its own tool field. Sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background for solid-background sets, and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places. Illustrations carry prompt, references as zip-relative paths when the call used them, width, height, format, quality and filename. Read subjects[].description to reproduce a set: a subject given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."
  8. Changed1 schema field changed
    • changedOutput schema / properties / generations / items / properties / iconCeiling / description
      Previous value: -"The largest base size, in pixels, at which export_icons keeps every density of this set crisp (no subject enlarged past its source pixels) at its current levers; absent when no base size does. Fixed by the subject count at generation; edits to margin or sizing move it."New value: +"The largest base size, in pixels, at which export_icons keeps every density of this set crisp (no subject enlarged past its source pixels) at its current levers; absent when no base size does. Set by the subject count at generation; edits to size, canvas, margin or sizing can move it."
  9. Added

TDQS

A4.6/5.0
Behavior5/5

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

Beyond the annotations (readOnly, idempotent, non-destructive), the description discloses the distinctive behavior: partial results are returned when some ids are missing, the call fails only when none is found, and it costs no credits. These are exactly the traits an agent needs to batch ids safely without fear of an all-or-nothing failure.

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?

The lead clause establishes what is returned before the enumerations, and the operational facts (id source, batch limit, partial-failure rule, cost) are packed into short trailing sentences. The middle enumeration of record fields is dense and partly overlaps the output schema, but each clause still carries information.

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 a single-parameter batch read with a published output schema, the description covers id provenance, a hard batch limit, error semantics, and cost. Nothing an agent needs to call it correctly is absent, and the return-value enumeration is redundant with the output schema but harmless.

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, and the description adds meaning on top: the id is the random segment of the download URL rather than the whole URL, and up to 50 may be passed. That preempts a likely off-by-format error an agent would otherwise make from the schema alone.

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?

"Get the full record of generations of yours by id" gives a specific verb, resource, and access scope, then enumerates the payload (download URL/expiry, promptJSON, delivery settings, reference provenance, parents). It implicitly separates itself from list_recent_generations by naming it as the source of ids, so an agent can pick between the two without opening a schema.

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

Usage Guidelines4/5

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

It tells the agent exactly where the ids come from (list_recent_generations or a download URL) and states the per-call cap of 50, which is real routing/usage guidance. It does not state when to prefer an alternative or what to do if more than 50 ids are needed, so it falls short of explicit when/when-not coverage.

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