A Model Context Protocol (MCP) server for generating images using Fal.ai's HiDream-I1-Full model
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"fal-ai-mcp-2","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# FAL AI Image Generator MCP A Model Context Protocol (MCP) server for generating images using the FAL.ai platform and HiDream-ai/HiDream-I1-Full model. ## Quick Start 1. **Get a FAL.ai API Key** - Sign up at [FAL.ai](https://www.fal.ai) and obtain your API key 2. **Install the package** ```bash # Using pip pip install fal-ai-mcp # Using uv uv pip install fal-ai-mcp ``` 3. **Run and Test the server** ```bash # Using Python module export FAL_KEY="your-fal-api-key" && npx @modelcontextprotocol/inspector -- python -m fal_ai_mcp # Using uvx (alternative method) export FAL_KEY="your-fal-api-key" && npx @modelcontextprotocol/inspector uvx fal-ai-mcp ``` ## Configure in Claude Desktop, Cursor or Windsurf Add this configuration to your MCP config file: #### Method 1: Using uvx ```json { "mcpServers": { "fal-ai-image-generator": { "command": "uvx", "args": [ "fal-ai-mcp" ], "env": { "FAL_KEY": "your-fal-api-key" } } } } ``` #### Method 2: Using Python module ```json { "mcpServers": { "fal-ai-image-generator": { "command": "python", "args": ["-m", "fal_ai_mcp"], "env": { "FAL_KEY": "your-fal-api-key" } } } } ``` ## Features This MCP server provides a tool for generating high-quality images from text prompts using FAL.ai platform: - Text-to-image generation using the `text_to_image_fal` tool - Returns complete metadata including image URL or base64 image data, dimensions, and other information - Easy integration with MCP-compatible applications ## API Reference ### `text_to_image_fal` Generates an image from a text prompt using the FAL.ai API and HiDream-I1-Full model. **Parameters:** - `prompt` (string): The text description of the image you want to generate **Returns:** - A dictionary containing the generated image data, including: - `images`: Array of generated images with URLs, dimensions, and content type - `timings`: Performance metrics - `s…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.