Pyxel MCP server

This is a helper that connects your AI to Pyxel, a small engine for making retro-style games in Python. Once it is set up, your AI can actually run a game file, press buttons, and look at what happened on screen. It is handy if you are building or testing a Pyxel game and want your AI to check it for you.

What this MCP server does

You point your AI at a Pyxel game file on your computer. The AI asks this helper to run that file quietly in the background, without opening a window. You can tell it which buttons to press and at which moment, and when to stop, for example when the score goes up. The helper then hands back facts like a screenshot, the values of game variables, the log, or the sounds. Your AI reads those facts and tells you what it found.

Click to zoom

What you can do with it

• Run a Pyxel game file without opening a window
• Schedule button presses and mouse moves at specific moments
• Stop the run when a game value reaches a condition you set
• Capture a screenshot of the game screen
• Read the colors, sprites, and tilemap used by the game
• Render a sound or music track to a WAV file
• Compare two screenshots to see what pixels changed

Try asking your AI

• “Run my game.py for 600 frames, hold the right arrow, and take a screenshot at the end”
• “Play my game and stop as soon as the score is 1 or more, then show me the player position”
• “Check my game file for syntax errors before I run it”
• “Read the tilemap in my game and tell me which tiles are used most”

What it gives back to you

You get back plain facts in the chat: a screenshot image, the values of game variables you asked for, the log text, and the number of frames that ran. It also tells you whether your stop condition was met. If you asked for a sound, you get a WAV file path. Your AI then explains what those facts mean.

Before you start

Who it's for

People making or testing small retro games with Pyxel who want their AI to run and check the game for them.