Skip to main content
Glama

ARCHIVED — This repository is no longer maintained. Issues and pull requests are closed.

npm version Node.js Version TypeScript License: MIT

fal.ai Image MCP Server

Generate images from text prompts using fal.ai and the Model Context Protocol (MCP). Integrates with AI IDEs like Cursor and Windsurf.

Features

  • Supports any valid fal.ai model and all major image parameters (size, inference steps, guidance scale, safety checker, batch of up to 5).

  • Saves images locally with accessible file paths.

  • Simple configuration and robust error handling.

Related MCP server: GIMP MCP

Quick Start

  1. Requirements: Node.js 18+, fal.ai API key

  2. Configure MCP:

    {
      "mcpServers": {
        "fal-ai-image": {
          "command": "npx",
          "args": ["-y", "mcp-fal-ai-image"],
          "env": { "FAL_KEY": "YOUR-FAL-AI-API-KEY" }
        }
      }
    }
  3. Run: Use the generate-image tool from your IDE.

Example Prompts

  • generate an image of a red apple

  • generate an image of a red apple using model fal-ai/kolors

  • generate 3 images of a glowing red apple in a futuristic city using model fal-ai/recraft-v3, square_hd, 40 inference steps, guidance scale 4.0, safety checker on

Supported parameters: prompt, model ID (any fal.ai model), number of images, image size, inference steps, guidance scale, safety checker.

Images are saved locally; file paths are shown in the response. For model IDs, see fal.ai/models.

Image Output

Generated images are saved to ~/Downloads/fal_ai by default (XDG-aware on Linux). Set FAL_IMAGES_OUTPUT_DIR to use a custom folder — images are saved to <your-folder>/fal_ai. The full file path for each image is included in the tool's response.

Troubleshooting

  • FAL_KEY is not set: Set your fal.ai API key as shown above.

  • Model errors: Double-check the model ID at fal.ai/models, or refer to the fal.ai API docs.

  • npx not found: Install Node.js 18+ and npm.

  • Other errors: Consult your MCP client logs.

Security

  • Your API key is used only locally to authenticate with fal.ai.

  • No user data is stored or transmitted except as required by the fal.ai API.

License

MIT License © 2025 Madhusudan Kulkarni

Available Tools

1 tool
generate-imageC

Generate an image from a text prompt using a selectable text-to-image model.

Inputs: prompt (required), model, image_size, num_images, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion or overlap between tools. The tool's purpose is clearly defined and distinct by default.

    Naming Consistency5/5

    A single tool inherently follows a consistent naming pattern. The tool name 'generate-image' uses a clear verb_noun format, which would be consistent if more tools were added.

    Tool Count2/5

    One tool is too few for a server named 'MCP fal.ai Image Server', which suggests a broader image-related domain. A single generation tool lacks coverage for expected operations like editing, upscaling, or listing models.

    Completeness2/5

    The server is severely incomplete for an image generation domain. It only provides image generation, missing essential operations such as image editing, model selection beyond 'selectable', or metadata retrieval, which limits agent workflows.

    Related MCP Connectors

    Related MCP Servers