list_visual_options

mcp:readread-only

List what create_branded_image, create_carousel and create_app_screenshot can make: image formats with their pixel sizes and where each is used, templates and the content fields each one reads, themes, carousel slide layouts, app screenshot layouts, and recommended OpenRouter image models for aiBackground (default first, each with what it's best at; pass includeAllModels: true for all of them). Also shows the brand colours, dark background, fonts and the logo's size if one is set, so you can tell the user what their visuals will look like.

Input

• includeAllModelsboolean | string

  Also list every OpenRouter image model aiBackground accepts (about 60). Off by default: recommendedModels covers most needs.

Permission

Needs the mcp:read scope: view your workspace. It only reads, so assistants can call it without asking.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call

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

Same action over the REST API

The tool runs GET /v1/orgs/{orgId}/marketing/visuals/options as the signed-in user, with the same validation, approval rules and limits. See it in the Visuals API reference.