Pyxel MCP Server

MCP server for Pyxel, a retro game engine for Python

Local serverstdioPython

What is the Pyxel MCP Server?

MCP server for Pyxel, a retro game engine for Python

What the server does

An MCP server for observing programs built with Pyxel. It runs trusted local scripts headlessly and returns structured state, pixels, assets, audio, and frame differences.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
validateSyntax errors and recognizable Pyxel code patterns.
runHeadless frames, scheduled input, logs, and state, screen_image, screen_grid, or video snapshots.
pyxel_infoInstalled versions, paths, examples, and resource URIs.
read_palettePalette colors and image-bank indices in use.
read_imageImage-bank pixels and an optional PNG render.
read_tilemapTile coordinates, source bank, usage counts, bounds, and an optional render.
read_audioA rendered sound or music WAV plus measurable audio data.
diff_framesPixel differences between two PNG files.

How to install the Pyxel MCP Server

{
  "mcpServers": {
    "pyxel": {
      "command": "uvx",
      "args": ["pyxel-mcp"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • “Use Pyxel MCP to validate.”
  • “Use Pyxel MCP to run.”
  • “Use Pyxel MCP to pyxel info.”

Frequently asked questions

MCP server for Pyxel, a retro game engine for Python Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.