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

• Python 3.10+

• fastmcp

• httpx

• aiofiles

• A fal.ai API key

Installation

1. Clone this repository:

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

2. Install the required packages:

pip install fastmcp httpx aiofiles

3. Set your fal.ai API key as an environment variable:

export FAL_KEY="YOUR_FAL_API_KEY_HERE"

Usage

Running the Server

You can run the server in development mode with:

fastmcp dev main.py

This will launch the MCP Inspector web interface where you can test the tools interactively.

Installing in Claude Desktop

To use the server with Claude Desktop:

fastmcp install main.py -e FAL_KEY="YOUR_FAL_API_KEY_HERE"

This will make the server available to Claude in the Desktop app.

Running Directly

You can also run the server directly:

python main.py

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