MCP Server Guide

Use Flux Kontext Pro from Claude Code

Flux Kontext Pro is Black Forest Labs' editing-focused model designed to preserve character and composition through edits. Ideal for series work where the same character appears across multiple panels or frames.

If you use Claude Code and you want Flux Kontext Pro available as a native tool that the agent can call directly, the AetherWave MCP server wires it up in one command. No SDK to learn, no separate API key per provider, no polling loop to write.

Install in 30 seconds

Run this from your terminal:

claude mcp add aetherwave \
-e AETHERWAVE_API_KEY=aw_live_your_key_here \
-- npx -y @aetherwave-studio/mcp

Get your API key at your Profile page under the Developer tab. New accounts start with free credits to try it without spending anything.

Quick facts

Model ID
flux-kontext-pro
Provider
Black Forest Labs via KIE.ai
Cost
7 cr per image
Outputs per call
1

How to use it

Once the MCP is installed, you can ask Claude Code naturally. It'll pick Flux Kontext Pro from the model-selection rubric in the tool description when your prompt matches its strengths (character-preserving image edits).

Example interaction:

You
Generate character consistency across multiple images

Claude Code calls aetherwave_edit_image with model: "flux-kontext-pro" and returns the finished asset URL. The result auto-saves to your AetherWave gallery (Cloudflare R2 hosted, no URL expiration).

Sample prompts that work well

Example 1
"Same character, now wearing a leather jacket and standing in a different alley"
Example 2
"Same product, now photographed from above instead of the side"
Example 3
"Same scene at night instead of day"

When to pick Flux Kontext Pro

Flux Kontext Pro shines for:

How it compares

vs flux-kontext-max at 14 cr: Pro at 7 cr is the cost-effective tier. Max is the higher-fidelity variant. Pick Pro for general edits; Max when subtle detail preservation matters most.

Run aetherwave_list_image_models from Claude Code to see the full live catalog with pricing.

Cost

Flat 7 credits per image. Single output. Optimized for context-preserving edits where character identity and scene composition matter.

Credits come from your AetherWave account. Plans:

Frequently Asked Questions

How do I install AetherWave MCP in Claude Code?

One command (shown above). Then restart Claude Code. The agent will have Flux Kontext Pro available as part of the aetherwave_edit_image tool with 1 output(s) per call.

How do I use Flux Kontext Pro from Claude Code?

Just describe what you want. The agent picks Flux Kontext Pro when your prompt matches its strengths (character-preserving image edits). You can also explicitly request it by passing model: "flux-kontext-pro" in the tool call.

What does Flux Kontext Pro cost per generation?

Flat 7 credits per image. Single output. Optimized for context-preserving edits where character identity and scene composition matter. Credits come from your AetherWave account (Studio sub from $9.99/mo or one-time bundles from $4.99/500 cr).

Try Flux Kontext Pro from Claude Code

Free API key, free starter credits, single MCP install. Be running your first Flux Kontext Pro generation in under five minutes.

Get Your Free API Key