data
fal.ai MCP, CLI, and Lua Integration for AI Agents
fal.ai integration docs for AI agents: MCP gateway setup, fal.ai CLI commands, Lua API reference, credentials, and function schemas.fal.ai for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Agent Surfaces
Machine-Readable Metadata
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
fal.fal_list_models | Read read | 0 | List available fal.ai models. Returns model IDs, descriptions, and capabilities. |
fal.fal_submit_request | Write write | 3 | Submit a generation request to a fal.ai model. Returns the request ID for tracking. Poll get_request_status for progress. |
fal.fal_get_request_status | Read read | 2 | Get the status of a submitted fal.ai request. Returns queue position and processing state. |
fal.fal_get_result | Read read | 2 | Get the result of a completed fal.ai request. Returns generated media URLs and metadata. |
fal.fal_list_files | Read read | 0 | List files stored in fal.ai storage. Returns file names, URLs, and metadata. |
fal.fal_upload_file | Write write | 2 | Upload a file to fal.ai storage for use as model input. Returns the file URL. |
fal.fal_get_current_user | Read read | 0 | Get current fal.ai user profile and account information. |