mcp-midjourney

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 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 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.

This creates an AI-generated video based on your description and a starting
frame image. 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 descriptions
- 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.

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.

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.

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

Returns:
    Status and result information for all queried tasks.

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.

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.

Reference guide for transform actions used with midjourney_transform tool.

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

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.

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 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.