AI Watercolor Generator

com.aiwatercolorgeneratorPublished by aiwatercolorgenerator.comOfficial publisherv1.1.0Updated Oct 24, 2026

Create watercolor art from text or transform existing images into watercolor paintings with AI.

VerifiedStreamable HTTPWeb executableMedia & DesignAI & ML

Overview

AI-generated overview

AI Watercolor Generator lets an assistant create watercolor artwork from text prompts or turn uploaded images into watercolor paintings, then poll the task…

What you can do
  • Generate watercolor images from a text prompt, with model, aspect ratio and resolution options
  • Upload a local JPEG, PNG or WebP file (up to 10 MiB) to the hosted service
  • Edit or restyle uploaded images into watercolor paintings using their URLs
  • Check asynchronous task status, outputs and failure details until a result is ready
When to use it
Useful when you want an assistant to produce watercolor-style artwork from descriptions or to convert existing images into watercolor paintings without leaving the chat client. Choose the local package if your client only supports stdio or you need to upload a local file path.
Requirements
Node.js 20 or newer for the local npm package, or the hosted Streamable HTTP endpoint for clients that support it. An AI Watercolor Generator API key, supplied as the AIWATERCOLOR_API_KEY environment variable locally or as an Authorization bearer header remotely, plus account credits.
Before you install
The API key is a secret; keep it private and out of repositories. Tool calls consume account credits, and model, resolution and operation affect cost. Uploaded local images are sent to the provider's hosted storage and processed by its API. Review file paths and tool calls before approving them.

Installation

In SourceWeft

  1. Open AI Watercolor Generator in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.aiwatercolorgenerator%2Fwatercolor/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ai-watercolor-generator": {
      "type": "http",
      "url": "https://www.aiwatercolorgenerator.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

AI Watercolor Generator MCP

[npm version] [CI] [MCP Registry] [License: MIT]

Create watercolor art from text or transform local images with AI from any MCP client that supports local stdio servers.

This package is the official local MCP server for AI Watercolor Generator. It is a small, open-source client for the production API: generation, storage, credits, rate limits, and task processing remain on the hosted service.

Features

  • Generate watercolor artwork from a text prompt.
  • Upload a local JPEG, PNG, or WebP image for editing.
  • Transform uploaded images into watercolor paintings.
  • Poll asynchronous tasks until an output is ready.
  • Use the same account and credits as the REST API and hosted MCP server.

Requirements

Keep your API key private. Do not commit it to a repository or paste it into an issue.

Quick start

Run the MCP server through npm without a global installation:

bash
AIWATERCOLOR_API_KEY=YOUR_AIWATERCOLOR_API_KEY \  npx -y @ai-watercolor-generator/mcp

The process communicates over stdio, so it is normally launched by an MCP client rather than used interactively.

Client configuration

Codex

Codex CLI, the Codex IDE extension, and the ChatGPT desktop app share MCP configuration on the same Codex host. Add this to ~/.codex/config.toml and provide AIWATERCOLOR_API_KEY in the environment that starts Codex:

toml
[mcp_servers.ai_watercolor_generator]command = "npx"args = ["-y", "@ai-watercolor-generator/mcp"]env_vars = ["AIWATERCOLOR_API_KEY"]

Restart the client, then run codex mcp list or use /mcp to verify the connection. See the official Codex MCP documentation.

Cursor

Add this server to your project .cursor/mcp.json or global MCP configuration:

json
{  "mcpServers": {    "ai-watercolor-generator": {      "command": "npx",      "args": ["-y", "@ai-watercolor-generator/mcp"],      "env": {        "AIWATERCOLOR_API_KEY": "YOUR_AIWATERCOLOR_API_KEY"      }    }  }}

See the Cursor MCP documentation.

Claude Desktop and other JSON-based clients

Use the same stdio configuration in the client's local MCP settings:

json
{  "mcpServers": {    "ai-watercolor-generator": {      "command": "npx",      "args": ["-y", "@ai-watercolor-generator/mcp"],      "env": {        "AIWATERCOLOR_API_KEY": "YOUR_AIWATERCOLOR_API_KEY"      }    }  }}

Restart the client after saving. Claude Desktop may present local MCP servers through its Extensions interface; see Anthropic's local MCP server guide for the current setup flow.

Tools

ToolPurpose
generate_watercolorSubmit an asynchronous text-to-watercolor task
upload_watercolor_inputUpload a local JPEG, PNG, or WebP file up to 10 MiB
edit_watercolorSubmit an asynchronous watercolor edit using uploaded image URLs
get_watercolor_taskRead task status, outputs, or failure details

Generate from text

Call generate_watercolor with a prompt. Optional fields are model, aspect_ratio, resolution, and idempotency_key.

json
{  "prompt": "A red cottage beside a quiet lake, soft wet-on-wet washes",  "model": "watercolor-lite",  "aspect_ratio": "4:3",  "resolution": "1k"}

The tool returns a task with status queued or processing. Call get_watercolor_task every 2–5 seconds until the status is succeeded, failed, or canceled.

Edit a local image

First call upload_watercolor_input with an explicit local file path:

json
{  "file_path": "/absolute/path/to/source-image.png"}

Then pass the returned url to edit_watercolor:

json
{  "prompt": "Preserve the composition with soft transparent watercolor washes",  "input_images": [    "https://cdn.aiwatercolorgenerator.com/api-inputs/.../upload.png"  ],  "model": "watercolor-lite",  "aspect_ratio": "auto",  "resolution": "1k"}

The upload tool reads only the path explicitly supplied in the tool call. It does not scan directories or expand glob patterns. The image is uploaded to AI Watercolor Generator's trusted storage and is then processed by the hosted API.

Models and credits

The API currently supports watercolor-lite, nano-banana-2, nano-banana-pro, and gpt-image-2. Model, resolution, and operation affect credit cost. Failed or canceled tasks receive the refund defined by the hosted API.

See the API documentation for current models, credit costs, limits, error codes, and schemas.

How it relates to the hosted MCP server

The official MCP Registry entry is com.aiwatercolorgenerator/watercolor and supports two installation styles:

  • Hosted Streamable HTTP: https://www.aiwatercolorgenerator.com/api/mcp
  • Local stdio: this npm package

Use the hosted endpoint when your client supports authenticated Streamable HTTP. Use this local package when you need stdio compatibility or want an MCP tool to upload a local image path.

Security and privacy

  • The API key is read from AIWATERCOLOR_API_KEY and is never intentionally logged.
  • Local images are sent to the hosted upload API when you invoke upload_watercolor_input.
  • Tool calls consume account credits and are subject to API rate and concurrency limits.
  • Review file paths and tool calls before approving them in your MCP client.
  • Report vulnerabilities according to SECURITY.md.

Development

bash
pnpm installpnpm format:checkpnpm typecheckpnpm testpnpm pack --dry-run

The test suite mocks HTTP requests and includes a real subprocess handshake against the built stdio executable. No production API key is needed for normal development tests.

Links

License

MIT

Source: README.md at commit 1387148

Tools

3

generate_watercolor

Submit an asynchronous watercolor image generation task.

Parametersmodelpromptrequiredresolutionaspect_ratioidempotency_key

edit_watercolor

Submit an asynchronous watercolor edit using trusted uploaded image URLs.

Parametersmodelpromptrequiredresolutionaspect_ratioinput_imagesrequiredidempotency_key

get_watercolor_task

Get the current status and output of a watercolor image task.

Parameterstask_idrequired

Version history

2
  1. v1.1.0LatestSep 17, 2026
  2. v1.0.1Sep 17, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts