Labsco
black-forest-labs logo

FLUX

β˜… 5

from black-forest-labs

Official FLUX MCP server from Black Forest Labs. Generate, edit, vary, and browse FLUX.2 images directly in any MCP-compatible client

πŸ”₯πŸ”₯πŸ”₯πŸ”₯βœ“ VerifiedFreeAdvanced setup

FLUX MCP

Bring FLUX into the tools you already use. Generate, edit, vary, and browse FLUX images from any MCP-compatible client.

Install Β· Showcase Β· Tools Β· Examples Β· Troubleshooting

The FLUX MCP server exposes the full FLUX.2 toolkit β€” text-to-image, image editing, multi-reference composition, virtual try-on, variations, and history β€” to any client that speaks the Model Context Protocol. Generate options in parallel, edit attached images through prompts, try garments on a photo, and branch into variations from any result you like. No API code, no keys pasted into the conversation.

  • Hosted, remote, OAuth-only. Connect to https://mcp.bfl.ai. Sign in with your BFL account, pick the org to bill β€” done.

  • Every FLUX.2 model. Pro, Max, Klein (4B & 9B), Flex. Your client picks the right one for the task.

  • Built for chat. Up to 8 images in parallel per prompt. Edit attached images. Browse and reuse history.

  • You pay BFL directly. No middleman, no shared quotas. Current rates: bfl.ai/pricing.

Showcase

Generate a batch of options in one prompt

"Generate 4 editorial portrait variants β€” varied lighting, palette, and mood."

Or just one β€” when a single hero shot is what you need

"A top-down aerial photograph of shallow desert salt pools, intense direct sunlight."

Edit any image directly in chat

"Add a camel on the sand."

Before After

Browse and reuse your full generation history

"Show me my recent FLUX generations."

Every generation is saved. Tap any tile to edit, vary, or download. Variations branch off any past image in one click.

Tools

Your client picks which tool to call based on your prompt β€” you don't need to invoke them by name.

Tool What it does generate_image Generate 1–8 images in parallel. Covers text-to-image, edits, multi-reference composition, style transfer, inpainting-style edits, and outpainting β€” all through prompts. vto Virtual try-on β€” dress a person (or pet) in a garment, hat, sunglasses, shoes, bag, or any wearable from a reference image. Preserves face, hair, and pose; only the worn item changes. generate_variations Produce N more images in the same direction as a previous generation (identified by request_id). Defaults to 4, max 8. get_history List recent generations as a thumbnail grid with per-tile Variations / Edit / copy / download actions. Keyset pagination, date filters. get_credits Return your remaining BFL credit balance.

Models

Available on generate_image:

Model Use it for flux2_pro_preview (default) Everyday work β€” best balance of quality and speed flux2_max Hero shots, final assets β€” highest quality flux2_klein_9b_preview Faster iterations, up to 4 input images flux2_klein_4b Fastest option flux2_flex Typography and readable text

The full catalog, per-model reference-image limits, and the FLUX Tools (vto) are also exposed as the bfl://models MCP resource.

Example prompts

Try these in your client once FLUX is connected:

Copy & paste β€” that's it
Generate 4 editorial portrait variants β€” varied lighting, palette, and mood.
Use FLUX.2 [pro] at 1440Γ—1792.
Copy & paste β€” that's it
A top-down aerial photograph of shallow desert salt pools at golden hour,
intense direct sunlight, #FF6B6B and #F5E6D3 mineral deposits, FLUX.2 [max].
Copy & paste β€” that's it
[attach an image]
Add a camel on the sand. Preserve the rest of the composition exactly.
Copy & paste β€” that's it
Generate a movie poster with the title "MIRAGE" in 1970s grindhouse type,
high-contrast cyan and orange. Use FLUX.2 [flex].
Copy & paste β€” that's it
[attach a selfie]
Try this on me β€” a red Nike Tech Fleece hoodie, oversized fit.
Copy & paste β€” that's it
Show me my recent FLUX generations.
Copy & paste β€” that's it
[click Variations on a past image]
4 more like this one, vary the lighting.

Prompt tips

  • Front-load the subject. Put the most important object, person, or scene first.

  • Describe lighting. "Soft golden hour light" or "overcast diffused studio light" gives the model useful direction.

  • Use hex colors. #FF6B6B (coral pink) is more precise than "pinkish red" .

  • Quote rendered text. Use exact quoted strings for typography, labels, posters, and signs.

  • Avoid negative prompts. FLUX responds to what you describe, not a list of what to avoid.

  • Iterate from results. Use Variations for alternatives, or Edit to keep refining a generated image.

For the full FLUX prompting playbook, see black-forest-labs/skills.

Agent Skills (companion repo)

MCP and Agent Skills solve different problems:

MCP (this repo) Agent Skills What it does Generates, edits, varies, and browses images directly in chat Teaches your coding agent how to write FLUX API code Best for Creative work inside Claude or another MCP client Building applications that call the FLUX API

Use both. They complement each other.

Links

License

MIT Β© Black Forest Labs