
Pyxel MCP
This connects Claude to Pyxel, the retro game engine for Python, letting the AI write games and verify they actually work through visual feedback. You get tools to run scripts and capture screenshots at specific frames, record gameplay as GIFs, simulate player input, and inspect sprites, tilemaps, and color palettes pixel by pixel. It also exposes Pyxel's API docs and example games as MCP resources so Claude can reference them directly. Reach for this when you want an AI coding assistant that can iterate on game code by seeing what it renders, not just hoping the syntax is right.
- GitHub stars
- 32
- tools
- 8
- transport
- STDIO
- last updated
- Nov 12, 2026
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
validateSyntax errors and recognizable Pyxel code patterns, without executing.
Syntax errors and recognizable Pyxel code patterns, without executing.
No parameter schema in public metadata yet.
runHeadless frames, scheduled input, logs, and state, screen_image, screen_grid, or video snapshots.
Headless frames, scheduled input, logs, and state, screen_image, screen_grid, or video snapshots.
No parameter schema in public metadata yet.
pyxel_infoInstalled versions, paths, bundled examples, and resource URIs.
Installed versions, paths, bundled examples, and resource URIs.
No parameter schema in public metadata yet.
read_palettePalette colors and image-bank indices in use.
Palette colors and image-bank indices in use.
No parameter schema in public metadata yet.
read_imageImage-bank pixels and an optional PNG render.
Image-bank pixels and an optional PNG render.
No parameter schema in public metadata yet.
read_tilemapTile coordinates, source bank, usage counts, bounds, and an optional render.
Tile coordinates, source bank, usage counts, bounds, and an optional render.
No parameter schema in public metadata yet.
read_audioA rendered sound or music WAV plus measurable audio data.
A rendered sound or music WAV plus measurable audio data.
No parameter schema in public metadata yet.
diff_framesPixel differences between two PNG files.
Pixel differences between two PNG files.
No parameter schema in public metadata yet.
Sponsors
Readme
pyxel-mcp
Let AI agents play, watch, and measure Pyxel games. pyxel-mcp is an MCP server that runs a Pyxel script headlessly, feeds it scheduled input, stops when a condition holds, and hands back the facts: screenshots, pixel grids, game state, assets, audio, and frame diffs.
Details
- Repository
- github.com/kitao/pyxel-mcp
- Website
- github.com/kitao/pyxel-mcp
- Category
- Design & Creative
- Package
pyxel-mcp- Transport
- STDIO
- Registry
- MCP registry, active