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

$3

``bash
npm install -g fal-mcp-server
`

$3

`bash
git clone https://github.com/yourusername/fal-mcp-server.git
cd fal-mcp-server
npm install
npm run build
npm link
`

Setup

$3

Sign up at fal.ai and get your API key from the dashboard.

$3

`bash
claude mcp add fal --env "FAL_KEY=your-api-key-here" -- npx -y fal-mcp-server
`

$3

`bash
claude mcp list
`

You should see:
`
fal: npx -y fal-mcp-server - ✓ Connected
`

Available Tools

$3

Generate images using any Fal.ai model.

Parameters:
- prompt (required): Text description of the image
- model: Model ID (default: "fal-ai/flux/schnell")
- image_size: "square", "landscape_4_3", or "portrait_3_4"
- num_images: 1-4 images
- seed: For reproducible generation

Example:
`javascript
{
"prompt": "a cyberpunk cat in neon city",
"model": "fal-ai/flux/dev",
"image_size": "landscape_4_3",
"num_images": 2
}
`

$3

Run any Fal.ai model with custom parameters.

Parameters:
- model_id (required): The model endpoint ID
- input (required): Model-specific input parameters
- stream: Enable streaming for real-time updates

Example:
`javascript
{
"model_id": "fal-ai/stable-diffusion-v3-medium",
"input": {
"prompt": "professional portrait photo",
"negative_prompt": "low quality, blurry"
}
}
`

$3

Execute Fal.ai workflows (multi-step pipelines).

Parameters:
- workflow_id (required): The workflow ID
- input (required): Workflow input parameters
- stream: Stream workflow events

Example:
`javascript
{
"workflow_id": "workflows/fal-ai/sdxl-sticker",
"input": {
"prompt": "cute puppy mascot"
}
}
`

$3

Get a list of popular Fal.ai models.

$3

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

`bash


Install dependencies

npm install

Build TypeScript

npm run build

Watch mode for development

npm run watch

Run locally

FAL_KEY=your-key node dist/index.js
``

License

MIT

Contributing

Contributions welcome! Please submit PRs to improve the server.

Support

- Fal.ai Documentation
- MCP Documentation
- GitHub Issues