Fal

An MCP server that wraps the fal.ai image generation API, giving Claude (or any MCP client) the ability to generate and edit images.

Tools

Tool	Description
generate_image	Text-to-image generation with configurable model, size, steps, and guidance
generate_with_reference	Image generation guided by a style/content reference image
generate_with_lora	Image generation with a LoRA model applied
edit_image	Edit an existing image using natural language instructions (FLUX Kontext)
raw_generate	Submit arbitrary requests for advanced configurations (ControlNet, IP-Adapter, multi-LoRA)
list_outputs	List all saved images in the output directory

Supported models

• fal-ai/flux/dev — high quality (default)
• fal-ai/flux/schnell — fast, 1-4 steps
• fal-ai/flux-pro/v1.1 — professional, up to 2K resolution
• fal-ai/flux-general — supports LoRA, ControlNet, IP-Adapter
• fal-ai/recraft/v3/text-to-image — illustration style
• fal-ai/flux-pro/kontext — image editing

Setup

1. Get an API key from fal.ai
2. Set the FAL_KEY environment variable (or add it to a .env.local file in the parent directory)

Usage with Claude Code

Add this to your .mcp.json:

{
  "mcpServers": {
    "fal": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/fal-mcp", "python", "server.py"]
    }
  }
}

Dependencies

• Python >= 3.11
• FastMCP v2
• httpx
• python-dotenv