Log inSubmit server
Replicate Flux MCP logo

Replicate Flux MCP

by awkoy

Generates raster images, SVGs, variants, and other Replicate model outputs through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Replicate Flux MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "awkoy-replicate-flux-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "replicate-flux-mcp"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "YOUR_VALUE_HERE",
        "REPLICATE_IMAGE_MODEL_ID": "YOUR_VALUE_HERE",
        "REPLICATE_SVG_MODEL_ID": "YOUR_VALUE_HERE",
        "REPLICATE_MODEL_ALLOWLIST": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y replicate-flux-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

awkoy/replicate-flux-mcp MCP server exposes Replicate image-generation and model-execution capabilities through MCP tools. It uses Flux Schnell for raster images and Recraft V3 SVG by default, with configurable model IDs and allowlisted overrides for curated generation tools. Agents can create single images, batches, variants, SVGs, inspect predictions, and query model schemas before sending raw inputs. Use it when an MCP client needs access to Replicate models and you can provide a Replicate API token.

Use cases

  • Generate raster images from natural-language prompts
  • Create SVG icons, logos, and diagrams
  • Batch prompts or produce image variants
  • Inspect Replicate predictions and model schemas
  • Run supported video or restoration models

Key features

  • Flux Schnell raster image generation
  • Recraft V3 SVG generation
  • Batch and variant image requests
  • Replicate prediction history and lookup
  • Allowlisted and arbitrary model execution
  • OpenAPI schema inspection

Tools9

What Replicate Flux MCP lets your agent do. Expand a tool for its parameters.

Self-reported~278 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

20/20 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · replicate-flux-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars106Stargazers on the source repository.
npm downloads8.4kPackage downloads in the last 30 days.
Last commit26d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed9Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Replicate Flux MCP works

What awkoy/replicate-flux-mcp MCP server does

The awkoy/replicate-flux-mcp MCP server connects an MCP-compatible client to Replicate for image and model generation. Its curated image tools use black-forest-labs/flux-schnell by default, while SVG requests use recraft-ai/recraft-v3-svg. Both defaults can be changed through environment variables.

The server supports more than one-shot raster generation. Agents can submit a prompt for one image, submit an array of prompts for batch generation, or request several variants from one prompt. SVG generation is available separately for vector-oriented results such as icons, logos, and diagrams. Prediction tools provide access to recent Replicate runs and details for a selected prediction.

How it works

An MCP client starts the server locally through the published npm package and passes the Replicate token through the environment. Tool calls are translated into Replicate API requests. Curated image model overrides are checked against a built-in allowlist, and the SVG tool has its own supported model entry.

For models outside the curated generation workflows, the awkoy/replicate-flux-mcp MCP server provides run_model for allowlisted models and run_replicate_model for a model reference in owner/name[:version] form. The latter can be paired with get_model_schema, which retrieves a Replicate model's OpenAPI input schema and description before an agent constructs the payload. An optional REPLICATE_MODEL_ALLOWLIST can restrict arbitrary model execution.

Generation tools return structured content in addition to human-readable results. Batch and variant calls can send progress notifications when the client supplies a progress token. The repository also describes history resources for image, SVG, and prediction runs, along with prompt templates surfaced by supported clients.

Setup and configuration

Create a Replicate API token and set REPLICATE_API_TOKEN in the MCP client's server configuration. Smithery and Glama.ai are also documented as hosted setup options.

REPLICATE_IMAGE_MODEL_ID changes the default raster model, and REPLICATE_SVG_MODEL_ID changes the default SVG model. If these variables are omitted, the Flux Schnell and Recraft V3 SVG defaults apply. Model overrides for curated tools still need to satisfy the relevant allowlist. The Codex example also sets a startup timeout, but that is a client configuration rather than a server environment variable.

Tools and capabilities

  • generate_image: create one raster image from a prompt.
  • generate_multiple_images: process multiple prompts in one request.
  • generate_image_variants: create multiple versions of one prompt.
  • generate_svg: request vector output from a prompt.
  • prediction_list: retrieve recent predictions for the configured Replicate account.
  • get_prediction: inspect one prediction by identifier.
  • run_model: send raw input to a whitelisted Replicate model, including supported video or restoration use cases.
  • run_replicate_model: run a model by its Replicate owner/name reference.
  • get_model_schema: inspect the input schema needed by a Replicate model.

The repository identifies the server as MIT-licensed and documents compatibility with Claude Desktop, Cursor, Cline, Zed, and other spec-compliant MCP clients. Running model predictions requires the user's Replicate credentials and may incur Replicate usage costs.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Replicate Flux MCP

Run `npx -y replicate-flux-mcp` and provide `REPLICATE_API_TOKEN` in the MCP client's environment configuration.

Yes.

Raster image tools default to `black-forest-labs/flux-schnell`, and SVG generation defaults to `recraft-ai/recraft-v3-svg`.

It provides `run_replicate_model` for any Replicate model referenced as `owner/name[:version]`, plus `get_model_schema` to inspect the expected input. An optional allowlist can restrict this behavior.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewReplicate Flux MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/awkoy-replicate-flux-mcp?style=directory)](https://allmcps.com/mcp/awkoy-replicate-flux-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/awkoy-replicate-flux-mcp"><img src="https://allmcps.com/api/badge/awkoy-replicate-flux-mcp?style=directory" alt="Replicate Flux MCP on AllMCPs" /></a>