# mcp-midjourney

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add acedatacloud-mcp/mcp-midjourney

# Browse available tools
npx -y @smithery/cli@latest tool list acedatacloud-mcp/mcp-midjourney

# Get full schema for a tool
npx -y @smithery/cli@latest tool get acedatacloud-mcp/mcp-midjourney midjourney_describe

# Call a tool
npx -y @smithery/cli@latest tool call acedatacloud-mcp/mcp-midjourney midjourney_describe '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-midjourney--acedatacloud-mcp.run.tools`

**Required config:**
- `x-api-key` (header) — AceDataCloud API Bearer Token (get from https://platform.acedata.cloud)

## Tools (15)

- `midjourney_describe` — Get AI-generated descriptions of an image.
- `midjourney_edit` — Edit an existing image using Midjourney.
- `midjourney_imagine` — Generate AI images from a text prompt using Midjourney.
- `midjourney_transform` — Transform an existing Midjourney image with various operations.
- `midjourney_blend` — Blend multiple images together using Midjourney.
- `midjourney_with_reference` — Generate images using a reference image as inspiration.
- `midjourney_list_actions` — List all available Midjourney API actions and corresponding tools.
- `midjourney_get_prompt_guide` — Get guidance on writing effective prompts for Midjourney.
- `midjourney_list_transform_actions` — List all available transformation actions for Midjourney images.
- `midjourney_get_seed` — Get the seed value of a previously generated Midjourney image.
- `midjourney_get_task` — Query the status and result of a Midjourney generation task.
- `midjourney_get_tasks_batch` — Query multiple Midjourney generation tasks at once.
- `midjourney_translate` — Translate Chinese text to English for use as Midjourney prompts.
- `midjourney_generate_video` — Generate a video from text prompt and reference image using Midjourney.
- `midjourney_extend_video` — Extend an existing Midjourney video to make it longer.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get acedatacloud-mcp/mcp-midjourney <tool-name>
```

## Prompts (3)

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