
Replicate Flux MCP
Community server generating images and SVG assets via Replicate's Flux models.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx -y replicate-flux-mcpPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"replicate-flux-mcp": {
"command": "npx",
"args": [
"-y",
"replicate-flux-mcp"
],
"env": {
"REPLICATE_API_TOKEN": "<your-replicate-api-token>"
}
}
}
}Before you start
- Node.js (run via `npx`; the package is distributed on npm)
- A Replicate API token from https://replicate.com/account/api-tokens, set as the REPLICATE_API_TOKEN environment variable
- A Replicate account with billing enabled (image generation is pay-per-use)
About Replicate Flux MCP
Replicate Flux MCP is a community Node.js server that lets an AI assistant generate raster images and SVG vector graphics through the Replicate API. Raster generation uses Black Forest Labs' Flux Schnell model, and vector output uses Recraft's V3 SVG model.
Beyond single-image generation, it supports batch generation, image variants (via seed or style changes), and SVG output. It also exposes generic escape-hatch tools (run_replicate_model, get_model_schema) so you can run essentially any model hosted on Replicate, plus prediction-history tools to inspect past runs.
The server ships on npm as replicate-flux-mcp and runs over stdio, so it drops into Claude Desktop, Cursor, or any MCP client via npx. It is also published to hosted registries like Smithery and Glama. Replicate billing is usage-based (pay per prediction), so cost scales with how many images you generate.
Tools & capabilities (8)
generate_imageGenerate a single image from a text prompt using Flux Schnell.
generate_multiple_imagesGenerate images from up to 10 separate prompts in one call.
generate_image_variantsCreate 2-10 variants of one prompt via seed or style variation.
generate_svgProduce an SVG vector graphic from a text description (Recraft V3 SVG).
prediction_listList recent predictions from your Replicate account.
get_predictionFetch details and status for a specific prediction by ID.
run_replicate_modelRun an arbitrary Replicate model (escape hatch beyond Flux).
get_model_schemaRetrieve the OpenAPI input schema for a given Replicate model.
When to use it
- Use it when you want an LLM agent to generate marketing or blog images from a text prompt without leaving the chat.
- Use it when you need scalable SVG icons or illustrations that stay crisp at any size.
- Use it when you want several variations of one concept to pick from (seed or style variants).
- Use it when you need to batch-generate images for many prompts in a single request.
- Use it when you want to call other Replicate-hosted models from the same MCP connection via run_replicate_model.
Quick setup
- 1Get a Replicate API token at https://replicate.com/account/api-tokens.
- 2Add the server to your MCP client config with `npx -y replicate-flux-mcp` as the command.
- 3Set REPLICATE_API_TOKEN in the server's env block.
- 4Restart the MCP client (Claude Desktop, Cursor, etc.) so it loads the server.
- 5Ask the assistant to generate_image with a prompt to verify it works.
Security notes
Your Replicate API token incurs per-generation costs and can run arbitrary models on your account; restrict spend limits on Replicate. The server requires the token to be present in env at startup.
Replicate Flux MCP FAQ
Where do I get the API token?
Create a Replicate account and generate a token at https://replicate.com/account/api-tokens, then set it as REPLICATE_API_TOKEN.
Is image generation free?
No. Replicate is pay-per-use, so each generation incurs a small charge billed to your Replicate account.
Can it generate vector graphics, not just PNGs?
Yes. The generate_svg tool produces true SVG output via Recraft's V3 SVG model, which scales cleanly to any size.
Can I run models other than Flux?
Yes. Use run_replicate_model with any model ID, and get_model_schema to discover its inputs. A REPLICATE_MODEL_ALLOWLIST env var can restrict which models are permitted.
Which clients does it work with?
Any stdio MCP client, including Claude Desktop and Cursor; it's also listed on hosted registries like Smithery and Glama.
Alternatives to Replicate Flux MCP
Popular community server that feeds Figma layout data to coding agents via a Figma API token.
Official MiniMax server for TTS, voice cloning, music, image, and video generation.
Official ElevenLabs server for text-to-speech, voice cloning, sound effects, and audio.