Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Pixelorama MCP draw a small yellow star sprite at 4,4, then export it as a PNG"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Lets AI agents like Claude Code draw pixel art in Pixelorama through MCP.
It has two parts: a Pixelorama extension that runs inside the editor, and an MCP server that the agent talks to. The agent works on whatever is open in Pixelorama, you watch it happen on the canvas, and every change can be undone with Ctrl+Z like any other edit.
Agents draw with a character grid and a palette, which is far easier for a language model than coordinates:
{
"palette": { "o": "#7a4a12", "y": "#f2c230", "h": "#fff2a8" },
"rows": [
"..oooo..",
".ohyyyo.",
"oyyyyyyo",
".oyyyyo.",
"..oooo.."
],
"x": 4,
"y": 4
}Characters missing from the palette (like .) leave pixels alone. read_pixels returns existing art in the same format, so an agent can read a sprite, change it and write it back.
Related MCP server: Aseprite MCP
Tool | What it does |
| Size, frames, layers and the current cel |
| New canvas in a new tab |
| Open a |
| Draw a character grid |
| Fill a rectangle, or the whole cel |
| Erase a cel |
| Read pixels back as a character grid |
| Image of a frame, scaled up so the agent can see it |
| Add a layer or frame and select it |
| Change the current frame/layer |
| Save as |
| Export a frame, or all frames as a sprite sheet |
Frames are counted from 0, left to right. Layers are counted from 0 at the bottom.
Requires Pixelorama 1.2 (extension API 9) and Node.js 22 or newer.
git clone https://github.com/CyberIce2077/pixelorama-mcp.git ~/projects/pixelorama-mcp
cd ~/projects/pixelorama-mcp
npm install
npm run install-extensionnpm install builds the server and packs the extension into dist/PixeloramaMCP.zip. install-extension copies it into Pixelorama's extensions folder. You can also install the zip from Pixelorama's Preferences > Extensions.
Restart Pixelorama, enable Pixelorama MCP in Preferences > Extensions, then add the server to Claude Code:
claude mcp add pixelorama -- node ~/projects/pixelorama-mcp/dist/index.jsagent <--stdio--> pixelorama-mcp server <--TCP 127.0.0.1:7651--> Pixelorama extensionThe extension listens on localhost only and speaks one JSON object per line. Any connection that sends something else, such as a web page trying to reach the port over HTTP, is dropped before a command runs.
The port is 7651. To change it, set PIXELORAMA_MCP_PORT for the server and PORT in extension/src/Extensions/PixeloramaMCP/Main.gd.
Only pixel layers can be drawn on. Group, tilemap, 3D and audio layers are reported but not editable.
Commands act on the project in the active tab.
No brushes, selections or tools yet; drawing is pixels and rectangles.
MIT
This server cannot be deployed
Generate pixel art sprites, animations, 8-direction rotations and palettes for games.
Free pixel and tileset editor, no account: hand-edit sprites, animations and Wang tilesets in chat
Generate, edit, style-match, turn, and animate game-ready pixel art at exact sizes.
Build a game's 2D art layer with your agent: characters, animations, tilesets, levels, 5 engines.