AI Watercolor Generator — Claude Code MCP server: install
This MCP server creates watercolor images from text and turns local JPEG, PNG, or WebP files into watercolor paintings.
claude mcp add watercolor -e AIWATERCOLOR_API_KEY=<AIWATERCOLOR_API_KEY> -- npx -y @ai-watercolor-generator/mcpWhat AI Watercolor Generator 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.
What it helps with
- 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 for the agent
- Create a watercolor scene of a red cottage beside a quiet lake with
generate_watercolor. - Upload
/absolute/path/to/source-image.pngwithupload_watercolor_input, then turn it into a watercolor withedit_watercolor. - Check the task with
get_watercolor_taskand tell me whether the output is ready.
How to install AI Watercolor Generator
1Platform CLI
claude mcp add watercolor -e AIWATERCOLOR_API_KEY=<AIWATERCOLOR_API_KEY> -- npx -y @ai-watercolor-generator/mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http ai-watercolor-generator https://www.aiwatercolorgenerator.com/api/mcp1Platform CLI: remote server
codex mcp add ai-watercolor-generator --url https://www.aiwatercolorgenerator.com/api/mcp2Platform CLI
codex mcp add ai-watercolor-generator --env AIWATERCOLOR_API_KEY=<AIWATERCOLOR_API_KEY> -- npx -y @ai-watercolor-generator/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"ai-watercolor-generator": {
"url": "https://www.aiwatercolorgenerator.com/api/mcp"
}
}
}{
"mcpServers": {
"ai-watercolor-generator": {
"command": "npx",
"args": [
"-y",
"@ai-watercolor-generator/mcp"
],
"env": {
"AIWATERCOLOR_API_KEY": "<AIWATERCOLOR_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"ai-watercolor-generator": {
"type": "http",
"url": "https://www.aiwatercolorgenerator.com/api/mcp"
}
}
}{
"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
1Platform CLI: remote server
gemini mcp add -t http ai-watercolor-generator https://www.aiwatercolorgenerator.com/api/mcp2Platform CLI
gemini mcp add -e AIWATERCOLOR_API_KEY=<AIWATERCOLOR_API_KEY> ai-watercolor-generator npx -y @ai-watercolor-generator/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AI Watercolor Generator
How do I install AI Watercolor Generator in Claude Code?
Add the local MCP server with the API key: claude mcp add watercolor -e AIWATERCOLOR_API_KEY=<AIWATERCOLOR_API_KEY> -- npx -y @ai-watercolor-generator/mcp.
What does AI Watercolor Generator do?
It creates watercolor images from text and edits local JPEG, PNG, or WebP files. An agent can start a task, upload an image, and check its processing status.
What does the MCP server require?
You need Node.js 20 or newer, an AIWATERCOLOR_API_KEY, and account credits. Generation and editing use credits and follow the API rate and concurrency limits.
