How to add Fal.ai MCP Server to Windsurf

Community server for image, video, music, and audio generation across fal.ai models. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 49★ · stdio · apikey

Windsurf config for Fal.ai MCP Server

uvx --from fal-mcp-server fal-mcp

{
  "mcpServers": {
    "fal-ai-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "fal-mcp-server",
        "fal-mcp"
      ],
      "env": {
        "FAL_KEY": "<your-fal-api-key>"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Fal.ai MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Fal.ai MCP Server's tools become available to Cascade.

Before you start

Python 3.10 or higher (or Docker, or the `uv`/`uvx` package manager for zero-install)
A fal.ai API key set as the FAL_KEY environment variable (get it from your fal.ai dashboard; a free tier is available)
An MCP client such as Claude Desktop; HTTP/SSE mode additionally needs `mcp-remote` or a compatible web client

What Fal.ai MCP Server can do in Windsurf

generate_image

Generate an image from a text prompt across fal.ai image models.

generate_image_structured

Generate an image with structured/controlled parameters.

generate_image_from_image

Image-to-image generation from a source image and prompt.

remove_background

Remove the background from an input image.

upscale_image

Upscale an image to higher resolution.

edit_image

Edit an existing image via prompt-driven changes.

inpaint_image

Inpaint masked regions of an image.

resize_image

Resize an image to target dimensions.

Security

The FAL_KEY bills generation usage to your fal.ai account and can invoke many third-party models; set spend controls and keep the key in env. Generated media may be downloaded locally depending on the model used.

Fal.ai MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Fal.ai MCP Server config there under the "mcpServers" key and restart the client.

Is Fal.ai MCP Server safe to use with Windsurf?

Where do I get the API key?

Sign up at fal.ai and copy your API key from the dashboard, then set it as the FAL_KEY environment variable. A free tier is available to start.

Do I need Node.js?

No, the server is Python (3.10+). You can run it with uvx, pip, or Docker; only the HTTP-via-Docker config example uses npx mcp-remote as the bridge.

Can it do video and music, not just images?

Yes. It exposes generate_video, generate_video_from_image, generate_video_from_video, and generate_music alongside the image tools.

View repo Full Fal.ai MCP Server page