Skip to main content
Glama

generate_image

Generate a YouTube thumbnail, channel banner, logo, product mockup or general image. Counts against the monthly image allowance (Pro 200, Premium 500, Ultimate 1,000 a month; extra images can be bought as image packs) and saves to the user's library. Make one image per request the user actually wants; never loop to produce dozens of variations unless they asked for that many. At most 100 images an hour go through this connector. Set image_type: it controls the shape of the result, and getting it wrong produces something the user cannot actually use. To feature one of the user's saved characters OR one of their made AI presenters in the image (a logo, banner or thumbnail with the presenter's face), pass character with their name and the face will match. PROFILE PICTURES: when the user wants a profile picture / channel icon / avatar circle of their presenter or character, use image_type profile_picture with character. That uses their ACTUAL image, cropped front-facing into a circle on white, with no regenerating, so it is never cartoon or animated. Never use logo for a picture of a person: logo is a flat graphic mark and turns faces into illustrations. To CREATE a reusable character rather than use one, use create_character instead. To make an AI PRESENTER or AVATAR (a talking on-screen host for videos), do NOT use this: use draw_presenter, which creates them in the right pose and leads to make_presenter.

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": {
      "prompt": "<prompt>"
    },
    "name": "generate_image"
  }
}

Input Schema

NameRequiredDescriptionDefault
styleNoThe art style. 3d_animated is the same look as the 3D Animated films (Pixar-style 3D): use it for every thumbnail, banner, logo and profile picture of a 3D animated, kids' 3D or Bible 3D animation channel or film, never 2d_cartoon. 2d_cartoon is a flat 2D cartoon. realistic is photo-real. Leave it out to let the prompt decide.
promptYesWhat the image shows. Visual and specific. Include on-image text exactly as it should appear. Describe content only: the shape, aspect ratio and framing are handled automatically from image_type, so do not ask for dimensions here.
characterNoName of a saved character, a 3D cast character (list_3d_characters) or a ready AI presenter (list_presenters) to feature in the image, so the person in it is recognisably them; a first name is enough ("Cedric" for a presenter saved as Cedric). Use this to put a presenter on an ebook cover or product mockup. Optional. Must already exist: use list_characters, list_3d_characters or list_presenters to check. A 3D cast character is always made in the 3D animated look.
image_typeNoprofile_picture is a channel profile picture: with character it crops that presenter's or character's REAL image into a circle on white (no AI regeneration, the face is exactly theirs); without character it creates a square head-and-shoulders portrait, photographic unless the user asks for a style. youtube_thumbnail is 16:9 widescreen. youtube_banner is real 2560x1440 YouTube channel art with the whole design kept inside the area visible on every device (TV, desktop, phone). logo is a square graphic mark (text or symbol, flat shapes), not a picture of a person. mockup puts the product on a pure white background for a shop listing. general applies no shape rule. Defaults to general.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / character / description
      Previous value: -"Name of a saved character, a 3D cast character (list_3d_characters) or a ready AI presenter to feature in the image, so the person in it is recognisably them. Optional. Must already exist: use list_characters, list_3d_characters or list_presenters to check. A 3D cast character is always made in the 3D animated look."New value: +"Name of a saved character, a 3D cast character (list_3d_characters) or a ready AI presenter (list_presenters) to feature in the image, so the person in it is recognisably them; a first name is enough (\"Cedric\" for a presenter saved as Cedric). Use this to put a presenter on an ebook cover or product mockup. Optional. Must already exist: use list_characters, list_3d_characters or list_presenters to check. A 3D cast character is always made in the 3D animated look."
  2. Changed2 schema fields changed
    • changedInput schema / properties / character / description
      Previous value: -"Name of a saved character, a 3D cast character (list_3d_characters) or a ready AI presenter to feature in the image, so the person in it is recognisably them. Optional. Must already exist: use list_characters, list_3d_characters or list_presenters to check. A 3D cast character is always drawn in the 3D animated look."New value: +"Name of a saved character, a 3D cast character (list_3d_characters) or a ready AI presenter to feature in the image, so the person in it is recognisably them. Optional. Must already exist: use list_characters, list_3d_characters or list_presenters to check. A 3D cast character is always made in the 3D animated look."
    • changedInput schema / properties / image_type / description
      Previous value: -"profile_picture is a channel profile picture: with character it crops that presenter's or character's REAL image into a circle on white (no AI redraw, the face is exactly theirs); without character it draws a square head-and-shoulders portrait, photographic unless the user asks for a style. youtube_thumbnail is 16:9 widescreen. youtube_banner is real 2560x1440 YouTube channel art with the whole design kept inside the area visible on every device (TV, desktop, phone). logo is a square graphic mark (text or symbol, flat shapes), not a picture of a person. mockup puts the product on a pure white background for a shop listing. general applies no shape rule. Defaults to general."New value: +"profile_picture is a channel profile picture: with character it crops that presenter's or character's REAL image into a circle on white (no AI regeneration, the face is exactly theirs); without character it creates a square head-and-shoulders portrait, photographic unless the user asks for a style. youtube_thumbnail is 16:9 widescreen. youtube_banner is real 2560x1440 YouTube channel art with the whole design kept inside the area visible on every device (TV, desktop, phone). logo is a square graphic mark (text or symbol, flat shapes), not a picture of a person. mockup puts the product on a pure white background for a shop listing. general applies no shape rule. Defaults to general."
  3. Changed2 schema fields changed
    • changedInput schema / properties / character / description
      Previous value: -"Name of a saved character or a ready AI presenter to feature in the image, so the person in it is recognisably them. Optional. Must already exist: use list_characters or list_presenters to check."New value: +"Name of a saved character, a 3D cast character (list_3d_characters) or a ready AI presenter to feature in the image, so the person in it is recognisably them. Optional. Must already exist: use list_characters, list_3d_characters or list_presenters to check. A 3D cast character is always drawn in the 3D animated look."
    • addedInput schema / properties / style
      Added value: +{
      +  "description": "The art style. 3d_animated is the same look as the 3D Animated films (Pixar-style 3D): use it for every thumbnail, banner, logo and profile picture of a 3D animated, kids' 3D or Bible 3D animation channel or film, never 2d_cartoon. 2d_cartoon is a flat 2D cartoon. realistic is photo-real. Leave it out to let the prompt decide.",
      +  "enum": [
      +    "3d_animated",
      +    "2d_cartoon",
      +    "realistic"
      +  ],
      +  "type": "string"
      +}
  4. Changed2 schema fields changed
    • changedInput schema / properties / image_type / description
      Previous value: -"youtube_thumbnail is 16:9 widescreen. youtube_banner is real 2560x1440 YouTube channel art with the whole design kept inside the area visible on every device (TV, desktop, phone). logo is square and built to stay readable as a small avatar. mockup puts the product on a pure white background for a shop listing. general applies no shape rule. Defaults to general."New value: +"profile_picture is a channel profile picture: with character it crops that presenter's or character's REAL image into a circle on white (no AI redraw, the face is exactly theirs); without character it draws a square head-and-shoulders portrait, photographic unless the user asks for a style. youtube_thumbnail is 16:9 widescreen. youtube_banner is real 2560x1440 YouTube channel art with the whole design kept inside the area visible on every device (TV, desktop, phone). logo is a square graphic mark (text or symbol, flat shapes), not a picture of a person. mockup puts the product on a pure white background for a shop listing. general applies no shape rule. Defaults to general."
    • changedInput schema / properties / image_type / enum
      Previous value: -[
      -  "youtube_thumbnail",
      -  "youtube_banner",
      -  "logo",
      -  "mockup",
      -  "general"
      -]New value: +[
      +  "youtube_thumbnail",
      +  "youtube_banner",
      +  "profile_picture",
      +  "logo",
      +  "mockup",
      +  "general"
      +]
  5. First observed

