Skip to main content
Glama
pixelorama-mcp
by Aeroscoop

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PIXELORAMA_MCP_PORTNoThe port used by the Pixelorama MCP server. The default is 7651; to change it, set PIXELORAMA_MCP_PORT for the server and PORT in the Pixelorama extension.7651

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_projectA

Describe the project open in Pixelorama: size, frames, layers and the current cel.

new_projectB

Create a new, empty project in a new tab and switch to it.

open_fileA

Open a .pxo project or an image (png, jpg, webp, bmp, tga) in a new tab.

draw_pixelsA

Draw pixels from a character grid. Each string in rows is one row of pixels; each character is looked up in palette. Characters that are not in the palette (such as '.') leave the pixel unchanged, so map a character to "transparent" to erase. Example: palette {"o": "#e8a33d", "d": "#7a4a12"}, rows [".oo.", "oddo", ".oo."]. The whole call is one undo step in Pixelorama.

fill_rectB

Fill a rectangle with one color. Leave out the position and size to fill the whole canvas.

clear_celB

Erase every pixel of one cel (a layer in a frame).

read_pixelsB

Read pixels of one cel as a character grid with a palette, in the same format draw_pixels takes. '.' is transparent. At most 16384 pixels per call.

get_imageA

Show a frame with all visible layers blended, scaled up with nearest-neighbour so pixels stay sharp.

add_layerB

Add a pixel layer. By default it goes on top of all layers.

rename_layerC

Rename a layer. Layer 0 is the bottom layer.

get_paletteA

Show the palette selected in Pixelorama (slot number and color of every swatch, slot 0 first), the names of all palettes, and the color mode. In draw_pixels and fill_rect a color '@n' means slot n of this palette.

select_paletteA

Select a palette by name (global or project palette). In indexed mode the whole image recolors to it, slot by slot.

create_paletteB

Create a project palette from a list of colors (slot 0 first) and select it. Use the same slot order for a day and a night palette.

set_color_modeA

Switch the project between 'indexed' (every pixel is a palette slot) and 'rgba'. One undo step.

resize_canvasA

Change the canvas size without scaling. anchor is where the old image stays: bottom (default, centered horizontally), top, center, left, right, or combinations like bottom-left.

add_frameA

Add an empty frame. By default it goes after the last frame.

select_celC

Make a frame/layer the current one in Pixelorama.

save_projectA

Save the current project as a .pxo file. Without a path it saves to where it was last saved.

export_pngA

Export the current frame, or all frames as a horizontal sprite sheet, to a PNG file. Layers are blended the same way Pixelorama shows them.

undoA

Undo the last n steps in the active project, like Ctrl+Z. Returns the names of the steps undone.

redoA

Redo the last n undone steps in the active project, like Ctrl+Y. Returns the names of the steps redone.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.4/5.0

Scored across 21 tools

Disambiguation4/5

Most tools target clearly distinct operations: draw_pixels vs fill_rect vs clear_cel, and add_layer vs add_frame vs select_cel are easy to separate. The closest pair is get_image (blended visual preview) vs read_pixels (raw grid data) and get_project (metadata), but the descriptions make the distinction clear enough.

Naming Consistency4/5

Nearly all names follow a snake_case verb_noun or verb_target pattern (get_project, draw_pixels, rename_layer, resize_canvas, export_png), with only bare verbs undo/redo as a natural exception. Minor deviation: the create verb is inconsistent ('new_project' vs 'create_palette', 'add_layer', 'add_frame').

Tool Count4/5

21 tools is on the heavy side but each maps to a real pixel-art workflow: project lifecycle, drawing, layers, frames, palettes, and export. Nothing looks redundant, though a few could be consolidated (e.g. layer/frame manipulation helpers).

Completeness3/5

Core creation flows are covered (new/open project, draw, fill, layers, frames, palettes, save/export, undo/redo), but the lifecycle is asymmetric: you can add layers and frames yet there is no delete_layer, delete_frame, duplicate_frame, or layer reordering/visibility toggle. These are common operations that will force agents into workarounds.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues