This analyzes an image and returns 4 alternative text descriptions that
could be used as prompts to recreate similar images with Midjourney.

Use this when:
- You want to understand what prompts might create a similar image
- You want to reverse-engineer an image's style or composition
- You need inspiration for prompts based on existing artwork
- You want to describe an image for documentation

The descriptions include style tags and aspect ratio parameters that
Midjourney understands.

Returns:
    Four alternative descriptions of the image with Midjourney-compatible formatting.

This allows you to modify an existing image based on a text prompt,
optionally using a mask to specify which regions to edit.

Use this when:
- You want to modify an existing image with AI
- You want to add or change elements in an image
- You want to apply style changes to an image
- You need to edit specific regions using a mask

For masks:
- White areas in the mask indicate regions to regenerate
- Black areas will be preserved from the original

Returns:
    Task ID and edited image information including URLs and dimensions.

This is the primary way to create images - describe what you want and Midjourney
will generate a 2x2 grid of 4 image variations.

Use this when:
- You want to create new images from a text description
- You have a creative vision to visualize
- You need AI-generated artwork or illustrations

For image transformations like upscaling or variations, use midjourney_transform instead.

Returns:
    Task ID and generated image information including URLs, dimensions, and available actions.

This allows you to upscale, create variations, zoom, or pan existing images
generated by Midjourney.

Use this when:
- You want to upscale one of the 4 images from a generation
- You want to create variations of a specific image
- You want to zoom out or pan an image
- You want to regenerate with the same prompt

Workflow example:
1. Generate with midjourney_imagine -> get image_id
2. Upscale favorite: midjourney_transform(image_id, "upscale2")
3. Further upscale: midjourney_transform(new_image_id, "upscale_4x")

Returns:
    Task ID and transformed image information.

This allows you to combine 2-5 images into a new creative fusion.

Use this when:
- You want to merge elements from multiple images
- You want to create composite images
- You want to blend styles or subjects together

Example:
- Blend a bear image with a chainsaw image with prompt "The bear is holding the chainsaw"

Returns:
    Task ID and blended image information.

This allows you to use an existing image as a starting point and modify it
based on your prompt description.

Use this when:
- You want to reimagine an existing image with modifications
- You want to change the style of an image
- You want to add or change elements while keeping the composition

Tips:
- Use --iw parameter (image weight) to control reference influence (0-2)
- Higher --iw values make the output more similar to the reference

Returns:
    Task ID and generated image information.

Reference guide for what each action does and which tool to use.
Helpful for understanding the full capabilities of the Midjourney MCP.

Returns:
    Categorized list of all actions and their corresponding tools.

Shows how to structure prompts and use parameters for best results.
Following this guide helps Midjourney understand your creative vision.

Returns:
    Complete guide with prompt structure, parameters, and examples.

Reference guide for transform actions used with midjourney_transform tool.

Returns:
    Detailed list of all transformation actions and when to use them.

The seed is a numeric value that controls the randomness of generation.
Using the same seed with the same prompt will produce similar results,
which is useful for reproducible generation or fine-tuning prompts.

Use this when:
- You want to reproduce a specific generation result
- You need the seed to use with --seed parameter in prompts
- You want to create variations with consistent base randomness

Returns:
    The seed value for the specified image.

This tool helps optimize long or complex prompts by identifying the most
important elements and producing up to 5 shortened candidate prompts that
preserve the dominant ideas.

Use this when:
- You have a long prompt and want to identify the most impactful words
- You want to understand which parts of your prompt carry the most weight
- You need to simplify a complex prompt while keeping its essence

Returns:
    Up to 5 shortened candidate prompts derived from the original.

Use this to check if a generation is complete and retrieve the resulting
image/video URLs and metadata.

Use this when:
- You want to check if a generation has completed
- You need to retrieve URLs from a previous generation
- You want to get the full details of a generated image or video
- You used async callback and want to check results later

Returns:
    Task status and generation result including URLs, dimensions, and available actions.

Efficiently check the status of multiple tasks in a single request.
More efficient than calling midjourney_get_task multiple times.

Use this when:
- You have multiple pending generations to check
- You want to get status of several images/videos at once
- You're tracking a batch of generations
- You want to list recent tasks with pagination (omit task_ids and trace_ids)

Returns:
    Status and result information for all queried tasks.

Midjourney works best with English prompts. This tool helps translate
Chinese descriptions to English, optimized for image generation.

Use this when:
- You have a Chinese description that needs translation
- You want to convert Chinese prompts to English
- You need English prompts for better Midjourney results

Returns:
    Translated English text ready to use as a Midjourney prompt.

This creates an AI-generated video based on your description and a starting
frame image. Midjourney video generation is image-to-video only — a reference
image is always required. You can optionally specify an ending frame for more
control.

Use this when:
- You want to animate a still image
- You want to create short video clips from a reference image
- You need AI-generated video content

The generation process returns 4 video variations.

Returns:
    Task ID and video information including cover image and video URLs.

This allows you to continue a previously generated video by adding more
frames based on your prompt description.

Use this when:
- You want to make a video longer
- You want to continue the story or motion from an existing video
- You need to add more content to a short clip

Returns:
    Task ID and extended video information including new video URLs.