Fal Minimax Image 01

Provides an MCP server for fal-ai/minimax/image-01 with queueing, prompt optimization, and local image download.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pierrunoyt-fal-minimax-image-01-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/PierrunoYT/fal-minimax-image-01-mcp-server.git"
      ],
      "env": {
        "FAL_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can run an MCP server that exposes the fal-ai/minimax/image-01 image generation model, enabling you to generate high‑quality images through MiniMax technology with queueing, prompt optimization, and local downloads. This guide shows you how to use the server with an MCP client, how to install and run it locally, and how to configure access and options.

How to use

Start by adding the server to your MCP client configuration using one of the supported local execution methods. You can run the server directly from a local clone or use a package runner to fetch and execute it on demand. Once configured, you can submit image generation requests with prompts, choose an aspect ratio, and optionally enable prompt optimization. For long-running tasks, use the queueing endpoint and optionally receive webhook notifications when results are ready. The server downloads generated images to your local storage automatically, and you can review the generated results along with the generation parameters and request IDs.

Examples of typical workflows

Generate a single image synchronously with a detailed prompt and a chosen aspect ratio.
Submit a long-running generation to the queue and monitor its status until completion.

Available tools

minimax_generate

Generate images synchronously using a text prompt, with options for aspect_ratio, num_images, and prompt_optimizer to improve results.

minimax_generate_queue

Submit a long-running image generation request to the queue with optional webhook notifications; receive a request ID for tracking.

minimax_queue_status

Check the status of a queued request using the provided request_id and optionally include logs in the response.

minimax_queue_result

Retrieve the result of a completed queued request using the request_id.