Pyxel Mcp

Name: Pyxel Mcp
Author: kitao

by kitaocommunityv0.9.2

The pyxel-mcp server enables AI to autonomously run, verify, and iterate on retro game programs using the Pyxel game engine for Python.

From the registry: MCP server for Pyxel, a retro game engine for Python

GitHub Repository Website

Install & configure

Prerequisites

required
Install pyxel-mcp
Install from PyPI
```
$ pip install pyxel-mcp
```
required
Pyxel retro game engine
Pyxel is automatically installed as a dependency

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `pyxel-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install pyxel-mcp** — Install from PyPI Run: `pip install pyxel-mcp`
- **Pyxel retro game engine** — Pyxel is automatically installed as a dependency

Canonical MCP server config (stdio transport):
- command: `pyxel-mcp`
- args: []

Note: MCP server for Pyxel retro game engine. 14 tools for running, capturing, and analyzing Pyxel games. No API keys required.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: MCP server for Pyxel retro game engine. 14 tools for running, capturing, and analyzing Pyxel games. No API keys required.

Tools (15)

run_and_capture

Run a Pyxel script and capture a screenshot after N frames.

capture_frames

Capture screenshots at multiple frame points for animation verification.

play_and_capture

Play a game by sending simulated input and capture screenshots.

validate_script

Validate a Pyxel script without running it.

inspect_state

Read game object attributes at specific frames for debugging.

inspect_screen

Capture screen as a compact color index grid.

compare_frames

Compare screenshots at two frames and report pixel differences.

inspect_sprite

Inspect sprite pixel data from a Pyxel image bank.

inspect_layout

Analyze screen layout, text alignment, and visual balance.

inspect_palette

Analyze color usage and contrast in a Pyxel screenshot.

inspect_bank

Visualize an entire Pyxel image bank as a single screenshot.

inspect_tilemap

Inspect tilemap content, tile usage, and layout.

inspect_animation

Check sprite sheet consistency across animation frames.

Packages

pyxel-mcp

pypiv0.9.2transport: stdio

Details

Language: Python
License: MIT
Released: Mar 30, 2026
Last commit: May 1, 2026
Registry name: io.github.kitao/pyxel-mcp

Related Servers

Labelhead Artist Momentum

Trending hip-hop artist momentum scores across four cultural dimensions.

65.5k

Tldraw

Draw and visually collaborate with your agents on tldraw's canvas.

47.0k

Mcp Server Chart

A Model Context Protocol server for generating charts using AntV.

4.1k