AetherWave-Studio/aetherwave-mcp

Model Context Protocol server for AetherWave Studio. Drop it into any MCP-compatible client (Claude Code, Cursor, Continue, Claude Desktop, custom agents) and your LLM can generate, edit, upscale, reframe, and master across every flagship creative AI provider through one API key, one credit pool.
One install. One token. Thirty-three default tools covering:
- **Music** - Suno V3.5 / V4 / V4.5 / V5 / V5.5
- **Image gen** - Grok Imagine, GPT Image 2, Seedream V4, Wan 2.7, Nano Banana 2, Flux 2, Qwen Image, Z-Image Turbo
- **Image edit** - Grok Imagine I2I, Seedream V4 Edit, Flux Kontext, Wan 2.5 Spicy, Qwen Edit, GPT Image 1.5
- **Image utility** - 2x / 4x upscale, Recraft background removal (with fal BiRefNet v2 fallback), Ideogram V3 Reframe
- **Video** - Grok Imagine (KIE+fal fallback), Wan 2.7, Hailuo 02, Seedance Pro/Lite, Kling 2.6 (audio), VEO 3.1, Happy Horse
- **Video utility** - Atlas upscaler (1080p/2K), rembg u2netp background removal, Luma Ray 2 Flash reframe
- **Audio mastering** - 12 genre/style presets via the AetherWave Python service
- **Gallery** - upload your own images, audio and video (local file, URL or data URL), and a paginated list of your saved creations
- **User manuals** - the MCP, Graphic Novel Studio, UGC Studio and Project Studio manuals as PDF links (saved to Downloads on the npx server)
- **Comic books** - 9 tools driving the AetherWave Graphic Novel Engine end to end: cast, character references, script, panels, lettered pages, and a PDF / EPUB / CBZ download link
- **Merch** - 4 tools: garment catalog, design-to-mockup, and (with PRINTFUL_API_TOKEN) 2 more that create and list products in your own Printful store, plus 1 admin shop-listing tool
Every generation tool submits the job and waits up to a soft 45 s deadline for the result. Fast jobs come back with the final URL in one round-trip; anything longer returns state: "running" with a taskId, and aetherwave_get_job covers every pipeline (image, video, music, mastering, comics, merch) for polling. Pass async: true on any tool to return immediately. Results auto-save to your Cloudflare R2 gallery so URLs don't expire.
The comic tools are built around this from the start: a book takes about an hour to draw, so each slow step starts and returns at once, and aetherwave_comic_status is how the agent checks back. See Make a comic book with the MCP.
Quick start
Claude Code
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Restart Claude Desktop.
Cursor
In Cursor Settings -> MCP -> Add new server:
Continue (VS Code / JetBrains)
In your ~/.continue/config.yaml:
Custom / programmatic clients
Standard stdio MCP server. Any client that speaks JSON-RPC 2.0 over stdio per the MCP spec can connect:
Tools at a glance
| Tool | Purpose |
|------|---------|
| aetherwave_list_characters | Your saved UGC characters with identity block, reference pack, voice and personality |
| aetherwave_get_job | Poll any job a tool handed back as state: "running" (or submitted with async: true), or recover one whose call timed out. Covers image, video, video-edit, music, merch-mockup and comic-export |
| aetherwave_balance | Current credit balance + plan |
| aetherwave_list_image_models | Enumerate every image model with cost, speed, I2I support |
| aetherwave_list_video_models | Enumerate every video model with cost-per-second, durations, resolutions |
| aetherwave_list_master_presets | Enumerate the 12 mastering presets with target LUFS, tags, descriptions |
| aetherwave_generate_image | T2I or I2I across 8+ models. Default grok-imagine-t2i (6 cr, 2 outputs) |
| aetherwave_generate_video | T2V or I2V across 7+ model families. Native audio, reference-image identity lock, async submit |
| aetherwave_generate_music | Suno V5.5 by default. Two tracks per submission, lyrics + instrumental |
| aetherwave_edit_image | I2I editing. Default grok-imagine-i2i (10 cr, one image) |
| aetherwave_upscale_image | 2x or 4x upscale, 4 cr |
| aetherwave_reframe_image | Ideogram V3 Reframe to a new aspect ratio (outpaints edges) |
| aetherwave_remove_background | Recraft primary + fal BiRefNet v2 fallback (auto failover). Output auto-saved to gallery |
| aetherwave_upscale_video | Atlas (1080p, 2K) or BytePlus (1080p to 8K) video upscale |
| aetherwave_remove_background_video | Frame-by-frame bg removal via rembg u2netp. Transparent WebM or solid color output. 2 cr/sec |
| aetherwave_reframe_video | Luma Ray 2 Flash reframe to new aspect ratio |