Schema | AWS Nova Canvas

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`AWS_REGION`	No	The AWS region where Amazon Bedrock and Nova Canvas are enabled (e.g., us-east-1).
`AWS_PROFILE`	No	The AWS profile used for authentication. If not provided, it defaults to 'default'.	default
`AWS_ACCESS_KEY_ID`	No	AWS Access Key ID for temporary credentials.
`AWS_SESSION_TOKEN`	No	AWS Session Token for temporary credentials.
`FASTMCP_LOG_LEVEL`	No	The log level for the FastMCP server (e.g., ERROR, DEBUG, INFO).	ERROR
`AWS_SECRET_ACCESS_KEY`	No	AWS Secret Access Key for temporary credentials.

Capabilities

Server capabilities have not been inspected yet.

Tools

Functions exposed to the LLM to take actions

Name Description

Name	Description
generate_image	Generate an image using Amazon Nova Canvas with text prompt. This tool uses Amazon Nova Canvas to generate images based on a text prompt. 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. You should always include "people, anatomy, hands, low quality, low resolution, low detail" in your negative_prompt ## Example Prompts - "realistic editorial photo of female teacher standing at a blackboard with a warm smile" - "whimsical and ethereal soft-shaded story illustration: A woman in a large hat stands at the ship's railing looking out across the ocean" - "drone view of a dark river winding through a stark Iceland landscape, cinematic quality" Returns: McpImageGenerationResponse: A response containing the generated image paths.
generate_image_with_colors	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.

generate_image

Generate an image using Amazon Nova Canvas with text prompt.

This tool uses Amazon Nova Canvas to generate images based on a text prompt.
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.

You should always include "people, anatomy, hands, low quality, low resolution, low detail" in your negative_prompt

## Example Prompts

- "realistic editorial photo of female teacher standing at a blackboard with a warm smile"
- "whimsical and ethereal soft-shaded story illustration: A woman in a large hat stands at the ship's railing looking out across the ocean"
- "drone view of a dark river winding through a stark Iceland landscape, cinematic quality"

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

generate_image_with_colors

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.

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
No resources

AWS Nova Canvas

Server Configuration

Capabilities

Tools

Prompts

Resources

Latest Blog Posts

MCP directory API