Provides access to Fal.ai's image generation platform with 600+ AI models including Flux and Stable Diffusion, enabling image generation, workflow execution, and real-time progress tracking for AI-powered visual content creation.
Fal.ai MCP Server
An MCP (Model Context Protocol) server that provides seamless integration with Fal.ai's image generation models and workflows.
Features
- 🎨 Image Generation - Access 600+ Fal.ai models including Flux, Stable Diffusion, and more
- 🔄 Workflow Support - Run pre-built pipelines like sdxl-sticker
- 🚀 Streaming - Real-time progress updates for long-running operations
- 📦 Simple API - Unified interface for all models and workflows
- ⚡ Queue Management - Built-in status tracking for async operations
Installation
Quick Install (npm)
From Source
Setup
1. Get your Fal.ai API Key
Sign up at fal.ai and get your API key from the dashboard.
2. Add to Claude Code
3. Verify Connection
You should see:
Available Tools
generate_image
Generate images using any Fal.ai model.
Parameters:
prompt
(required): Text description of the imagemodel
: Model ID (default: "fal-ai/flux/schnell")image_size
: "square", "landscape_4_3", or "portrait_3_4"num_images
: 1-4 imagesseed
: For reproducible generation
Example:
run_model
Run any Fal.ai model with custom parameters.
Parameters:
model_id
(required): The model endpoint IDinput
(required): Model-specific input parametersstream
: Enable streaming for real-time updates
Example:
run_workflow
Execute Fal.ai workflows (multi-step pipelines).
Parameters:
workflow_id
(required): The workflow IDinput
(required): Workflow input parametersstream
: Stream workflow events
Example:
list_popular_models
Get a list of popular Fal.ai models.
check_status
Check the status of an async request.
Parameters:
request_id
(required): The request ID to check
Popular Models
- fal-ai/flux/schnell - Fastest Flux model (4 steps)
- fal-ai/flux/dev - High quality Flux model
- fal-ai/flux-pro - Professional Flux model
- fal-ai/fast-sdxl - Fast Stable Diffusion XL
- fal-ai/stable-diffusion-v3-medium - Latest SD3
- fal-ai/recraft-v3 - Artistic style generation
Workflows
- workflows/fal-ai/sdxl-sticker - Generate → Remove BG → Sticker
Usage in Claude Code
Once installed, you can use natural language to interact with Fal.ai:
- "Generate a cyberpunk cityscape using Flux"
- "Create a sticker of a cute robot"
- "Run the sdxl-sticker workflow with a puppy prompt"
- "List available image models"
Environment Variables
FAL_KEY
(required): Your Fal.ai API key
Development
License
MIT
Contributing
Contributions welcome! Please submit PRs to improve the server.
Support
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables seamless integration with Fal.ai's 600+ image generation models including Flux and Stable Diffusion. Supports real-time streaming, workflow execution, and unified access to AI image generation through natural language.