Pyxel MCP

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

People connecting gaming tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-07-15 · ★ 25 · #20 OF 35 MAINTAINED GAMING · VERIFIED 2026-08-25

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.

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, examples, and resource URIs.

pyxel_info

Diff

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

diff_frames

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 #20 of 35 actively-maintained gaming servers as of 2026-08-25.
registry: io.github.kitao/pyxel-mcp (active, first published 2026-03-01 · 32 versions)
packages: pypi:pyxel-mcp

06 · Pyxel MCP FAQ

Is Pyxel MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-15. 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 · Hera Agent Unity · Aseprite Live · Mythx Engine · Godot Lens · Steam (read-only)

More Python MCP servers · Zoo MCP · Gmc MCP · Strata · Legal Text MCP De · Talkthrough MCP · see all