/ Directory / Playground / Fal.ai MCP
● Community raveenb ⚡ Instant

Fal.ai MCP

by raveenb · raveenb/fal-mcp-server

Generate images, video, music, and audio through Fal.ai models.

Fal.ai hosts hundreds of generative models behind a single API — Flux, SDXL, Kling, Veo, MusicGen, ElevenLabs voices, etc. This MCP gives Claude one tool surface for image, video, audio, and TTS generation without juggling provider SDKs.

Why use it

Key features

Live Demo

What it looks like in practice

fal-mcp.replay ▶ ready
0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "fal-mcp": {
      "command": "uvx",
      "args": [
        "fal-mcp-server"
      ]
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "fal-mcp": {
      "command": "uvx",
      "args": [
        "fal-mcp-server"
      ]
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "fal-mcp": {
      "command": "uvx",
      "args": [
        "fal-mcp-server"
      ]
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "fal-mcp": {
      "command": "uvx",
      "args": [
        "fal-mcp-server"
      ]
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "fal-mcp",
      "command": "uvx",
      "args": [
        "fal-mcp-server"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "fal-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "fal-mcp-server"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add fal-mcp -- uvx fal-mcp-server

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use Fal.ai MCP

Turn a script into a narrated short with one prompt

👤 Marketers, indie creators ⏱ ~15 min intermediate

When to use: You have a 30-second script and want a complete narrated short.

Prerequisites
  • Server/skill installed and authenticated — See repo README
Flow
  1. Generate the scenes
    Split this 30s script into 4 scenes and generate a video clip for each with Kling.✓ Copied
    → Four video URLs
  2. Narrate it
    TTS each scene's narration with ElevenLabs Rachel voice.✓ Copied
    → Audio URLs aligned with scenes

Outcome: Four video clips + matching narration audio, ready to stitch.

Pitfalls
  • Costs add up fast — Costs add up fast — set a hard budget in the prompt: 'Use the cheapest model that meets quality bar' and check the balance reported in tool output.
Combine with: filesystem

Combinations

Pair with other MCPs for X10 leverage

fal-mcp + filesystem

Pair with filesystem for complementary capabilities

Use this server together with filesystem to complete a multi-step task.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
generate_image prompt, model, aspect_ratio Need a still image $0.003–0.05 per image
generate_video prompt, model, duration_s Need a short video clip $0.20–2.00 per clip
tts text, voice, model Produce narration audio $0.0001 per char

Cost & Limits

What this costs to run

API quota
See provider docs for rate limits
Tokens per call
Varies by tool
Monetary
See repo README for pricing details
Tip
Cache tool results and avoid repeated identical calls.

Security

Permissions, secrets, blast radius

Credential storage: Use environment variables; never commit secrets
Data egress: Tool calls go to the provider's API as documented

Troubleshooting

Common errors and fixes

FAL_KEY missing

Get a key at fal.ai/dashboard/keys and set FAL_KEY env var.

Verify: Run generate_image once with a tiny prompt
insufficient balance

Top up at fal.ai/dashboard/billing. The error includes the required amount.

Verify: Check fal.ai/dashboard

Alternatives

Fal.ai MCP vs others

AlternativeWhen to use it insteadTradeoff
Replicate MCPYou want different model selectionDifferent per-model pricing; similar feature set

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills