fal.ai MCP Server

A Model Context Protocol (MCP) server for interacting with fal.ai models and services.

Features

• List all available fal.ai models
• Search for specific models by keywords
• Get model schemas
• Generate content using any fal.ai model
• Support for both direct and queued model execution
• Queue management (status checking, getting results, cancelling requests)
• File upload to fal.ai CDN

Requirements

• uv
• A fal.ai API key

Installing in Claude Desktop

1. Clone this repository:

git clone https://github.com/am0y/mcp-fal.git
cd mcp-fal

2. Run the install command from the repo folder:

claude mcp add mcp-fal -s user --env FAL_KEY='<api-key>' -- uv run --directory "$PWD" fastmcp run main.py

If you don't run the command from the git repo folder, replace the '$PWD' with the absolute path to that folder.

API Reference

Tools

• models(page=None, total=None) - List available models with optional pagination
• search(keywords) - Search for models by keywords
• schema(model_id) - Get OpenAPI schema for a specific model
• generate(model, parameters, queue=False) - Generate content using a model
• result(url) - Get result from a queued request
• status(url) - Check status of a queued request
• cancel(url) - Cancel a queued request
• upload(path - Upload a file to fal.ai CDN

License

MIT