Start Eden and open a base game file. Optionally install/apply a separate update before booting when the Eden control endpoint is available.

Continue waiting for a previously started Eden process to expose control or produce its first frame. Use this after a retryable eden_start_game timeout; no second process is started and a separate update load request is never duplicated.

Perform a bounded read-only preflight for base/update paths, sampled fingerprints, normalized title-ID compatibility, version hints, and optional LayeredFS patch layout.

Stop the Eden process started by this MCP server.

Create an idle Eden session with a cloned portable profile and independent executable. Pass the returned session_id to all normal control tools.

List the default and managed Eden sessions with state, PID, and profile path.

Check standalone executable, profile, keys/NAND hints, allowed paths, session storage, and optionally launch a short authenticated endpoint probe.

Stop and forget one managed Eden session. Its isolated files are retained unless remove_profile is true.

Inventory managed-session disk usage and classify active, reclaimable, protected, unconfirmed, and legacy directories. This tool never deletes files.

Apply retention only to valid, stopped, unprotected Eden MCP session profiles. Defaults to dry-run and never removes active, protected, unconfirmed, or legacy paths.

Atomically copy an unpacked RomFS/ExeFS/cheat patch into a stopped managed session's isolated user/load directory. The default profile cannot be targeted; links and key, firmware, NAND, or save-like roots are rejected.

Get the managed Eden process, backend, screen, game paths, and capabilities.

Return emulator-mcp-capabilities contract 1.0 for the selected session, including available, conditional, and unavailable launch/input/capture/diagnostic operations.

Get the current Eden render coordinate space in pixels. Use these dimensions for touch coordinates when no screenshot has just been taken.

Send a host keyboard key to Eden. The key is resolved through Eden's active input profile. Supported names include A-Z, 0-9, F1-F24, arrows, Enter, Escape, Space, Tab, Backspace, Delete, Home, End, PageUp/PageDown, Shift, Ctrl, Alt, and Meta.

Send a Nintendo Switch button directly to a player through Eden's virtual gamepad. Supported buttons are A/B/X/Y, L/R/ZL/ZR, Plus/Minus, D-pad directions, LStick/RStick, SL/SR, Home, and Capture. Requires the Eden control endpoint.

Run a validated sequence of waits, key/button actions, Switch button chords, touches, and visual-change checkpoints. Held inputs are released after failures and by default at normal completion. Analog steps are rejected until the control protocol supports them.

Touch Eden at screenshot pixel coordinates. Supports tap, long_press, swipe, down, move, and up. For swipe, provide end_x and end_y. source_width/source_height should match the screenshot used to choose coordinates; if omitted, the current render size is used.

Capture the current Eden render surface and return it as a PNG image. Optionally save a copy to an absolute or relative .png path. Use the returned image's pixel dimensions for subsequent touch coordinates. Do not cache screenshots.

Capture 2-12 native frames over time and report perceptual differences, sampled frame hashes, and frozen/periodic/moving classification for visual loop evidence.

Read the tail of Eden's eden_log.txt. Optionally return only lines containing a case-insensitive substring. This also works after Eden exits.

Collect a bounded, shareable gameplay failure report with process context, detailed logs, repeated-message analysis, surrounding event context, and heuristic hints for game load, patch loop, video loop, or missing patch/localization output. Partial results are returned when status or log flushing fails.

Export a bounded, path-redacted ZIP containing a diagnostic report, structured log entries, manifest hashes, and an optional screenshot. Keys, firmware, game content, patches, saves, configuration, environment variables, and tokens are excluded.

Sample control status and summarize bounded FPS, frame-time, shader, and video signals from current runtime evidence. Unavailable counters are returned as null.

Return ranked, reversible compatibility experiments from current diagnostics and metrics. This tool never changes emulator settings.

List only diagnostic artifacts generated by Eden MCP and their bounded sizes.

Apply retention only to Eden MCP diagnostic bundle names. Defaults to dry-run; game, profile, patch, save, key, firmware, and arbitrary user files are outside scope.