For developers

Free Pixel Art MCP Server for Claude, Cursor and VS Code

simplepixelart-mcp gives your AI assistant real pixel art tools: turn any image into pixel art, extract a palette, recolor sprites to PICO-8 or Game Boy colors, and upscale without blur. It is free and open source, runs locally through npx, and needs no API key or account.

View on GitHubnpm package

Install

Claude Desktop, Cursor, Windsurf, VS Code

Add this to your client’s MCP config (claude_desktop_config.json, .cursor/mcp.json and so on):

{
  "mcpServers": {
    "pixel-art": {
      "command": "npx",
      "args": ["-y", "simplepixelart-mcp"]
    }
  }
}

Claude Code

claude mcp add pixel-art -- npx -y simplepixelart-mcp

Hosted, nothing to install

A remote endpoint runs at https://mcp.simplepixelart.com/mcp (Streamable HTTP, no auth):

{
  "mcpServers": {
    "pixel-art": { "url": "https://mcp.simplepixelart.com/mcp" }
  }
}

Requires Node.js 18 or newer for the local server.

Tools

pixelate_image

Turns an image into pixel art: shrinks it to a pixel grid (say 64 px wide), reduces it to N colors with median cut or maps it to a named palette, and saves a PNG, optionally upscaled for preview.

extract_palette

Pulls the main colors out of an image and returns the hex codes plus a GIMP / Aseprite .gpl palette file.

remap_palette

Recolors existing pixel art so every pixel uses a palette color — PICO-8, Sweetie 16, ENDESGA 32, Game Boy, 1-bit or your own hex list.

upscale_pixel_art

Upscales by a whole number with nearest-neighbor sampling, so pixels stay sharp.

list_palettes

Lists the built-in palettes.

Example prompts

  • “Turn ~/photos/cat.jpg into 48 px wide pixel art with the PICO-8 palette, and save an 8× preview.”
  • “Extract a 6-color palette from this screenshot and give me the .gpl file.”
  • “Recolor every sprite in assets/ to the Game Boy palette.”
  • “Upscale hero.png 10× for the store page.”

Finish it by hand

The tools give you a clean starting grid; the rest is pixel work. Open the PNG in the free pixel art editor, or use the in-browser image to pixel art converter when you want to tune size, colors and dithering with a live preview.

Frequently asked questions

Is the pixel art MCP server free?
Yes. It is free and open source under the MIT license. It runs on your own machine through npx, with no account and no API key.
Which clients does it work with?
Any MCP client: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code and others. Most take the same JSON config with the npx command.
What do I need installed?
Node.js 18 or newer. The package has no native dependencies, so npx -y simplepixelart-mcp is all it takes.
Is there a hosted version?
Yes: https://mcp.simplepixelart.com/mcp (Streamable HTTP, no auth). Images go in as a public URL or base64 and come back as PNG, with limits of 4 MB / 2048×2048 input, 1024 px output and 20 requests a minute.
Does it upload my images anywhere?
Not when you run it locally with npx: images are read and written on your machine. Only the hosted endpoint receives the images you send it.
What image formats does it read?
PNG and JPEG files, or image URLs.
Can I edit the result by hand?
Yes. Open the PNG in the free online pixel art editor on SimplePixelArt to fix details, add layers or animate it.

More for game developers