# Mcp Fal Ai Image

> MCP server from madhusudan-kulkarni/mcp-fal-ai-image.

- **Type:** MCP server
- **Install:** `agentstack add mcp-madhusudan-kulkarni-mcp-fal-ai-image`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [madhusudan-kulkarni](https://agentstack.voostack.com/s/madhusudan-kulkarni)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [madhusudan-kulkarni](https://github.com/madhusudan-kulkarni)
- **Source:** https://github.com/madhusudan-kulkarni/mcp-fal-ai-image
- **Website:** https://www.npmjs.com/package/mcp-fal-ai-image

## Install

```sh
agentstack add mcp-madhusudan-kulkarni-mcp-fal-ai-image
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

[](https://mseep.ai/app/madhusudan-kulkarni-mcp-fal-ai-image)

[](https://www.npmjs.com/package/mcp-fal-ai-image) [](https://nodejs.org/) [](https://www.typescriptlang.org/) [](LICENSE)

# MCP fal.ai Image Server

Effortlessly generate images from text prompts using [fal.ai](https://fal.ai) and the Model Context Protocol (MCP). Integrates directly with AI IDEs like Cursor and Windsurf.

## When and Why to Use

This tool is designed for:
- Developers and designers who want to generate images from text prompts without leaving their IDE.
- Rapid prototyping of UI concepts, marketing assets, or creative ideas.
- Content creators needing unique visuals for blogs, presentations, or social media.
- AI researchers and tinkerers experimenting with the latest fal.ai models.
- Automating workflows that require programmatic image generation via MCP.

Key features:
- Supports any valid fal.ai model and all major image parameters.
- Works out of the box with Node.js and a fal.ai API key.
- Saves images locally with accessible file paths.
- Simple configuration and robust error handling.

## Quick Start

1. **Requirements:** Node.js 18+, [fal.ai API key](https://fal.ai)
2. **Configure MCP:**
   ```json
   {
     "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.

> **💡 Typical Workflow:**
> Describe the image you want (e.g., “generate a landscape with flying cars using model fal-ai/kolors, 2 images, landscape_16_9”) and get instant results in 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](https://fal.ai/models).

## Troubleshooting

- `FAL_KEY environment variable is not set`: Set your fal.ai API key as above.
- `npx` not found: Install Node.js 18+ and npm.

Advanced: Example MCP Request/Response

```json
{
  "tool": "generate-image",
  "args": {
    "prompt": "A futuristic cityscape at sunset",
    "model": "fal-ai/kolors"
  }
}

// Example response
{
  "images": [
    { "url": "file:///path/to/generated_image1.png" },
    { "url": "file:///path/to/generated_image2.png" }
  ]
}
```

## 📁 Image Output Directory

Generated images are saved to your local system:

- **By default:** `~/Downloads/fal_ai` (on Linux/macOS; uses XDG standard if available)
- **Custom location:** Set the environment variable `FAL_IMAGES_OUTPUT_DIR` to your desired folder. Images will be saved in `/fal_ai`.

The full file path for each image is included in the tool's response.

## ⚠️ Error Handling & Troubleshooting

- If you specify a model ID that is not supported by fal.ai, you will receive an error from the backend. Double-check for typos or visit [fal.ai/models](https://fal.ai/models) to confirm the model ID.
- For the latest list of models and their capabilities, refer to the [fal.ai model catalog](https://fal.ai/models) or [API docs](https://fal.ai/docs/api).
- For other errors, consult your MCP client logs or open an issue on GitHub.

## 🤝 Contributing

Contributions and suggestions are welcome! Please open issues or pull requests on [GitHub](https://github.com/madhusudan-kulkarni/mcp-fal-ai-image).

## 🔒 Security

- Your API key is only used locally to authenticate with fal.ai.
- No user data is stored or transmitted except as required by fal.ai API.

## 🔗 Links

- [NPM](https://www.npmjs.com/package/mcp-fal-ai-image)
- [GitHub](https://github.com/madhusudan-kulkarni/mcp-fal-ai-image)
- [fal.ai](https://fal.ai)

## 🛡 License

MIT License © 2025 Madhusudan Kulkarni

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [madhusudan-kulkarni](https://github.com/madhusudan-kulkarni)
- **Source:** [madhusudan-kulkarni/mcp-fal-ai-image](https://github.com/madhusudan-kulkarni/mcp-fal-ai-image)
- **License:** MIT
- **Homepage:** https://www.npmjs.com/package/mcp-fal-ai-image

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-madhusudan-kulkarni-mcp-fal-ai-image
- Seller: https://agentstack.voostack.com/s/madhusudan-kulkarni
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.