Skip to content
Agentmart
Submit a tool

Aetherwave MCP

Music, image, video and audio generation across top AI providers - one key, one credit pool.

Connector by AetherWave-Studio · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 6
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/aetherwave-studio-aetherwave-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Music, image, video and audio generation across top AI providers - one key, one credit pool.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
13 read · 19 write · 4 delete
Secrets
1 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Node.js package

Tools by what they do 36

Read from the source code; the running server may list different tools.

Read 13 · Look things up without changing anything.

  • aetherwave_balance
  • aetherwave_comic_estimate
  • aetherwave_comic_status
  • aetherwave_get_job
  • aetherwave_get_user_manual
  • aetherwave_list_characters
  • aetherwave_list_image_models
  • aetherwave_list_master_presets
  • aetherwave_list_my_creations
  • aetherwave_list_video_models
  • aetherwave_merch_garments
  • aetherwave_merch_mockup_status
Show 1 more tools
  • aetherwave_printful_list_products

Write 19 · Create, change, send or run things.

  • aetherwave_comic_assemble
  • aetherwave_comic_character_reference
  • aetherwave_comic_create
  • aetherwave_comic_draw
  • aetherwave_comic_export
  • aetherwave_edit_image
  • aetherwave_generate_image
  • aetherwave_generate_music
  • aetherwave_generate_video
  • aetherwave_master_audio
  • aetherwave_merch_mockup
  • aetherwave_merch_prepare_design
Show 7 more tools
  • aetherwave_printful_create_product
  • aetherwave_reframe_image
  • aetherwave_reframe_video
  • aetherwave_shop_create_listing
  • aetherwave_upload_to_gallery
  • aetherwave_upscale_image
  • aetherwave_upscale_video

Delete 4 · Delete, drop, revoke or wipe things.

  • aetherwave_comic_redraw_panel
  • aetherwave_comic_write_script
  • aetherwave_remove_background
  • aetherwave_remove_background_video

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • AETHERWAVE_API_KEY

Network hosts it talks to 13

  • aetherwavestudio.com · found in code
  • api.printful.com · found in code
  • audiostream.kie.ai · found in code
  • discord.com · found in code
  • github.com · found in code
  • glama.ai · found in code
  • mcp.aetherwavestudio.com · found in code
  • media.aetherwavestudio.com · found in code
  • musicfile.kie.ai · found in code
  • printful-upload.s3-accelerate.am · found in code
  • printful-upload.s3-accelerate.amazonaws.com · found in code
  • railway.app · found in code
  • tempfile.aiquickdraw.com · found in code

Files it touches

  • Your home directory (~)
  • Any path the agent passes to its tools

