@runapi.ai/flux-2-mcp

RunAPI MCP server for the Flux 2 model line. Create tasks, poll their status, and check pricing through a single RunAPI API key.

Tools

• remix_image — create a Flux 2 task (remix image) and (optionally) poll until it reaches a terminal status. Returns the task id, status, output URLs, and a price snapshot. Models: flux-2-flex-remix-image, flux-2-pro-remix-image, flux-2-flex-text-to-image, flux-2-pro-text-to-image.

• text_to_image — create a Flux 2 task (text to image) and (optionally) poll until it reaches a terminal status. Returns the task id, status, output URLs, and a price snapshot. Models: flux-2-flex-remix-image, flux-2-pro-remix-image, flux-2-flex-text-to-image, flux-2-pro-text-to-image.

• get_task — fetch the current status and latest payload for a task.

• check_pricing — look up pricing for a model in this line.

Related MCP server: Flux Schnell Server

Configuration

Set a RunAPI API key via the RUNAPI_API_KEY environment variable, or write it to ~/.config/runapi/config.json:

mkdir -p ~/.config/runapi
echo '{"api_key":"YOUR_KEY"}' > ~/.config/runapi/config.json

Get an API key at https://runapi.ai. Pricing is listed at https://runapi.ai/pricing.

Usage

Run the server over stdio:

npx -y @runapi.ai/flux-2-mcp

Add it to an MCP client (see examples/ for per-client configs):

{
  "mcpServers": {
    "flux-2": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/flux-2-mcp"],
      "env": { "RUNAPI_API_KEY": "${RUNAPI_API_KEY}" }
    }
  }
}

License

Apache-2.0