fal-mcp
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 stepsfal-ai/flux-pro/v1.1— professional, up to 2K resolutionfal-ai/flux-general— supports LoRA, ControlNet, IP-Adapterfal-ai/recraft/v3/text-to-image— illustration stylefal-ai/flux-pro/kontext— image editing
Setup
- Get an API key from fal.ai
- Set the
FAL_KEYenvironment variable (or add it to a.env.localfile 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