generate_image_with_colors

Create custom images using text prompts and color palettes with Amazon Nova Canvas. Save images to a specified workspace for use in mockups, UI designs, and visual concepts.

Instructions

Generate an image using Amazon Nova Canvas with color guidance.

This tool uses Amazon Nova Canvas to generate images based on a text prompt and color palette.
The generated image will be saved to a file and the path will be returned.

IMPORTANT FOR Assistant: Always send the current workspace directory when calling this tool!
The workspace_dir parameter should be set to the directory where the user is currently working
so that images are saved to a location accessible to the user.

## Prompt Best Practices

An effective prompt often includes short descriptions of:
1. The subject
2. The environment
3. (optional) The position or pose of the subject
4. (optional) Lighting description
5. (optional) Camera position/framing
6. (optional) The visual style or medium ("photo", "illustration", "painting", etc.)

Do not use negation words like "no", "not", "without" in your prompt. Instead, use the
negative_prompt parameter to specify what you don't want in the image.

## Example Colors

- ["#FF5733", "#33FF57", "#3357FF"] - A vibrant color scheme with red, green, and blue
- ["#000000", "#FFFFFF"] - A high contrast black and white scheme
- ["#FFD700", "#B87333"] - A gold and bronze color scheme

Returns:
    McpImageGenerationResponse: A response containing the generated image paths.

Input Schema

Name	Required	Description	Default
`cfg_scale`	No	How strongly the image adheres to the prompt (1.1-10.0)
`colors`	Yes	List of up to 10 hexadecimal color values (e.g., "#FF9800")
`filename`	No	The name of the file to save the image to (without extension)
`height`	No	The height of the generated image (320-4096, divisible by 16)
`negative_prompt`	No	Text to define what not to include in the image (1-1024 characters)
`number_of_images`	No	The number of images to generate (1-5)
`prompt`	Yes	The text description of the image to generate (1-1024 characters)
`quality`	No	The quality of the generated image ("standard" or "premium")	standard
`seed`	No	Seed for generation (0-858,993,459)
`width`	No	The width of the generated image (320-4096, divisible by 16)
`workspace_dir`	No	The current workspace directory where the image should be saved. CRITICAL: Assistant must always provide this parameter to save images to the user's current project.

Input Schema (JSON Schema)

{
  "properties": {
    "cfg_scale": {
      "default": 6.5,
      "description": "How strongly the image adheres to the prompt (1.1-10.0)",
      "title": "Cfg Scale",
      "type": "number"
    },
    "colors": {
      "description": "List of up to 10 hexadecimal color values (e.g., \"#FF9800\")",
      "items": {
        "type": "string"
      },
      "title": "Colors",
      "type": "array"
    },
    "filename": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The name of the file to save the image to (without extension)",
      "title": "Filename"
    },
    "height": {
      "default": 1024,
      "description": "The height of the generated image (320-4096, divisible by 16)",
      "title": "Height",
      "type": "integer"
    },
    "negative_prompt": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Text to define what not to include in the image (1-1024 characters)",
      "title": "Negative Prompt"
    },
    "number_of_images": {
      "default": 1,
      "description": "The number of images to generate (1-5)",
      "title": "Number Of Images",
      "type": "integer"
    },
    "prompt": {
      "description": "The text description of the image to generate (1-1024 characters)",
      "title": "Prompt",
      "type": "string"
    },
    "quality": {
      "default": "standard",
      "description": "The quality of the generated image (\"standard\" or \"premium\")",
      "title": "Quality",
      "type": "string"
    },
    "seed": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Seed for generation (0-858,993,459)",
      "title": "Seed"
    },
    "width": {
      "default": 1024,
      "description": "The width of the generated image (320-4096, divisible by 16)",
      "title": "Width",
      "type": "integer"
    },
    "workspace_dir": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The current workspace directory where the image should be saved. CRITICAL: Assistant must always provide this parameter to save images to the user's current project.",
      "title": "Workspace Dir"
    }
  },
  "required": [
    "prompt",
    "colors"
  ],
  "title": "mcp_generate_image_with_colorsArguments",
  "type": "object"
}

AWS Nova Canvas

generate_image_with_colors

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from AWS Nova Canvas

Related Tools

MCP directory API