Fal Ideogram

You run this MCP server to access the fal-ai/ideogram/v3 image generation model. It lets you generate high-quality images with advanced text rendering through the fal.ai platform, with options for synchronous or queued generation, style control, reference images, and webhook notifications.

How to use

Use this MCP server with your MCP client to generate images from the fal-ai/ideogram/v3 model. You can submit quick synchronous requests or place long-running jobs in a queue and check status or download results. Configure your client to pass the same parameters you’d use in the standard API, such as prompts, image size, style, color palettes, reference images, and optional webhook notifications for completed jobs.

How to install

# Prerequisites
- Node.js installed (recommended LTS)
- npm available

# 1) Clone the MCP server repository
git clone https://github.com/PierrunoYT/fal-ideogram-v3-mcp-server.git
cd fal-ideogram-v3-mcp-server

# 2) Install dependencies
npm install

# 3) Build the project
npm run build

# 4) Run in development mode (optional)
npm run dev

Configuration and usage notes

Set your fal.ai API key as an environment variable to authorize requests to fal.ai.

export FAL_KEY="your_fal_api_key_here"

MCP client configuration options

You can integrate this MCP server with your MCP client by providing either a remote MCP URL via npx or by running the server locally with Node.

# Remote MCP via npx (example, from client config)
{
  "mcpServers": {
    "fal_ideogram_v3": {
      "command": "npx",
      "args": ["-y", "https://github.com/PierrunoYT/fal-ideogram-v3-mcp-server.git"],
      "env": {
        "FAL_KEY": "your_fal_api_key_here"
      }
    }
  }
}

Local runtime command

# If you clone the repo and build, run the server locally with Node
node fal-ideogram-v3-mcp-server/build/index.js

Environment variables

The server requires your fal.ai API key to authorize image generation requests.

export FAL_KEY="your_fal_api_key_here"

Usage with queueing and webhooks

You can submit long-running image generation tasks to a queue and optionally receive webhook notifications when they complete. Use a queue submission that returns a request ID, then poll for status or fetch results once done.

# Example: queue submission parameters would include similar fields to synchronous requests plus webhook_url
{
  "prompt": "A detailed architectural drawing of a futuristic building",
  "webhook_url": "https://your-server.com/webhook"
}

Available tools

ideogram_v3_generate

Generate images synchronously with a prompt and optional parameters such as image size, style, color palette, and reference images.

ideogram_v3_generate_queue

Submit a long-running image generation request to the queue and receive a job ID for tracking.

ideogram_v3_queue_status

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

ideogram_v3_queue_result

Retrieve the results of a completed queued request.