# AI Watercolor Generator

This MCP server creates watercolor images from text and turns local JPEG, PNG, or WebP files into watercolor paintings.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: AIWatercolorGenerator
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AIWatercolorGenerator/ai-watercolor-generator-mcp
- Updated: 2026-09-17
- HTML: https://affpapa.org/en/nevibecode/mcp/ai-watercolor-generator

## What it does

The server exposes four tools to an agent. `generate_watercolor` starts an image from a text prompt, `upload_watercolor_input` accepts a local file, `edit_watercolor` submits an uploaded image for processing, and `get_watercolor_task` reads task status, output, or failure details. Generation and editing run asynchronously, so the task must be checked every 2–5 seconds after submission.

The package runs as a local stdio server through `npx`; processing, storage, credits, and limits stay on the hosted API. It requires Node.js 20 or newer, an `AIWATERCOLOR_API_KEY`, and account credits. Without Node.js 20, the server will not start. When you upload an image, the file is sent to hosted storage, so review the path before approving the tool call.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://www.aiwatercolorgenerator.com/api/mcp`
- Environment variables: `AIWATERCOLOR_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add watercolor -e AIWATERCOLOR_API_KEY=<AIWATERCOLOR_API_KEY> -- npx -y @ai-watercolor-generator/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http ai-watercolor-generator https://www.aiwatercolorgenerator.com/api/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add ai-watercolor-generator --url https://www.aiwatercolorgenerator.com/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add ai-watercolor-generator --env AIWATERCOLOR_API_KEY=<AIWATERCOLOR_API_KEY> -- npx -y @ai-watercolor-generator/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ai-watercolor-generator": {
            "url": "https://www.aiwatercolorgenerator.com/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ai-watercolor-generator": {
            "command": "npx",
            "args": [
                "-y",
                "@ai-watercolor-generator/mcp"
            ],
            "env": {
                "AIWATERCOLOR_API_KEY": "<AIWATERCOLOR_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ai-watercolor-generator": {
            "type": "http",
            "url": "https://www.aiwatercolorgenerator.com/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ai-watercolor-generator": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@ai-watercolor-generator/mcp"
            ],
            "env": {
                "AIWATERCOLOR_API_KEY": "<AIWATERCOLOR_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http ai-watercolor-generator https://www.aiwatercolorgenerator.com/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e AIWATERCOLOR_API_KEY=<AIWATERCOLOR_API_KEY> ai-watercolor-generator npx -y @ai-watercolor-generator/mcp
```
Replace <…> with your own values

## When to use it
- create a watercolor illustration from a text prompt
- turn a local JPEG, PNG, or WebP into a watercolor
- check an asynchronous generation task
- retrieve a task result or failure detail

## Example prompts
- Create a watercolor scene of a red cottage beside a quiet lake with `generate_watercolor`.
- Upload `/absolute/path/to/source-image.png` with `upload_watercolor_input`, then turn it into a watercolor with `edit_watercolor`.
- Check the task with `get_watercolor_task` and tell me whether the output is ready.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107701
- [Agent Skills Search Server](https://affpapa.org/en/nevibecode/mcp/agent-skills-search-server.md) — MCP server · ★ 26673
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9298

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md