fal-nano-mcp

A minimal MCP server hardcoded to use Nano Banana 2 via Fal AI. It exposes exactly two tools:

• generate_image — text-to-image generation
• edit_image — image-to-image editing

No model selection, no routing — just Nano Banana 2.

Tools

generate_image

Generate images from text prompts.

Required: prompt (string)

Optional: num_images (1-4), aspect_ratio, output_format (jpeg/png/webp), resolution (0.5K/1K/2K/4K), seed, safety_tolerance (1-6), enable_web_search, thinking_level (minimal/high)

edit_image

Edit existing images with a text prompt.

Required: prompt (string), image_urls (array of URLs)

Optional: Same as generate_image

Setup

1. Get a Fal API Key

Sign up at fal.ai and create an API key.

2. Install

npm install -g fal-nano-mcp

3. Add to your MCP client

Claude Code (CLI)

claude mcp add fal-nano-mcp -e FAL_KEY=your-fal-api-key-here -- fal-nano-mcp

JSON config (Claude Code, Claude Desktop, Cursor, etc.)

Add to your MCP config file (e.g. ~/.claude/settings.json, claude_desktop_config.json, .cursor/mcp.json):

{
  "mcpServers": {
    "fal-nano-mcp": {
      "command": "fal-nano-mcp",
      "env": {
        "FAL_KEY": "your-fal-api-key-here"
      }
    }
  }
}

4. Verify

Restart your MCP client and the generate_image and edit_image tools should be available.

Usage Examples

Generate an image:

"Generate an image of a sunset over Jerusalem"

Edit an image:

"Edit this image to add a rainbow" (with image URL)

Pricing

~$0.08 per image at 1K resolution. 2K and 4K cost 1.5x and 2x respectively. See fal.ai pricing.

License

MIT