Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Logging level (e.g., DEBUG, INFO, WARNING, ERROR) | INFO |
| ACEDATA_API_BASE_URL | No | API base URL | https://api.acedata.cloud |
| ACEDATACLOUD_API_TOKEN | Yes | API token from AceDataCloud | |
| MIDJOURNEY_DEFAULT_MODE | No | Default generation mode (e.g., fast, turbo, relax) | fast |
| MIDJOURNEY_REQUEST_TIMEOUT | No | Request timeout in seconds | 180 |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| midjourney_describe | Get AI-generated descriptions of an image. 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. |
| midjourney_edit | Edit an existing image using Midjourney. 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. |
| midjourney_imagine | Generate AI images from a text prompt using Midjourney. 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. |
| midjourney_transform | Transform an existing Midjourney image with various operations. 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_blend | Blend multiple images together using 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. |
| midjourney_with_reference | Generate images using a reference image as inspiration. 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. |
| midjourney_list_actions | List all available Midjourney API actions and corresponding tools. 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. |
| midjourney_get_prompt_guide | Get guidance on writing effective prompts for Midjourney. 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. |
| midjourney_list_transform_actions | List all available transformation actions for Midjourney images. Reference guide for transform actions used with midjourney_transform tool.
Returns:
Detailed list of all transformation actions and when to use them. |
| midjourney_get_task | Query the status and result of a Midjourney generation task. 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. |
| midjourney_get_tasks_batch | Query multiple Midjourney generation tasks at once. 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. |
| midjourney_translate | Translate Chinese text to English for use as Midjourney prompts. 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. |
| midjourney_generate_video | Generate a video from text prompt and reference image using Midjourney. 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. |
| midjourney_extend_video | Extend an existing Midjourney video to make it longer. 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| midjourney_image_generation_guide | Guide for choosing the right Midjourney tool for image generation. |
| midjourney_workflow_examples | Common workflow examples for Midjourney image generation. |
| midjourney_style_suggestions | Style and prompt writing suggestions for Midjourney. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |