Skip to main content
Glama

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 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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/guillaumeboniface/fal-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server