Pico8 Mcp

Name: Pico8 Mcp
Author: smartfrog

@smartfrog

About Pico8 Mcp

MCP server that lets LLM agents play real PICO-8 carts in deterministic lockstep: press buttons, step frames, inspect screenshots, read Lua globals, peek memory, reset/replay, and watch live in a browser.

#mcp #model-context-protocol #pico-8 #pico8 #llm #agent #game-automation #tas

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "pico8": {
      "command": "node",
      "args": [
        "/path/to/pico8-mcp/dist/index.js"
      ],
      "env": {
        "PICO8_BIN": "/path/to/pico8"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Pico8 Mcp?

Pico8 Mcp is an MCP server that enables LLM agents to play real PICO-8 cartridges in deterministic lockstep. It allows agents to press buttons, step frames, inspect screenshots, read Lua globals, peek memory, reset or replay, and watch the action live in a browser.

How to use Pico8 Mcp?

Run the server and connect an MCP-compatible LLM client. The server exposes tools that let the agent press buttons, advance frames, capture screenshots, read and write Lua globals, inspect raw memory, reset the cart, replay sequences, and serve a live browser view.

Key features of Pico8 Mcp

Deterministic lockstep with real PICO-8 carts
Press buttons and step individual frames
Inspect screenshots and read Lua globals
Peek and poke memory addresses
Reset and replay game sessions
Watch live gameplay in a browser

Use cases of Pico8 Mcp

LLM agent plays a PICO-8 game autonomously
Debugging game logic by inspecting state frame by frame
Automated testing of PICO-8 cartridges
Exploring PICO-8 internals and memory layout
Creating agentic workflows that interact with retro games

FAQ from Pico8 Mcp

What does Pico8 Mcp do?

It lets LLM agents play real PICO-8 cartridges in deterministic lockstep, providing low-level control over the game state.

What capabilities does Pico8 Mcp provide?

It supports pressing buttons, stepping frames, inspecting screenshots, reading Lua globals, peeking memory, resetting/replaying, and streaming live video to a browser.