Pico8 Mcp MCP Server

MCP server that lets an LLM play PICO-8 carts interactively: press buttons, advance frames deterministically, look at pixel-perfect screenshots, and read game variables — against the real PICO-8…

Local serverMIT

What is the Pico8 Mcp Server?

Pico8 Mcp is an MCP project maintained in the smartfrog/pico8-mcp repository. The maintainer describes its purpose as “MCP server that lets an LLM play PICO-8 carts interactively: press buttons, advance frames deterministically, look at pixel-perfect screenshots, and read game variables — against…”. Read the project documentation for the complete scope.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
pico8_boot	Start a cart under lockstep control (game time frozen until you step). Optional seed for deterministic rnd().
pico8_step	Hold buttons (left/right/up/down/o/x), advance N frames, get a screenshot.
pico8_play	Scripted sequence of {buttons, frames} steps in one call.
pico8_screen	Pixel-perfect PNG of the current frame (scale 1–4).
pico8_read	Read Lua globals by dotted path (player.x, objects.1.type…).
pico8_peek	Hex dump of PICO-8 RAM (0x6000 framebuffer, 0x2000 map…).
pico8_reset	Kill + restart from the original file (picks up cart edits).
pico8_boot_check	Run the unmodified cart with pico8 -x for N seconds and report boot errors (benchmark-style check).