# AetherWave-Studio/aetherwave-mcp [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/AetherWave-Studio/aetherwave-mcp  
**GitHub Stars:** 6  
**npm Downloads (last month):** 1118  
**Views:** 6  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/aetherwave-studio-aetherwave-mcp

## Description
One tool surface for music, image, video, and audio generation across Suno, Grok Imagine, Seedance, Kling, Hailuo, Wan, VEO, Ideogram, and GPT Image 2. Generate, edit, upscale, reframe, and master through one API key and one credit pool. First key includes free credits, no card required. npx -y @aetherwave-studio/mcp

## Tools
Capabilities this server exposes over MCP:

- **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` (5 cr, 6 outputs)
- **aetherwave_generate_video** — T2V or I2V across 7+ model families. Default `grok-imagine-t2v` with KIE+fal fallback
- **aetherwave_generate_music** — Suno V5.5 by default. Two tracks per submission, lyrics + instrumental
- **aetherwave_edit_image** — I2I editing. Default `grok-imagine-i2i` (3 cr/image effective, 2 variations)
- **aetherwave_upscale_image** — Topaz upscale 1x / 2x / 4x / 8x
- **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 Video Upscaler, 1080p or 2K
- **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
- **aetherwave_master_audio** — AI mastering across 12 genre/style presets. 20 cr/track, free on Producer / Mogul / Ultimate plans
- **aetherwave_list_my_creations** — Paginated gallery read for chained workflows

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "aetherwave-mcp": {
    "command": "npx",
    "args": ["-y","@aetherwave-studio/mcp"],
    "env": {
      "AETHERWAVE_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `AETHERWAVE_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What AetherWave-Studio/aetherwave-mcp MCP server does

AetherWave-Studio/aetherwave-mcp MCP server connects MCP-compatible clients to AetherWave Studio’s unified creative API. It provides tools for generating music, images, and video, along with utilities for editing, upscaling, reframing, background removal, and audio mastering. The service groups these operations behind one API token and one credit balance rather than exposing separate credentials for each listed model provider.

Image generation supports text-to-image and image-to-image workflows across models including Grok Imagine, GPT Image 2, Seedream, Wan, Imagen, Nano Banana, Ideogram, and Z-Image Turbo. Video generation supports text-to-video and image-to-video across model families such as Grok Imagine, Wan, Hailuo, Seedance, Kling, VEO, and Happy Horse. Music generation uses Suno models and can produce vocal or instrumental tracks.

## How it works

A client invokes an MCP tool with the requested prompt, source URL, model, and optional output settings. For generation operations, AetherWave submits the job, waits for a terminal result, and returns the resulting media URL instead of requiring the agent to implement its own polling loop. Video jobs can be polled for up to eight minutes according to the tool reference.

Generated results are automatically saved to the AetherWave Cloudflare R2 gallery. The `aetherwave_list_my_creations` tool provides a paginated read of that gallery, which supports workflows that pass earlier outputs into later operations. Video generation can use a KIE and fal fallback for the default Grok Imagine path, while background removal also has a documented fallback provider.

## Setup and configuration

The package runs as a local stdio MCP server. Install or launch it with:

```bash
npx -y @aetherwave-studio/mcp
```

Set `AETHERWAVE_API_KEY` to a developer key obtained from the AetherWave Studio profile’s Developer tab. The same environment variable can be placed in an MCP client configuration. The README gives configurations for Claude Code, Claude Desktop, Cursor, Continue, and custom JSON-RPC clients that communicate over stdio.

The first key includes free credits and does not require a card, but operations consume credits according to the selected model and operation. The balance and current plan are available through `aetherwave_balance`.

## Tools and capabilities

The tool surface includes:

- Listing image models, video models, and audio-mastering presets with pricing or model metadata.
- Generating images with aspect ratio, resolution, reference image, output-count, seed, and optional negative-prompt controls.
- Editing an image from a public source URL using a text instruction.
- Upscaling images by 1x, 2x, 4x, or 8x, and upscaling video to 1080p or 2K.
- Reframing images or video to a new aspect ratio.
- Removing image backgrounds with automatic fallback behavior, or removing video backgrounds frame by frame into transparent WebM or a solid-color output.
- Generating two Suno tracks per music submission, with optional custom lyrics, titles, and instrumental mode.
- Mastering audio with twelve genre or style presets; the documented cost is 20 credits per track, with mastering free on Producer, Mogul, and Ultimate plans.

## Limitations and notes

Model availability, supported resolutions, durations, aspect ratios, and credit costs vary by model. Some image-to-image and image-to-video operations require a public source image URL. Video duration ranges from two to thirty seconds at the tool level, while individual models may support narrower ranges. The default image, video, music, and image-edit models are selected automatically, but agents can request specific model IDs.

AetherWave-Studio/aetherwave-mcp MCP server requires an AetherWave API key and an available credit balance for paid operations. The supplied material does not specify the repository license or a complete account-pricing table.

_Full upstream README: https://allmcps.com/mcp/aetherwave-studio-aetherwave-mcp/readme_