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

Related MCP server: Nano-Banana MCP Server

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