Tools (36)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • aetherwave_balanceCheck credit balanceread-only

    Returns the current AetherWave credit balance for the API key. Use this BEFORE a generation to confirm sufficient credits, especially for video which can cost 30-300+ credits depending on model/duration/resolution.

  • aetherwave_comic_assembleAssemble the comic's pages (starts, then returns)

    Free. Lays out every page from its drawn panels and letters the speech balloons and captions, then marks the book complete. Returns immediately; about 4 seconds a page (12 pages took about 45 seconds). A page with any undrawn panel is skipped and the book is marked 'pages-partial', so by default this refuses until every panel is drawn. Also re-run it after redrawing a panel on an assembled page. Then aetherwave_comic_export.

  • aetherwave_comic_character_referenceGenerate or approve a comic character's reference image

    Gives a comic character a reference image, which every panel uses to keep that character looking the same. action 'generate' (6 credits per image): draws 'count' (1 to 4) full-body references in the book's art style. Each new image is ADDED to the character's options, nothing is replaced. With editPrompt alone, the note steers a fresh drawing ("older, with a grey beard"). With editPrompt AND baseUrl (one of this character's existing images) it edits that image and keeps the same person. Images are saved to permanent AetherWave storage. If the call runs out of time the images still land: read …

  • aetherwave_comic_createCreate a comic book project

    Free. Creates a comic book project (the AetherWave Graphic Novel Engine) and returns its projectId and each character's characterId. Nothing is generated yet. The full flow, one tool per step. Every slow step starts and returns; come back with aetherwave_comic_status. 1. aetherwave_comic_create (this) - title, premise, cast, style. 2. aetherwave_comic_character_reference - generate a reference image per character, then approve one. Do this BEFORE the script: approving rewrites the character's description from the picture, and every panel uses the approved image to keep the face consistent. 3.…

  • aetherwave_comic_drawDraw the comic's panels (starts, then returns)

    action 'start' (default): starts drawing every panel that is not drawn yet (pending or failed), one at a time, 1.5 to 6 minutes each, and returns immediately. 9 credits a panel, charged only when a panel succeeds. Safe to call again at any time: if a run is active it reports alreadyDrawing and starts nothing; if a run died (a server restart ends a run silently) it resumes with just the missing panels. Pass maxCredits to refuse a run that would cost more. Follow progress with aetherwave_comic_status. action 'stop': asks the active run to stop after the panel it is on.

  • aetherwave_comic_estimateEstimate the credit cost of a comic bookread-only

    Free. Quotes a comic before anything is made: script credits plus panel credits for a page count and panel engine. The quote assumes 4 panels a page, so it runs HIGH for short books (a 12-page book was quoted 462 and cost 301 because the script wrote 27 panels, not 48). The real panel price is known after the script: aetherwave_comic_status reports creditsToFinishDrawing, and aetherwave_comic_draw accepts maxCredits. Character references cost 6 credits each on top.

  • aetherwave_comic_exportExport a finished comic as a download link

    Free. Builds the assembled book as 'pdf', 'epub' (fixed-layout, Kindle ready), 'cbz' (comic readers) or 'bundle' (a ZIP of all three plus page PNGs), and returns a download URL that lasts about a day. Files are large (a 12-page PDF measured 130 MB). Returns within ~45 s: the build usually finishes inside that; if not, it returns status 'building' with an exportId, and calling again with that exportId (or aetherwave_get_job with kind 'comic-export', the exportId as taskId, and projectId) returns the link. One export builds per account at a time: if one is already building, this reports that one…

  • aetherwave_comic_redraw_panelRedraw one comic panel, optionally rewordedcan change or delete data

    Redraws a single panel, replacing its current image. 9 credits, charged only on success. Pass prompt to replace the panel's scene description for this drawing: the way to get past a content-filter refusal (see failedPanels[].errorMessage in aetherwave_comic_status) is to reword the scene, not to retry it. Dialogue and captions are kept. A redraw takes 1.5 to 6 minutes; if it outlasts this call the tool returns stillDrawing and the result shows up in aetherwave_comic_status. Refused while a full drawing run is active. If the panel's page was already assembled, re-run aetherwave_comic_assemble a…

  • aetherwave_comic_statusCheck a comic book's progressread-only

    Free. Where a comic is and what to do next. Reports the project status, the drawing state, every failed panel with its reason, assembled page URLs, and each character's reference images, plus a nextStep. drawing is one of: no_script, not_started, drawing, redrawing, stalled, done. 'stalled' means panels are still pending or failed and NO run is active: a server restart or a failure ended the run, and aetherwave_comic_draw must be called again. Never treat a stopped run as finished. With no projectId it lists your recent comic projects.

  • aetherwave_comic_write_scriptWrite the comic's script (starts, then returns)can change or delete data

    Starts writing the script: chapters, pages, panels, dialogue and captions. Returns immediately; it takes about 2 to 3 minutes, then aetherwave_comic_status shows the panels. Charged on actual use when it finishes (a 12-page script cost 40 credits). Approve character references first. Re-writing a script DELETES every page and panel already made, including drawn panels, so a project that already has panels needs replaceExisting: true.

  • aetherwave_edit_imageEdit image with AI (I2I)

    Edits an existing image guided by a text prompt. Pass a public `imageUrl` plus a `prompt` describing the change ("add a moon to the sky", "swap the background for a neon city", "make it look like a comic panel"). Submits, polls, and returns the edited image URL(s). Default model is 'grok-imagine-i2i' (10 cr, one image, ~15-30s, best cost-to-quality on standard edits). Other I2I-capable models: 'seedream-v4-edit', 'wan-2.5-spicy-i2i', 'flux-kontext-pro', 'qwen-image-edit', 'gpt-image-1.5-i2i' (slow, ~5min). Use list_image_models for full lineup. Note: source URLs with spaces or parentheses may …

  • aetherwave_generate_imageGenerate image (Grok Imagine, GPT Image 2, Seedream V4, Wan, Nano Banana, Flux, Z-Image Turbo)

    Generates one or more images from a text prompt (T2I) or a text prompt + reference image(s) (I2I). Submits the job, polls until terminal, and returns the final image URLs. Default model is 'grok-imagine-t2i' (fast, 2 images per generation, 6 credits). Use list_image_models to see the full lineup with pricing. For I2I, pass `referenceImages` as an array of public image URLs and pick a model with I2I support (e.g. 'grok-imagine-i2i', 'wan-2.5-spicy-i2i'). ## Model selection guide (when the user does not specify a model) Default: `grok-imagine-t2i` (6 cr, 2 outputs per call, fast, general purpo…

  • aetherwave_generate_musicGenerate music (Suno)

    Generates AI music via Suno. Returns two tracks per submission. Default model is V5.5 (newest, best quality). For instrumental output set `instrumental: true`. Music gen typically takes 30-90s - this tool polls with up to a 6-minute budget. Note: the `title` param is advisory for instrumentals - Suno often writes its own title from the prompt content for instrumental generations. Transient `GENERATE_AUDIO_FAILED` errors are common; retry once before degrading the model version. Returns within ~45 s. If the result has state "running" the job is still rendering: poll aetherwave_get_job with the…

  • aetherwave_generate_videoGenerate video (Grok Imagine, Wan 2.7, Hailuo 02, Seedance, Kling 2.6, VEO 3.1, Happy Horse)

    Generates a short-form video from a text prompt (T2V) or a text prompt + starting image (I2V). Submits, polls, and returns the final video URL. Default model is 'grok-imagine-t2v' (fast, 4 cr/s at 480p and 7 at 720p, with built-in KIE -> fal.ai fallback). Use list_video_models for the full lineup with credit cost per second. I2V models (e.g. 'grok-imagine-i2v', 'seedance-pro-i2v') require a public `imageUrl`. Video generation takes 1-8 minutes, so this tool almost always returns state "running" with a taskId: poll aetherwave_get_job with kind "video". ## Model selection guide for videos (when…

  • aetherwave_get_jobCheck a generation job by taskIdread-only

    Returns the current state and, once finished, the output URL(s) for any job a tool handed back as state "running" (or submitted with async:true). Poll every ~10 s. Use it whenever a generation call timed out too: the job keeps running server-side and is saved to the gallery regardless of what happened to the client, so a taskId is enough to recover a render you already paid for. kind picks the pipeline, and every tool names the kind it returns: - "image": generate_image, edit_image, upscale_image, reframe_image, remove_background - "video": generate_video - "video-edit": upscale_video, refram…

Show 21 more tools
  • aetherwave_get_user_manualGet an AetherWave user manual (PDF)

    Description is built at runtime.

  • aetherwave_list_charactersList my UGC characters (recurring on-screen people)read-only

    Returns the caller's saved UGC characters - the recurring, named people they shoot with - with everything needed to keep one consistent across a whole production. CALL THIS FIRST whenever the request names a person the user already has ("use my Amy character", "shoot this with Katie"). There is no other way to discover that a character exists, and guessing their appearance produces a different face in every clip. Per character you get: - `identityBlock` - the locked CORE IDENTITY string. Append it VERBATIM to every prompt in the production. Identical text is identical conditioning; that is t…

  • aetherwave_list_image_modelsList available image modelsread-only

    Returns every image-generation model AetherWave supports, with its credit cost, default aspect ratio, supported inputs (T2I vs I2I), and any model-specific options. Call this before generate_image when you don't know the right model ID. The model key (e.g. 'grok-imagine-t2i') is what you pass as `model` to generate_image.

  • aetherwave_list_master_presetsList available audio mastering presetsread-only

    Returns every AI mastering preset AetherWave supports, with target LUFS, tags, descriptions, and difficulty level. Call this before master_audio when you don't know which preset fits the track. 12 presets total covering streaming, hip hop, EDM, pop, rock, lo-fi, R&B, acoustic, cinematic, podcast, gentle, and loud-and-punchy mastering styles. Each preset has a target LUFS value (e.g. -14 for streaming, -9 for loud) so you can match the user's distribution target.

  • aetherwave_list_my_creationsList my AetherWave gallery itemsread-only

    Returns items from the authenticated user's gallery - images, videos, audio tracks they've generated on AetherWave. Useful for agent workflows like 'find my last 5 images and reframe them all to 9:16' or 'list my recent songs and master each one'. Supports pagination and type filtering. Each item includes id, type, prompt, model, contentUrl, thumbnailUrl, createdAt, isFavorite, visibility, rating, and type-specific fields (duration for audio/video, width/height for images).

  • aetherwave_list_video_modelsList available video modelsread-only

    Returns every video-generation model AetherWave supports (Grok Imagine, Wan 2.7, Hailuo 02, Seedance Pro/Lite, Kling 2.6 with audio, VEO 3.1, Happy Horse, etc.) with per-second credit cost, supported durations, resolutions, aspect ratios, and whether the model needs an input image (I2V). Call this before generate_video when you don't know the right model ID.

  • aetherwave_master_audioMaster an audio track (AI mastering)

    Submits an audio file for AI mastering and returns the mastered URL (the route polls the Python service internally; a typical track takes 30-90 s, a long one up to 5 min). Useful as a final polish step after music generation. Cost: 20 credits per track. Producer, Mogul, and Ultimate plans get mastering free. Output is WAV (~50MB per 3-minute track, lossless for redistribution). Pick a `preset` to steer the mastering style; call `aetherwave_list_master_presets` for the full live list (12 presets including streaming, loud, gentle, hip_hop, edm, pop, rock, lofi, rnb, acoustic, cinematic, podcast)…

  • aetherwave_merch_garmentsList print-on-demand garments, colours and print areasread-only

    Free. Without garmentId: the curated garment list (tees, tanks, hoodies, with Printful catalog ids). With garmentId (any Printful catalog product id, including hats): every colour with its US in-stock sizes, the print placements with their size in inches, and embroidery thread colours where the product is embroidered. Use it to pick garmentId, color and placement for aetherwave_merch_mockup.

  • aetherwave_merch_mockupRender a design on a real garment (print file + mockups)

    Description is built at runtime.

  • aetherwave_merch_mockup_statusCheck a mockup renderread-only

    Free. Status and mockup URLs of a render started by aetherwave_merch_mockup (kept 6 hours, visible only to the account that paid for it).

  • aetherwave_merch_prepare_designPrepare a design for printing

    1 credit. Turns an image into a print-ready transparent PNG trimmed to the artwork. Pass an AetherWave media URL (e.g. from aetherwave_generate_image), a data URL, or on the local server a file path. Set knockout=true to remove a plain background (only background connected to the edges is removed, so white lettering inside the design survives). Returns designUrl for aetherwave_merch_mockup. For a dark garment, a design drawn as light ink on transparency prints best.

  • aetherwave_printful_create_productCreate a product in your Printful store

    Free (AetherWave charges nothing; Printful bills you per order as usual). Creates a product in YOUR Printful store using PRINTFUL_API_TOKEN from this server's env. The token is used only between this machine and api.printful.com. It never goes to AetherWave. Pass the printfileUrl from aetherwave_merch_mockup with the SAME garmentId, color and placement. Sizes default to every US in-stock size. Embroidered placements need threadColors (hex values listed by aetherwave_merch_garments). If your store is connected to Shopify, Etsy and so on, publishing to that channel happens in Printful's dashboa…

  • aetherwave_printful_list_productsList products in your Printful storeread-only

    Free. Lists products in YOUR Printful store (PRINTFUL_API_TOKEN, used locally only).

  • aetherwave_reframe_imageReframe image to a new aspect ratio (Ideogram V3 Reframe)

    Reframes an image to a new aspect ratio by intelligently outpainting the edges. Pass a public `imageUrl` and the target `aspectRatio` ('16:9', '9:16', '1:1', '4:3', '3:4', etc.). Three speed tiers: 'turbo' (5 cr, fast), 'balanced' (10 cr, default), 'quality' (14 cr, slowest, best edges). Returns the reframed image URL. Returns within ~45 s. If the result has state "running" the job is still rendering: poll aetherwave_get_job with the returned taskId and kind every ~10 s. Pass wait:true ONLY if your MCP client permits tool calls longer than 60 s (most do not). Pass async:true to get the taskId…

  • aetherwave_reframe_videoReframe video to a new aspect ratio (Luma Ray 2 Flash)

    Reframes a video to a new aspect ratio by intelligently outpainting/cropping the edges. Pass a public `videoUrl` and target `reframeAspectRatio`. 17 credits per second. Optional `reframePrompt` lets you steer the new edge content (e.g. 'extend the sky with sunset clouds'). Returns the reframed video URL (R2-hosted). Returns within ~45 s. If the result has state "running" the job is still rendering: poll aetherwave_get_job with the returned taskId and kind every ~10 s. Pass wait:true ONLY if your MCP client permits tool calls longer than 60 s (most do not). Pass async:true to get the taskId ba…

  • aetherwave_remove_backgroundRemove background from image (Recraft + fal.ai BiRefNet v2 fallback)

    Strips the background from an image, returning a PNG with transparent alpha. Pass a public `imageUrl`. Useful for product shots, character cutouts, logo isolation, or compositing onto a new background. ~5 credits per image. Recraft is the primary provider; on outage the tool auto-falls back to fal.ai BiRefNet v2 so single-image calls never silently fail. Works best on photographic subjects (people, products, animals); transparent-PNG inputs have no foreground to segment. Returns within ~45 s. If the result has state "running" the job is still rendering: poll aetherwave_get_job with the return…

  • aetherwave_remove_background_videoRemove background from video

    Strips the background from a video frame-by-frame using rembg (u2netp) on AetherWave's Python service. Pass a public `videoUrl`. Choose `bgType: "transparent"` for an alpha-channel WebM output (compositing) or `bgType: "color"` with a `customColor` hex for a solid replacement. 2 credits per second. Slowest tool in the surface (per-frame processing); a 6s clip takes ~4 min, a 30s clip ~15-20 min. Works best on subjects with clear edges (people, products). Returns the processed video URL (R2-hosted). Returns within ~45 s. If the result has state "running" the job is still rendering: poll aether…

  • aetherwave_shop_create_listingAetherWave admin: create a /shop merch listing

    ADMIN ONLY (the server rejects anyone else). Creates the product in AetherWave's Printful store and its /shop listing, hidden unless publish=true. Both confirmations are required: the wording was searched in apparel (US Class 25), and nothing names or shows a celebrity or copies another shirt's artwork. Prices: check margin after Printful cost, shipping (included in price) and Printful's sales tax.

  • aetherwave_upload_to_galleryUpload a file to your AetherWave gallery

    Description is built at runtime.

  • aetherwave_upscale_imageUpscale image

    Upscales a source image 2x or 4x. Pass a public `imageUrl` and an `upscaleFactor`. Flat 4 credits. Returns the upscaled image URL. Returns within ~45 s. If the result has state "running" the job is still rendering: poll aetherwave_get_job with the returned taskId and kind every ~10 s. Pass wait:true ONLY if your MCP client permits tool calls longer than 60 s (most do not). Pass async:true to get the taskId back immediately without waiting.

  • aetherwave_upscale_videoUpscale video (Atlas / BytePlus)

    Upscales a source video. Pass a public `videoUrl` and a target tier. Two engines: Atlas reaches 1080p and 2k only (7 and 10 cr/s; clips up to 53s at 1080p and 23s at 2k, source <=30fps); BytePlus also reaches 4k and 8k (4/8/16/62 cr/s at 1080p/2k/4k/8k) and is selected automatically for 4k and 8k. IMPORTANT, A TIER IS NOT A DIMENSION. These names are 16:9 standards, so '4k' means the 3840x2160 BOX and the source is fitted inside it, which means the SMALLER dimension wins. A square source at '4k' returns 2160x2160, NOT 3840x3840. Measured. A 3:4 source at Atlas '2k' returned 1664x2216. So never…

Signals

Stars
6
Forks
0
Open issues
0
Weekly downloads
88
Last commit
Oct 5, 2026 (23 days ago)
Last release
Jun 12, 2026 (4 months ago)
Last package publish
Oct 4, 2026 (24 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.AetherWave-Studio/aetherwave-mcp
Version
0.2.6
Auth
API key
Packages
npm @aetherwave-studio/mcp
License
MIT
Repository
github.com/AetherWave-Studio/aetherwave-mcp
Website
aetherwavestudio.com/developers
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

Aetherwave MCP. Agent Mart. https://agentmart.dev/connectors/aetherwave-studio-aetherwave-mcp (last updated 2026-10-25)