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. Its 8 documented tools cluster into read & search, validate, run & execute, pyxel.

People who work with game engine, pixel art and pyxel and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-13 · ★ 26 · #8 OF 43 MAINTAINED GAMING · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Pyxel MCP

Claude Code

claude mcp add kitao-pyxel-mcp -- uvx pyxel-mcp

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package pyxel-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.kitao is GitHub-verified and matches the repo owner

03 · What Pyxel MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 8 documented tools across read & search, validate, run & execute, including validate, run, pyxel_info, read_palette.

Capability map

Tools grouped from the project's README - what Pyxel MCP lets an agent do.

read & search

4 tools - e.g. Palette colors and image-bank indices in use.; Image-bank pixels and an optional PNG render.; Tile coordinates, source bank, usage counts, bounds, and an optional render.

read_palette · read_image · read_tilemap · read_audio

Validate

1 tool - e.g. Syntax errors and recognizable Pyxel code patterns, without executing.

validate

run & execute

1 tool - e.g. Headless frames, scheduled input, logs, and state, screen_image, screen_grid, or video snapshots.

run

Pyxel

1 tool - e.g. Installed versions, paths, bundled examples, and resource URIs.

pyxel_info

Diff

1 tool - e.g. Pixel differences between two PNG files.

diff_frames

Latest releases

v1.3.0 · 2026-09-13

Resolve relative asset paths from the script directory in script tools · Migrate to MCP Python SDK 2.x (MCPServer) and require mcp>=2.0.0,<3.0.0 · Add inline to screen_image, read_image, and read_tilemap for image…

04 · Who maintains Pyxel MCP

Pyxel MCP is maintained by kitao. It's the only MCP server we track from this author; the repo dates to Mar 2026.

05 · Facts

repository: github.com/kitao/pyxel-mcp
website: https://github.com/kitao/pyxel-mcp
category: gaming - ranked #8 of 43 actively-maintained gaming servers as of 2026-09-18.
release cadence: 1 release in the last 90 days (latest 2026-09-13)
registry: io.github.kitao/pyxel-mcp (active, first published 2026-03-01 · 33 versions)
packages: pypi:pyxel-mcp

06 · Pyxel MCP FAQ

Is Pyxel MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-13 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Pyxel MCP do?

An agent gets 8 documented tools across read & search, validate, run & execute, including validate, run, pyxel_info, read_palette.

How do I install Pyxel MCP?

Run `uvx pyxel-mcp`. You can also paste the ready-made client config above.

Does Pyxel MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Pyxel MCP

Alternatives to Pyxel MCP

Maintained gaming servers if Pyxel MCP isn't the fit.

More gaming MCP servers · KitWright Unity MCP · Hera Agent Unity · Aseprite Live · Fabricator Panel MCP · Mythx Engine

More Python MCP servers · Kitchen Sink4 Word · Zoo MCP · Gmc MCP · Silica Core · Strata · see all