Bring FLUX into the tools you already use. Generate options in parallel, edit attached images through prompts, and branch into variations from any result you like — the full FLUX.2 toolkit, inside Claude, Cursor, Codex, Windsurf, and any MCP-compatible client. No API code, no keys pasted into the conversation.Documentation Index
Fetch the complete documentation index at: https://docs.bfl.ml/llms.txt
Use this file to discover all available pages before exploring further.
Connect FLUX
Most modern MCP clients can connect tohttps://mcp.bfl.ai directly and handle the OAuth flow on their own — pick your client from the tabs below.
For stdio-only or OAuth-incompatible clients (for example Hermes), use the mcp-remote fallback tab. It runs locally, handles the browser OAuth flow, refreshes tokens for you, and exposes FLUX as a normal stdio server.
Pricing
You pay BFL directly. The organization selected during OAuth sign-in is billed for generated images. No shared quotas, no middleman. To change organizations, disconnect the connector and reconnect it. Current rates are listed at bfl.ai/pricing.Tool reference
The MCP server exposes a small set of tools. Your client decides which to call based on your prompt — you do not need to invoke them by name. The reference is here for developers who want to know exactly what is available.Show all tools
Show all tools
| Tool | Purpose | Notes |
|---|---|---|
generate_image | Generate one or up to 8 images in parallel. Covers text-to-image, edits, multi-reference composition, style transfer, inpainting-style edits, and outpainting through prompts. | Each entry in requests carries its own prompt, model, dimensions, seed, and up to 8 input_image slots. Outpainting uses width/height larger than the source. |
generate_variations | Produce N more images “in the same direction” as a previous generation, identified by request_id. | Reuses the original prompt, model, dimensions, and any input image slots. Defaults to 4 variations, max 8. |
get_history | List recent generations as a thumbnail grid with per-tile actions (Variations, Edit, copy, download). | Keyset pagination on created_at via cursor; supports before / after date filters and a status filter. |
get_credits | Return the calling user’s remaining BFL credit balance. | Useful when a generation fails for billing reasons. |
generate_image: flux2_pro_preview (default), flux2_max (highest quality), flux2_klein_9b_preview (faster, up to 4 input images), flux2_flex (best for typography), flux2_klein_4b. The full catalog and per-model reference-image limits are also exposed as the bfl://models MCP resource.Troubleshooting
Tools do not appear after connecting
Tools do not appear after connecting
- In Claude Desktop or Claude.ai, open Settings → Connectors and confirm the FLUX connector shows as Connected.
- If the connection failed silently, remove the connector and add it again. Make sure pop-ups are not blocked so the OAuth window can open.
- In Claude Code, run
claude mcp listto confirm the server is registered. - In Codex, run
codex mcp listto confirm theFLUXserver is registered, then start a new Codex session.
Refreshing tools or reconnecting the server
Refreshing tools or reconnecting the server
If the FLUX tools are not responding, or you just installed or updated the connector, refreshing the connection can help.
- Claude.ai / Claude Desktop: open Settings → Connectors, toggle the FLUX connector off and on, or click Reconnect. Restarting Claude Desktop is another way to pick up a fresh tool list.
- Claude Code: run
/mcpto view server status and reauthenticate. To rebuild the registration entirely, runclaude mcp remove FLUXfollowed byclaude mcp add --transport http FLUX https://mcp.bfl.ai. - Codex: run
codex mcp login FLUXto reauthenticate. To rebuild the registration entirely, runcodex mcp remove FLUXfollowed bycodex mcp add FLUX --url https://mcp.bfl.ai— the OAuth browser flow runs automatically on add. mcp-remoteclients: clearing the cached OAuth tokens withrm -rf ~/.mcp-authand restarting the client triggers a fresh browser sign-in.- To confirm the tools are live, ask your MCP client something simple like “check my BFL credits”.
Authentication or billing errors
Authentication or billing errors
- Make sure you have a BFL account at bfl.ai.
- Disconnect and reconnect the MCP server to redo the OAuth flow.
- Check that the selected organization has sufficient credits.
- Ask your MCP client to check your BFL credits if you want to verify the current balance.
A generation keeps loading
A generation keeps loading
Large sets of images, FLUX.2 [max], or complex edits can take longer than smaller generations. In Claude and other visual MCP clients, the image view keeps updating automatically.
Attached image editing fails
Attached image editing fails
Your MCP client needs permission to upload attached images to BFL. If your client blocks outbound HTTPS from its sandbox, allow the
*.bfl.ai domain or use a public image URL instead.Image quality issues
Image quality issues
- Use detailed prompts. Describe subject, style, composition, and lighting.
- For typography or readable text, ask for FLUX.2 [flex].
- For hero shots or final assets, ask for FLUX.2 [max].
- For edits, say what should stay unchanged as well as what should change.
Switching the billed organization
Switching the billed organization
Disconnect the FLUX connector in your client and reconnect it. The OAuth flow will prompt you to select an organization again.
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.
Agent Skills
MCP and Agent Skills solve different problems:| MCP | 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 |
| Install on | Claude Desktop, Claude.ai, Claude Code, and MCP-compatible clients | Claude Code, Cursor, Windsurf, and other skill-compatible tools |
Installation
- Claude Code
- Cursor
- Other Tools