MCP fal.ai Image Server
With this MCP fal.ai Image Server, you can:
Generate images from text prompts using the
generate-imagetool with any valid fal.ai model ID (default:fal-ai/recraft-v3).Customize parameters:
model,image_size(square_hd,square,portrait_4_3,portrait_16_9,landscape_4_3,landscape_16_9; defaultlandscape_4_3),num_images(up to 5),guidance_scale(default 3.5),num_inference_steps(default 28), andenable_safety_checker(default true).Save images locally to
~/Downloads/fal_aiby default or a custom directory viaFAL_IMAGES_OUTPUT_DIR, with full file paths returned.Integrate with MCP-compatible IDEs such as Cursor and Windsurf (configured via
npxandFAL_KEY).Receive robust error messages for common issues like missing API key, model errors, or missing npx.
Click on "Deploy 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., "@MCP fal.ai Image Server generate a logo for a coffee shop using model fal-ai/kolors"
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.
ARCHIVED — This repository is no longer maintained. Issues and pull requests are closed.
fal.ai Image MCP Server
Generate images from text prompts using fal.ai and the Model Context Protocol (MCP). Integrates with AI IDEs like Cursor and Windsurf.
Features
Supports any valid fal.ai model and all major image parameters (size, inference steps, guidance scale, safety checker, batch of up to 5).
Saves images locally with accessible file paths.
Simple configuration and robust error handling.
Related MCP server: GIMP MCP
Quick Start
Requirements: Node.js 18+, fal.ai API key
Configure MCP:
{ "mcpServers": { "fal-ai-image": { "command": "npx", "args": ["-y", "mcp-fal-ai-image"], "env": { "FAL_KEY": "YOUR-FAL-AI-API-KEY" } } } }Run: Use the
generate-imagetool from your IDE.
Example Prompts
generate an image of a red applegenerate an image of a red apple using model fal-ai/kolorsgenerate 3 images of a glowing red apple in a futuristic city using model fal-ai/recraft-v3, square_hd, 40 inference steps, guidance scale 4.0, safety checker on
Supported parameters: prompt, model ID (any fal.ai model), number of images, image size, inference steps, guidance scale, safety checker.
Images are saved locally; file paths are shown in the response. For model IDs, see fal.ai/models.
Image Output
Generated images are saved to ~/Downloads/fal_ai by default (XDG-aware on Linux). Set FAL_IMAGES_OUTPUT_DIR to use a custom folder — images are saved to <your-folder>/fal_ai. The full file path for each image is included in the tool's response.
Troubleshooting
FAL_KEYis not set: Set your fal.ai API key as shown above.Model errors: Double-check the model ID at fal.ai/models, or refer to the fal.ai API docs.
npxnot found: Install Node.js 18+ and npm.Other errors: Consult your MCP client logs.
Security
Your API key is used only locally to authenticate with fal.ai.
No user data is stored or transmitted except as required by the fal.ai API.
Links
License
MIT License © 2025 Madhusudan Kulkarni
Available Tools
1 toolgenerate-imageC
Generate an image from a text prompt using a selectable text-to-image model.
Inputs: prompt (required), model, image_size, num_images, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The tool's purpose is clearly defined and distinct by default.
A single tool inherently follows a consistent naming pattern. The tool name 'generate-image' uses a clear verb_noun format, which would be consistent if more tools were added.
One tool is too few for a server named 'MCP fal.ai Image Server', which suggests a broader image-related domain. A single generation tool lacks coverage for expected operations like editing, upscaling, or listing models.
The server is severely incomplete for an image generation domain. It only provides image generation, missing essential operations such as image editing, model selection beyond 'selectable', or metadata retrieval, which limits agent workflows.
Related MCP Connectors
Generate and edit images, video, audio and 3D with fal. Discover models and check prices.
Generate AI images, videos, music, SFX & speech in any AI assistant. Results appear inline in chat.
Create images and videos from prompts, with options for image mixing, reference images, and start/…
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
Related MCP Servers
- AlicenseBqualityFmaintenanceEnables 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.541 npmMIT
- FlicenseNot gradedqualityDmaintenanceGenerates images from text descriptions using Stable Diffusion AI, integrated with VS Code through Model Context Protocol. Supports both AI-powered realistic images and quick PIL-based sketches, with batch processing and animated GIF creation capabilities.-
- AlicenseNot gradedqualityNot gradedmaintenanceEnables high-quality text-to-image generation and image editing using FAL AI's Reve model. Supports batch processing, multiple aspect ratios and formats, with automatic local image downloads and both real-time and async processing modes.1-
- AlicenseNot gradedqualityNot gradedmaintenanceEnables high-quality AI image generation using the fal-ai/hidream-i1-full model with support for synchronous, streaming, and queue-based generation, custom image sizing, LoRA weights, and automatic local image downloads.-