Skip to main content
Glama

Create Promo Image

create_promo_image
Destructive

[write, queued, priced] A promotion picture of a product: the picture at image_source_url (a public https address of the product) is the reference and image_prompt (up to 1500 characters) says what the advertisement shows; no characters are needed. image_ai {provider, account_uuid | account_id, model?} is the AI account that draws it (required, the provider has to take a reference picture); storages_account_id and image_output_path (folder, default the root) are where the finished picture is stored. image_aspect = 1:1 (default) | 9:16 | 3:4 | 16:9. Optional images_album_uuid puts it in an album (create_images_album). Poll with get_character_image. Answers image_id and image_uuid.

Input Schema

NameRequiredDescriptionDefault
image_aiYes
image_titleYes
image_aspectNo1:1
image_promptYes
image_source_urlYes
image_output_pathNo
images_album_uuidNo
storages_account_idYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.2/5.0
Behavior4/5

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

The '[write, queued, priced]' tags add real information beyond the annotations — async job submission and per-call cost — and the polling instruction plus the returned `image_id`/`image_uuid` round it out. It stops short of quantifying cost or explaining failure behavior for rejected reference URLs.

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?

Front-loaded with the write/queued/priced tags and the core reference-plus-prompt mechanic, then parameters, then the polling instruction. The semicolon-chained style is dense but every clause carries information; no filler sentences.

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

Completeness4/5

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

For an 8-parameter, async, nested-object tool with no output schema, the description covers the workflow end to end including how to fetch the result. The gaps are minor: `image_title` is unmentioned and the shape of the nested `image_ai` object isn't validated beyond the three sub-keys.

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

Parameters5/5

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

With 0% schema coverage the description carries the full burden and mostly delivers: it documents the nested `image_ai` shape ({provider, account_uuid | account_id, model?}), the https constraint on `image_source_url`, the 1500-character prompt cap, the output folder default, the album cross-reference, and the full aspect enum with its default. Only `image_title` is left undocumented.

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?

States a specific verb and resource plus a distinguishing scope: a promotional product picture drawn from a reference image at `image_source_url`. It implicitly separates itself from character-based siblings ('no characters are needed') but never names create_image, create_infographic_image, or create_character_image, so sibling disambiguation is left partly to inference.

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?

Gives concrete operating instructions: the AI provider must accept a reference picture, at most 1500 prompt characters, and results are retrieved by polling get_character_image; it also points to create_images_album for the album parameter. It does not state when to prefer this over plain create_image, so the alternative-selection guidance is incomplete.

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.