Frequently Asked Questions (FAQ) about FAL Image/Video MCP Server

Q: What is the FAL Image/Video MCP Server?

A: The FAL Image/Video MCP Server is a high-performance server that bridges the gap between FAL AI’s image and video generation capabilities and MCP-compatible clients like Claude Desktop. It automates the process of generating, downloading, and accessing AI-generated content.

Q: What is MCP?

A: MCP stands for Model Context Protocol. It’s an open protocol that standardizes how applications provide context to Large Language Models (LLMs), enabling AI models to interact with external data sources and tools.

Q: How do I get a FAL API key?

A: Visit fal.ai, create an account, and navigate to the API keys section to generate a new key.

Q: How do I install the FAL Image/Video MCP Server for Claude Desktop?

A: Add the server configuration to your Claude Desktop’s claude_desktop_config.json file (located in the appropriate application support directory for your operating system), replacing YOUR-FAL-AI-API-KEY with your actual FAL API key, and restart Claude Desktop.

Q: Where are the generated images and videos saved?

A: By default, generated images are saved as .jpg files and videos as .mp4 files in your ~/Downloads folder. You can customize the download directory using the DOWNLOAD_PATH environment variable.

Q: What image and video generation models are available?

A: The server dynamically loads models from FAL AI, including popular options like Imagen 4, FLUX Kontext Pro, Ideogram V3 for image generation, and Veo 3, Kling 2.1 Master, Pixverse V4.5 for video generation. A full list is available using the list_available_models tool.

Q: Can I use my own FAL models with this server?

A: Yes! The server supports universal model execution, allowing you to run ANY FAL endpoint beyond the curated registry using the execute_custom_model tool.

Q: What is the difference between public URLs and data URLs?

A: Public URLs are direct links to the generated content, while data URLs are Base64-encoded data URLs for direct embedding. Data URLs are disabled by default for Claude Desktop optimization.

Q: Can I disable automatic file opening?

A: Yes, you can disable automatic file opening by setting the AUTOOPEN environment variable to false.

Q: What transport protocols are supported?

A: The server supports stdio (for Claude Desktop) and HTTP/SSE (for Smithery/Web) transport protocols.

Q: How can I run the server in HTTP mode?

A: Use the command npx -y fal-image-video-mcp --http to start the server in HTTP mode.

Q: Does the server require an API key to start?

A: No, the server supports lazy authentication. It can start without a FAL_KEY for tool discovery. The API key is only validated when tools are invoked.

Q: How does this integrate with UBOS?

A: The FAL Image/Video MCP Server integrates seamlessly with the UBOS platform, allowing you to orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model, and create Multi-Agent Systems to enhance AI-driven creativity and productivity.