MCP Server Guide

Use Flux 2 Pro from Claude Code

Flux 2 Pro is Black Forest Labs' general-purpose flagship from the Flux 2 line. Aggressive pricing (5 cr at 1K is hard to beat for this quality tier) and 2K support without an upcharge.

If you use Claude Code and you want Flux 2 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-2-pro
Provider
Black Forest Labs via KIE.ai
Cost
5 cr at 1K, 7 cr at 2K
Outputs per call
1

How to use it

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

Example interaction:

You
Generate cost-effective 2k generation

Claude Code calls aetherwave_generate_image with model: "flux-2-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
"Cinematic establishing shot of a misty harbor at dawn, 2K, photorealistic"
Example 2
"Composite of a vintage motorcycle in a modern showroom, 2K, ad campaign style"
Example 3
"Detailed portrait of a violinist mid-performance, dramatic lighting, 2K"

When to pick Flux 2 Pro

Flux 2 Pro shines for:

How it compares

vs gpt-image-2-t2i at 9 cr: Flux 2 Pro at 5 cr / 1K is nearly half the price for comparable quality. GPT Image 2 wins on typography and aesthetic consistency; Flux 2 Pro wins on cost-per-image at production scale.

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

Cost

Tiered pricing by resolution. 5 credits at 1K, 7 credits at 2K. Single output. Supports up to 8 reference images for multi-reference generation.

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 2 Pro available as part of the aetherwave_generate_image tool with 1 output(s) per call.

How do I use Flux 2 Pro from Claude Code?

Just describe what you want. The agent picks Flux 2 Pro when your prompt matches its strengths (cost-effective premium image generation). You can also explicitly request it by passing model: "flux-2-pro" in the tool call.

What does Flux 2 Pro cost per generation?

Tiered pricing by resolution. 5 credits at 1K, 7 credits at 2K. Single output. Supports up to 8 reference images for multi-reference generation. Credits come from your AetherWave account (Studio sub from $9.99/mo or one-time bundles from $4.99/500 cr).

Try Flux 2 Pro from Claude Code

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

Get Your Free API Key