Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fal-mcpGenerate a cinematic photo of a cyberpunk city in the rain"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Text-to-image generation with configurable model, size, steps, and guidance |
| Image generation guided by a style/content reference image |
| Image generation with a LoRA model applied |
| Edit an existing image using natural language instructions (FLUX Kontext) |
| Submit arbitrary requests for advanced configurations (ControlNet, IP-Adapter, multi-LoRA) |
| 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
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.