fal.ai MCP Server
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., "@fal.ai MCP ServerGenerate an image of a cat using fal-ai/flux-schnell"
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.
fal.ai MCP Server
MCP server for interacting with the fal.ai API — run AI models, submit jobs, and manage media generation workflows from Claude or any MCP-compatible client.
Setup
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txtCreate a .env file with your API key (get one at fal.ai/dashboard/keys):
FAL_API_KEY=your-api-key-hereRelated MCP server: Fal.ai MCP Server
Running
# stdio (default, for Claude Desktop / MCP clients)
python fal_mcp.py
# HTTP transport
python fal_mcp.py --transport streamable_http --port 8000Claude Desktop Integration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"fal": {
"command": "/path/to/venv/bin/python",
"args": ["/path/to/fal_mcp.py"],
"env": { "FAL_API_KEY": "your-api-key-here" }
}
}
}Available Tools
Tool | Description |
| Browse available AI models and apps |
| Get schema and details for a specific app |
| Queue a job with input parameters |
| Check job status (QUEUED / IN_PROGRESS / COMPLETED / FAILED) |
| Retrieve output from a completed job |
| Cancel a queued or in-progress job |
| List jobs in an application's queue |
| Get execution logs for a job |
| Submit multiple jobs in parallel |
| View subscription and credit balance |
| View usage over the last N days |
Typical Workflow
list_applications (search: "image")
→ submit_job (application_id, input_data)
→ poll_job_status (request_id) [repeat until COMPLETED]
→ get_job_result (request_id)Project Structure
fal_mcp.py # MCP server + tool definitions
fal_api_client.py # HTTP client for fal.ai API
models.py # Pydantic input/output models
requirements.txt # DependenciesEnvironment Variables
Variable | Required | Default |
| Yes | — |
| No |
|
This server cannot be deployed
Maintenance
Related MCP Connectors
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
- QuallaaOAuthcom.quallaa
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
MCP server for Flux AI image generation
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for interacting with fal.ai models and services. Uses the latest streaming MCP support.82MIT
- AlicenseAqualityDmaintenanceEnables Claude Desktop and other MCP clients to generate images, videos, music, and audio using Fal.ai models. Supports text-to-image generation, video creation, music composition, text-to-speech, audio transcription, and image enhancement through natural language prompts.1856MIT
- FlicenseAqualityDmaintenanceAn MCP server that exposes Fal.ai generative media models as tools for image and video generation, and running any Fal.ai model, callable by Claude and other MCP-compatible clients.3-
- AlicenseNot gradedqualityDmaintenanceAn MCP server to use the fal.ai APIs to generate images and videos.4MIT