How to add Replicate Flux MCP to Windsurf

Community server generating images and SVG assets via Replicate's Flux models. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 103★ · stdio · apikey

Windsurf config for Replicate Flux MCP

npx -y replicate-flux-mcp

{
  "mcpServers": {
    "replicate-flux-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "replicate-flux-mcp"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "<your-replicate-api-token>"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Replicate Flux MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Replicate Flux MCP's tools become available to Cascade.

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)

What Replicate Flux MCP can do in Windsurf

generate_image

Generate a single image from a text prompt using Flux Schnell.

generate_multiple_images

Generate images from up to 10 separate prompts in one call.

generate_image_variants

Create 2-10 variants of one prompt via seed or style variation.

generate_svg

Produce an SVG vector graphic from a text description (Recraft V3 SVG).

prediction_list

List recent predictions from your Replicate account.

get_prediction

Fetch details and status for a specific prediction by ID.

run_replicate_model

Run an arbitrary Replicate model (escape hatch beyond Flux).

get_model_schema

Retrieve the OpenAPI input schema for a given Replicate model.

Security

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Replicate Flux MCP config there under the "mcpServers" key and restart the client.

Is Replicate Flux MCP safe to use with Windsurf?

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.

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.

View repo Full Replicate Flux MCP page