Flux Kontext MCP Server

by runapi-aiio.github.runapi-builder/flux-kontext-mcpv0.2.0

RunAPI Flux Kontext MCP server for image generation: create tasks, poll results, and check pricing across 2 model variants from Claude Code, Codex, Cursor, and VS Code.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active10d ago

Install Flux Kontext MCP server

claude mcp add flux-kontext -e RUNAPI_API_KEY='<runapi-api-key>' -- npx -y @runapi.ai/flux-kontext-mcp

{
  "mcpServers": {
    "flux-kontext": {
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/flux-kontext-mcp"
      ],
      "env": {
        "RUNAPI_API_KEY": "<runapi-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "flux-kontext": {
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/flux-kontext-mcp"
      ],
      "env": {
        "RUNAPI_API_KEY": "<runapi-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "flux-kontext": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/flux-kontext-mcp"
      ],
      "env": {
        "RUNAPI_API_KEY": "<runapi-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "flux-kontext": {
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/flux-kontext-mcp"
      ],
      "env": {
        "RUNAPI_API_KEY": "<runapi-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
RUNAPI_API_KEY	—	yes	Optional RunAPI API key for headless hosts. Interactive MCP hosts can use the login tool, which writes shared RunAPI config.

Freshness

Active — last maintenance signal 10d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-30 · 10d ago · GitHub
Latest release
2026-09-30 · 10d ago · GitHub · v0.2.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-30 · 10d ago · official registry · v0.2.0

FAQ

›How do I install the Flux Kontext MCP server in Claude Code?

Run: claude mcp add flux-kontext -e RUNAPI_API_KEY='<runapi-api-key>' -- npx -y @runapi.ai/flux-kontext-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Flux Kontext require an API key?

Yes. It expects RUNAPI_API_KEY, of which 1 is a secret.

›Can I use Flux Kontext as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Flux Kontext in the official MCP registry?

Yes, as io.github.runapi-builder/flux-kontext-mcp.