fal | Glama

fal MCP Server

A Model Context Protocol (MCP) server for interacting with fal.ai models and services. This project was inspired by am0y's MCP server, but updated to use the latest streaming MCP support.

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
Full streaming support via HTTP transport

Requirements

Python 3.12+
fastmcp
httpx
aiofiles
A fal.ai API key

Installation

Clone this repository:

git clone https://github.com/derekalia/fal.git
cd fal

Install the required packages:

# Using uv (recommended)
uv sync

# Or using pip
pip install fastmcp httpx aiofiles

Usage

Running the Server Locally

Get your fal.ai API key from fal.ai
Start the MCP server with HTTP transport:

./run_http.sh YOUR_FAL_API_KEY

The server will start and display connection information in your terminal.

Connect to it from your LLM IDE (Claude Code or Cursor) by adding to your configuration:

{
  "Fal": {
    "url": "http://127.0.0.1:6274/mcp/"
  }
}

Development Mode (with MCP Inspector)

For testing and debugging, you can run the server in development mode:

fastmcp dev main.py

This will:

Start the server on a random port
Launch the MCP Inspector web interface in your browser
Allow you to test all tools interactively with a web UI

The Inspector URL will be displayed in the terminal (typically http://localhost:PORT).

Environment Variables

The run_http.sh script automatically handles all environment variables for you. If you need to customize:

PORT: Server port for HTTP transport (default: 6274)

Setting API Key Permanently

If you prefer to set your API key permanently instead of passing it each time:

Create a .env file in the project root:

echo 'FAL_KEY="YOUR_FAL_API_KEY_HERE"' > .env

Then run the server without the API key argument:

./run_http.sh

For manual setup:

FAL_KEY: Your fal.ai API key (required)
MCP_TRANSPORT: Transport mode - stdio (default) or http

Available 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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

MCP server for interacting with fal.ai models and services. Uses the latest streaming MCP support.

Related MCP Servers

MCP Simple OpenAI Assistant
andybrandt
-
security
A
license
-
quality
A simple MCP server for interacting with OpenAI assistants. This server allows other tools (like Claude Desktop) to create and interact with OpenAI assistants through the Model Context Protocol.
Last updated -
34
Python
MIT License
MCP Manager
samihalawa
-
security
F
license
-
quality
A flexible server that enables communication between AI models and tools, supporting multiple MCP servers and compatible with Claude, MCP Dockmaster, and other MCP clients.
Last updated -
32
1
TypeScript
OpenAI API MCP Server
ag2-mcp-servers
-
security
F
license
-
quality
An auto-generated MCP server that enables interaction with the OpenAI API, allowing users to access OpenAI's models and capabilities through the Multi-Agent Conversation Protocol.
Last updated -
Python
Outsource MCP
gwbischof
A
security
A
license
A
quality
An MCP server that enables AI applications to access 20+ model providers (including OpenAI, Anthropic, Google) through a unified interface for text and image generation.
Last updated -
2
13
Python
MIT License

View all related MCP servers