Loading connector details…
Loading connector details…
Choose a unique username to continue using AgentHotspot
by kitao • Uncategorized
An MCP server enabling AI to autonomously run, verify, and analyze Pyxel retro game programs.
Run and capture screenshots from Pyxel game scripts automatically.
Inspect and debug game states, sprites, palettes, and layouts in Pyxel games.
Analyze audio and visual elements of Pyxel retro games for verification and iteration.
pyxel-mcp is an MCP server designed for the Pyxel retro game engine, allowing AI agents to run Pyxel scripts, capture screenshots, simulate inputs, inspect game states, analyze visuals and audio, and validate scripts. It facilitates automated testing, debugging, and iteration of retro game programs, enhancing development efficiency and accuracy. The server integrates easily with AI agents like Claude Code via the MCP Registry.
Run a Pyxel script and capture a screenshot after N frames. Args: script_path: Absolute path to the .py script to run. frames: Number of frames to render before capturing (default: 60). scale: Screenshot scale multiplier (default: 1). timeout: Maximum seconds to wait for the script (default: 10).
Get Pyxel installation info: package location, examples path, and API stubs path.
Render a Pyxel sound or music to WAV and return waveform analysis. Runs the script to set up sounds (without starting the game loop), then renders the specified sound or music to WAV and analyzes the audio. Returns note sequence with timing, frequency, and volume data. Args: script_path: Absolute path to the .py script to run. sound_index: Sound slot index (default: 0). Default range 0-63, but lists can be extended via append(). Ignored when music_index is set. duration_sec: Duration in seconds. 0 = auto-detect from sound length (10s for music). timeout: Maximum seconds to wait for the script (default: 10). music_index: Music slot index. Default range 0-7, extendable. When set (>=0), renders the full multi-channel music mix instead of a single sound.
Inspect sprite pixel data from a Pyxel image bank. Reads pixel data, checks horizontal/vertical symmetry, and reports color usage. Use this to verify sprite quality and find asymmetries. Args: script_path: Absolute path to the .py script to run. image: Image bank index (default: 0). Default range 0-2, extendable. x: X position in the image bank (default: 0). y: Y position in the image bank (default: 0). w: Width of the region to inspect (default: 8). h: Height of the region to inspect (default: 8). timeout: Maximum seconds to wait for the script (default: 10).
Check animation frame consistency in a sprite sheet. Reads multiple adjacent horizontal frames and compares palette, silhouette size, and pixel differences between frames. Args: script_path: Absolute path to the .py script to run. image: Image bank index (default: 0). x: X position of the first frame (default: 0). y: Y position (default: 0). w: Width of each frame (default: 8). h: Height of each frame (default: 8). frame_count: Number of animation frames to check (default: 2). timeout: Maximum seconds to wait (default: 10).
Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.