simple-fal-mcp

Model Context Protocol (MCP) server for Codex and Claude Code with fal model discovery, execution, pricing, request follow-up, temp workspaces, and local media post-process.

Current scope:

• normal fal model endpoints only
• queue and sync execution
• image, video, and audio generation workflows
• local temp workspace management and media finishing
• no realtime/websocket flows in v1

• fal_status: always available; returns config/auth/capability state, setup-web state, media availability, saved cursors, and workspace summary.
• fal_setup_web: local setup panel controller with actions status, start, stop.
• fal_model: model discovery tool with actions search, next, get, pricing, estimate.
• fal_cost: pricing/cost tool with actions price, estimate, usage, usage_next, request.
• fal_run: submits one model run, supports local-file uploads, and saves request state in a temp workspace.
• fal_request: request follow-up tool with actions status, wait, result, materialize, cancel, history, history_next.
• fal_workspace: local workspace manager with actions list, get, delete, cleanup.
• fal_media: local media tool with actions inspect, open, reveal, image_convert, image_resize, video_convert, video_trim, video_reverse, video_concat, image_sequence_to_video, extract_frame, mux_audio, audio_convert, audio_reverse, audio_concat.

Quick flow examples:

• fal_model({ "action": "search", "query": "kling image to video" })
• fal_model({ "action": "get", "endpointId": "fal-ai/kling-video/o1/standard/image-to-video", "schemaMode": "summary" })
• fal_run({ "endpointId": "fal-ai/nano-banana-2", "input": { "prompt": "..." } })
• fal_request({ "action": "wait", "runId": "..." })
• `fal_media({ "action": "image_resize", "workspaceId": "...", "inputPath": "runs/.../artifacts/01-images-0.png", "width": 1280,