Run the project's mise build task, launch or find Playdate Simulator, inject the control agent, and load the PDX. This is the normal first call and reload workflow.

Find the selected Simulator, ensure its control agent is available, and return agent status. This may inject the agent when it is absent.

Load an existing PDX directory bundle without running a build task.

Press and release a button for a bounded duration. Lock toggles immediately and does not accept duration_ms.

Hold or release one button for deterministic and simultaneous input sequences.

Set the crank position in degrees or set whether the crank is docked.

Set the Simulator accelerometer x, y, and z values.

Set volume to percent, or adjust it up or down by percent. Adjustment defaults to 10 percent when percent is omitted.

Pause or resume the running game.

Restart the currently loaded game, resetting its runtime state.

Toggle the Simulator's Playdate lock state.

Capture the 400 by 240 framebuffer to a new PNG path and return it as MCP image content. Existing files are never overwritten.

Start recording to a new GIF path or stop and finalize the active recording. Recording state belongs to the Simulator agent, not this MCP server.

Invoke an exact Simulator toolbar action. The gif action may open a Save Recording dialog; use playdate_record for non-interactive GIF capture.

Diagnostic primitive that finds the selected Simulator and ensures its control agent is available. Normal control tools inject automatically.