Can I use fal.ai as a CLI?

Yes. KosmoKrator exposes a fal.ai CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose fal.ai through MCP?

Yes. The KosmoKrator MCP gateway can expose selected fal.ai tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are fal.ai credentials stored?

fal.ai credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for fal.ai MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

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.

7 functions 5 read 2 write API key auth

Submit fal.ai feedback View package source

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.

Machine-Readable Metadata

integration_slug: fal
route_slug: fal
package: fal
auth_strategy: api_key API key
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. fal.ai CLIHeadless setup and direct function calls. fal.ai MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

fal.ai MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for fal.ai.

Claude Code fal.ai MCP setup for Claude Code. Cursor fal.ai MCP setup for Cursor. Codex fal.ai MCP setup for Codex. OpenAI Agents fal.ai MCP setup for OpenAI Agents SDK. Claude Agent SDK fal.ai MCP setup for Claude Agent SDK. Vercel AI SDK fal.ai MCP setup for Vercel AI SDK. LangChain fal.ai MCP setup for LangChain. LangGraph fal.ai MCP setup for LangGraph. CrewAI fal.ai MCP setup for CrewAI. MCP clients fal.ai MCP setup for Generic MCP Clients.

fal.ai CLI Matrix

Use these pages for direct fal.ai CLI workflows in scripts, CI, cron, and agent wrappers.

CI fal.ai CLI for CI. Cron Jobs fal.ai CLI for cron jobs. Shell Scripts fal.ai CLI for shell scripts. Headless Automation fal.ai CLI for headless automation. Coding Agents fal.ai CLI for coding agents.

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.