Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Server port for HTTP transport | 6274 |
| FAL_KEY | Yes | Your fal.ai API key | |
| MCP_TRANSPORT | No | Transport mode - stdio (default) or http | stdio |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| models | List available models on fal.ai. Ensure to use the total and page arguments. Avoid listing all the models at once.
Args:
page: The page number of models to retrieve (pagination)
total: The total number of models to retrieve per page
Returns:
A list of models with their metadata
|
| search | Search for models on fal.ai based on keywords.
Args:
keywords: The search terms to find models
Returns:
A list of models matching the search criteria
|
| schema | Get the OpenAPI schema for a specific model.
Args:
model_id: The ID of the model (e.g., "fal-ai/flux/dev")
Returns:
The OpenAPI schema for the model
|
| generate | Generate content using a fal.ai model.
Args:
model: The model ID to use (e.g., "fal-ai/flux/dev")
parameters: Model-specific parameters as a dictionary
queue: Whether to use the queuing system (default: False)
Returns:
The model's response
|
| result | Get the result of a queued request.
Args:
url: The response_url from a queued request
Returns:
The generation result
|
| status | Check the status of a queued request.
Args:
url: The status_url from a queued request
Returns:
The current status of the queued request
|
| cancel | Cancel a queued request.
Args:
url: The cancel_url from a queued request
Returns:
The result of the cancellation attempt
|
| upload | Upload a file to fal.ai storage.
Args:
path: The absolute path to the file to upload
Returns:
Information about the uploaded file, including the file_url
|
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |