Doodleworks MCP Server

Hand-drawn explainer illustrations in your AI host, via an MCP App with an interactive viewer.

Local serverstdio

What is the Doodleworks MCP MCP server?

Hand-drawn explainer illustrations in your AI host, via an MCP App with an interactive viewer. Exposed over MCP by the doodleworks mcp mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

Bring your own image-API key (OpenAI or Gemini) · local stdio server · flip through, regenerate, and download, all in your host's chat.

Its toolset

Everything the assistant can do here goes through one of these:

  • OPENAI_API_KEY — OpenAI GPT Image (the default provider)
  • Browse — ** step through with prev/next or the thumbnail strip; the optional 21:9 hero leads, the 16:9 tips follow
  • Zoom — ** click any illustration to enlarge it
  • Regenerate — ** image models are non-deterministic, so one click re-rolls a single illustration in place (no need to redo the whole set)
  • Download — ** save one PNG or the whole set; tick Title on PNG to burn the title into a clean caption band below the artwork
  • Host — Runs the tools
  • Windsurf — ✅
  • illustrations(required)
  • title — none
  • resolution — 1k
  • quality — DOODLEWORKS_QUALITY env, else low
  • styleReference — DOODLEWORKS_STYLE_REF env, else none

Configuration

You will need 3 environment variables: OPENAI_API_KEY, GEMINI_API_KEY, GOOGLE_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at doodleworks-mcp on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

When to reach for it

Among the AI and media services options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Doodleworks MCP's toolset — OPENAI_API_KEY, Browse, Zoom and 11 more — is a fair guide to whether it matches your workflow. It is maintained by SalZaki; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Doodleworks MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Doodleworks MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the doodleworks mcp mcp server does with a few real requests.

Available tools

ToolWhat it does
OPENAI_API_KEYOpenAI GPT Image *(the default provider)*
Browse** step through with prev/next or the thumbnail strip; the optional 21:9 hero leads, the 16:9 tips follow.
Zoom** click any illustration to enlarge it.
Regenerate** image models are non-deterministic, so one click re-rolls a single illustration in place (no need to redo the whole set).
Download** save one PNG or the whole set; tick **Title on PNG** to burn the title into a clean caption band below the artwork.
HostRuns the tools
Windsurf
illustrations*(required)*
titlenone
resolution1k
qualityDOODLEWORKS_QUALITY env, else low
styleReferenceDOODLEWORKS_STYLE_REF env, else none
prompt*(required)*
aspect16:9

How to install the Doodleworks MCP MCP server

{
  "mcpServers": {
    "doodleworks-mcp": {
      "command": "npx",
      "args": ["-y", "doodleworks-mcp"],
      "env": { "OPENAI_API_KEY": "sk-..." }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
OPENAI_API_KEYCredential the server authenticates with.Yes
GEMINI_API_KEYCredential the server authenticates with.Yes
GOOGLE_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Doodleworks MCP to OPENAI API KEY.
  • Use Doodleworks MCP to Browse.
  • Use Doodleworks MCP to Zoom.

Frequently asked questions

It connects Doodleworks MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (OPENAI_API_KEY, Browse, Zoom, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Doodleworks MCP directly.