SeedDream 4.0 FAL

SeedDream 4.0 MCP Server provides image generation and editing capabilities through the SeedDream 4.0 model via the FAL AI platform. It enables you to generate high-quality images from prompts, with flexible sizing, safety checks, and batch options, all accessible through your MCP client.

How to use

You interact with the server by sending image generation requests through your MCP client. Choose between single-image generation or batch prompts. You can specify presets or exact dimensions, enable safety filtering, and control how many images you want per request. Use the prompts to describe your scene, and the server will return generated images along with useful metadata such as size, seed, and safety status.

Common usage patterns include creating a single high-detail image with a specific size, generating multiple variations from different prompts in one go, and performing batch operations to produce several images rapidly for comparison or selection. You can also enable sync_mode to receive immediate access to generated assets and set a seed for reproducible results.

How to install

Prerequisites you need before running the MCP server are as follows.

1. FAL AI API Key: Obtain an API key from FAL AI and keep it secure.

2. Node.js: Ensure Node.js is installed (version 16 or higher). You will use npm or npx to run the MCP server.

{
  "mcpServers": {
    "seedream4": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/PierrunoYT/seedream-v4-fal-mcp-server.git"
      ],
      "env": {
        "FAL_KEY": "your-fal-api-key-here"
      }
    }
  }
}

If you prefer a local installation, follow these steps to clone, install, and run the server directly.

# Clone the repository
git clone https://github.com/PierrunoYT/seedream-v4-fal-mcp-server.git
cd seedream-v4-fal-mcp-server

# Install dependencies
npm install

# Build the server
npm run build

# Run using the built index (absolute path required in your MCP settings)

To configure the local run in your MCP client, point to the built index script with the required environment variable.

{
  "mcpServers": {
    "seedream4": {
      "command": "node",
      "args": ["/absolute/path/to/seedream-v4-fal-mcp-server/build/index.js"],
      "env": {
        "FAL_KEY": "your-fal-api-key-here"
      }
    }
  }
}

Additional sections

Configuration details you provide in your MCP client determine how the server runs and what you receive in responses. The server supports single and batch image generation, with flexible image sizes including custom dimensions from 1024 to 4096 pixels. You can enable or disable the safety checker and control the number of images returned per request.

Environment variables include your FAL API key. Always keep this key secure and do not expose it in public configurations.

Image sizes you can use include presets such as square_1280, square_1024, square_1536, portrait_1024, portrait_1280, landscape_1024, landscape_1280, wide_1024, tall_1024, as well as custom dimensions specified as {width: number, height: number} within the 1024–4096 range.

Troubleshooting tips: ensure your FAL API key is valid and has credits, verify the absolute path in manual installations, and restart your MCP client after configuration changes. If a request fails, try a simpler prompt to confirm connectivity and check that the requested image size is within supported limits.

Notes on usage and safety

The server includes an optional safety checker to filter inappropriate content. You can enable or disable this feature per request as needed.

Available tools

generate_image

Generate a single image or multiple images from a text prompt. Supports presets and custom sizes, with optional safety checking and seed control.

generate_image_batch

Generate multiple images from an array of prompts in a single request with optional uniform image size and safety checking.