TDQS

A4.8/5.0
Behavior5/5

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

With no annotations supplied, the description carries the full burden and does so: it discloses monthly allowances by tier, that extra images can be purchased, that results save to the user's library, a 100-images-per-hour cap, and the important behavioral fact that profile_picture with a character crops the REAL image without regeneration while logo renders faces as illustrations.

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?

Dense but front-loaded: purpose first, then quotas/limits, then the critical image_type caveat, then sibling routing. The all-caps PROFILE PICTURES block and some repetition of the schema's image_type text cost a point, but nearly every sentence provides actionable guidance.

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 four-parameter tool with no output schema, the description covers quota cost, rate limits, storage destination, style/character routing, and all sibling boundaries. Nothing an agent needs in order to call it correctly appears to be missing.

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 a 3 is the baseline, but the description adds meaning beyond the schema: it emphasizes that image_type controls the shape of the result and that getting it wrong yields unusable output, and it explains the character-name matching convention (a first name is enough). It largely restates image_type and character semantics already documented in the schema, hence not a 5.

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?

Opening sentence gives a concrete verb plus the full list of resource types (thumbnail, banner, logo, mockup, general image), and the description explicitly distinguishes itself from create_character and draw_presenter. An agent can identify this as the general image generator without opening the 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?

Explicit routing rules: use create_character to create rather than use a character, use draw_presenter for AI presenters/avatars, use image_type profile_picture with character for profile pictures, and never use logo for a picture of a person. It also sets a volume policy (one image per request, no looping to produce dozens of variations).

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